更新日期：2024年09月11日
或者，
代理允许 JDBC applet 和实用程序从 LDAP 服务器获得它们的数据库连接信息。
如
果您打算使用此特性，则需要安装 LDAP 服务器。关于随同 GBase 8s JDBC Driver 使用
LDAP 服务器的通用信息，请参阅 连接属性语法 开始的主题。
下图说明代理如何与 LDAP 服务器系统工作。该图还展示如何从 sqlhosts 文件查找。要获
取更多信息，请参阅 指定 sqlhosts 文件查找。
图: 通过代理查找
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 54 -
代理 LDAP 特性需要 JNDI 类库和 LDAP 服务提供商文件（jndi.jar、
ldap.jar 和 providerutil.jar）。可从 www.oracale.com 下载这些 JAR 文件。
在下载并安装文件之后，在 web 服务器上将它们的完全路径名称添加至 CLASSPATH 设
置。这些文件在安装目录之下的 lib 目录中。
指定 LDAP 查找发生的位置
当随同其他 LDAP 关键字使用时，SQLH_LOC 关键字指示 LDAP 查找发生的位置。
SQLH_LOC 可有值 CLIENT 或 PROXY。如果该值为 CLIENT，则驱动程序在客户机侧执
行 LDAP 查找。如果该值为 PROXY，则代理在服务器侧执行查找。如果未指定值，则驱
动程序使用 CLIENT 作为缺省值。
这里是带有指定服务器侧 LDAP 查找的 LDAP 关键字的 applet 或应用程序 URL 的格
式：
jdbc:gbasedbt-sqli:gbasedbtserver=gbasedbt-server-name;
PROXY=proxy-hostname-or-ip-address:proxy-port-no?
PROXYTIMEOUT=60;SQLH_TYPE=LDAP;LDAP_URL=ldap:
//ldap-hostname-or-ip-address:ldap-port-no;LDAP_IFXBASE=dc=mydomain,dc=com;
SQLH_LOC=PROXY;
此示例从 LDAP 服务器获取数据库服务器主机名称和端口：
jdbc:gbasedbt-sqli:gbasedbtserver=samsara;SQLH_TYPE=LDAP;
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 55 -
LDAP_URL=ldap://davinci:329;LDAP_IFXBASE=cn=gbasedbt,
o=kmart,c=US;LDAP_USER=abcd;LDAP_PASSWD=secret;SQLH_LOC=PROXY;
PROXY=webserver:1462
要获取使用带有代理的 LDAP 服务器的完整示例，
请参阅安装 JDBC 驱动程序的 demo 目
录中的 proxy applet 和应用程序。
指定 sqlhosts 文件查找
当您正在使用代理时，SQLH_LOC 关键字也适用于 sqlhosts 文件查找。如果 URL 包括
SQLH_LOC=PROXY，则驱动程序读取服务器上的 sqlhosts文件。如果未指定 SQLH_LOC
=PROXY，则驱动程序读取客户机上的文件。
此示例从服务器上的 sqlhosts 获取信息：
jdbc:gbasedbt-sqli:gbasedbtserver=samsara;SQLH_TYPE=FILE;
SQLH_FILE=/work/9.x/etc/sqlhosts;SQLH_LOC=PROXY;
PROXY=webserver:1462
SQLTablePrivileges 返回表和与每个表相关的特权的列表。
驱动程序将此信息作为指定 hstmt 上的结果集。
下表描述了 SQLTablePrivileges 的 SQLSTATE 和错误值。
SQLSTATE
错误值
错误消息
01000
-11001
General warning
08S01
-11020
Communication-link failure
24000
-11031
Invalid cursor state
S1000
-11060
General error
S1001
-11061
Memory-allocation failure
S1008
-11065
Operation canceled
S1010
-11067
Function-sequence error
S1090
-11071
Invalid string or buffer length
S1C00
-11092
Driver not capable
S1T00
-11094
Time-out expired
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 242 -
SQLSTATE
错误值
错误消息
S1C00
-11300
SQL_DEFAULT_PARAM not supported
08S01
-11301
A protocol error has been detected. Current connection is
closed.
S1000
-11310
Create and Drop must be executed within a ServerOnly
Connection
S1000
-11320
Syntax error
S1000
-11323
The statement contained an escape clause not supported by
this database driver