对于来自客户机的连接，请使用下列格式来指定数据库 URL：
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 22 -
jdbc:gbasedbt-sqli://[{ip-address|host-name}:{port-number|server-name}][/dbname]:
GBASEDBTSERVER=servername[{;user=user;password=password]
|CSM=(SSO=database_server@realm,ENC=true)}
[;name=value[;name=value]...]
对于数据库服务器上的连接，请使用下列格式：
jdbc:gbasedbt-direct://[/dbname:;[user=user;password=password] ]
[;name=value[;name=value]...]
在前面的语法中：
与竖线（|）在一起的大括号（{ }）表示变量的多个选择。
斜体字表示变量值。
方括号（[ ]）表示可选的值。
括在方括号中的词或符号是必需的（例如，GBASEDBTSERVER=）。
在数据库 URL 中不允许空格。
例如，在客户机上，您可能使用：
jdbc:gbasedbt-sqli://123.45.67.89:1533/testDB:
GBASEDBTSERVER=myserver;user=rdtest;password=test
在服务器上，您可能使用：
jdbc:gbasedbt-direct://testDB;user=rdtest;password=test
重要： 使用服务器侧 JDBC 的连接有不同的语法。要了解详细信息，请参阅 J/Foundation 开发
者指南 或您的数据库服务器版本的发布说明。
下表描述数据库 URL 的变量部分，以及对等的 GBase 8s 连接属性。
GBase 8s 连
接属性
数据库 URL 变量
是否必需？
描述
IFXHOST
ip-address
host-name
对于客户机侧 JDBC，必需，
除非定义 SQLH_TYPE属性
或使用 IFXHOST 属性；
对于
服务器侧 JDBC，
不是必需的
正在运行 GBase
8s 数据库服务器的计
算机的 IP 地址或主机
名称。
PORTNO
port-number
对于客户机侧 JDBC，必需，
必须指
定 port-number 或 ser
ver-name，除非定义
GBase 8s 数据库服务
器的端口号
在 /etc/services
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 23 -
GBase 8s 连
接属性
数据库 URL 变量
是否必需？
描述
SQLH_TYPE 属性，或使用
PORTNO 属性；对于服务器
侧 JDBC，不是必需的
文件中罗列该端口号。
无
server-name
对于客户机侧 JDBC，必需，
必须指
定 port-number 或 ser
ver-name，除非定义
SQLH_TYPE 属性，或使用
PORTNO 属性；对于服务器
侧 JDBC，不是必需的
罗列
在 /etc/services
文件中的 GBase
8s 数据库服务器的
server-name。
DATABASE
dbname
不是必需的，除非是来自运
行在数据库服务器中的 web
应用程序的连接
您想要连接至其
的 GBase 8s 数据库
的名称
如果未指定数据库的名
称，则制作至 GBase
8s 数据库服务器的连
接。
GBASEDBTSERV
ER
server-name
必需
您想要连接至其
的 GBase 8s 数据库
服务器的名称
USER
user
必需。
必须指定用户和口令，
或 SSO 的 SCM 设置。 必
须指定用户和口令。
想要连接至 GBase
8s 数据库或数据库服
务器的用户名称。
必须同时指定用户和口
令，或都不指定。如果
都不指定，则驱动程序
调
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 24 -
GBase 8s 连
接属性
数据库 URL 变量
是否必需？
描述
用 System.getProper
ty() 来获取当前正在
运行应用程序的用户的
名称，以及假定信任的
客户机。
PASSWORD
password
必需。
必须指定用户和口令，
或 SSO 的 CSM 设置。 必
须指定用户和口令。
用户的口令
必须同时指定用户和口
令，或都不指定。如果
都不指定，则驱动程序
调
用 System.getProper
ty() 来取得当前正在
运行应用程序的用户的
名称，以及假定信任的
客户机。
无
database_server@
realm
必需，
必须指定用户和口令，
或 SSO 的 CSM 设置。
（SSO）
访问控制的服务
原则。要获取信息，请
参阅 随同 GBase 8s
JDBC 驱动程序来使用
单点登录访问控制。
无
name=value
不是必需的
为包含在 name 变量
中的 GBase 8s 环境
变量指定值的名-值对，
GBase 8s JDBC
Driver 或 GBase
8s 数据库服务器识别
它
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 25 -
GBase 8s 连
接属性
数据库 URL 变量
是否必需？
描述
name 变量不区分大小
写。
要获取更多信息，请参
阅 指定属性 和 随
同 GBase 8s JDBC 驱动
程序的 GBase 8s 环境
变量。
如果 LDAP 服务器或 sqlhosts 文件通过 SQLH_TYPE 属性来提供 IP 地址、主机名称或端
口号，则不必在数据库 URL 中指定它们。要获取更多信息，请参阅 动态地读取 GBase 8s
sqlhosts 文件。
连接 URL 中的 IP 地址
GBase 8s JDBC Driver Version 3.0 及后来的版本支持 JDK 1.4 是 IPv6 感知的。
也就是说，
解析连接 URL 的代码可处理更长的（128 位模式）IPv6 地址（以及 IPv4 格式）。此 IP
地址可为 IPv6 文字，例如：
3ffe:ffff:ffff:ffff:0:0:0:12
要以 GBase 8s 来连接至 IPv6 端口，请使用系统属性，例如：
java -Djava.net.preferIPv6Addresses=true ...
以 GBase 8s JDBC Driver Version 3.0 或后来版本处理不带有 IPv6 文字的 URL 是不变的，
且遗留行为是不变的。
冒号（:）是连接 URL 中的关键定界符，特别是在 IPv6 文字地址中。
必须为驱动程序创建格式良好的 URL，来识别 IPv6 文字地址。请注意，在下列示例中：
jdbc:gbasedbt-sqli:// 是需要的。
环绕 8088 的冒号（:8088:）是需要的。
驱动程序不验证 3ffe:ffff:ffff:ffff:0::12。
8088 必须是 < 32k 的有效数值。
jdbc:gbasedbt-sqli://3ffe:ffff:ffff:ffff:0::12:8088:gbasedbtserver=X...
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 26 -