Sun Java System Application Server 9.1 管理指南

特定 JDBC 驱动程序的配置

Application Server 9.1 旨在支持连接到任何数据库管理系统（使用对应的 JDBC 驱动程序）。支持以下 JDBC 驱动程序和数据库组合。已经对 Application Server 9.1 测试了这些组合，并且查明这些组合是与 J2EE 兼容的。它们也受 CMP 的支持。

有关当前支持的 JDBC 驱动程序的最新列表，请参见《Sun Java System Application Server 9.1 发行说明》。

其他 JDBC 驱动程序可用于 Application Server 9.1，但是尚未完成这些驱动程序的 J2EE 兼容性测试。虽然 Sun 未提供对这些驱动程序的产品支持，但是 Sun 提供了将这些驱动程序用于 Application Server 9.1 的有限支持。

有关如何集成 JDBC 驱动程序以及如何使用管理控制台或命令行界面实现配置的详细信息，请参见《Sun Java System Application Server 9.1 管理指南》。

注 –

如果运行 capture-schema 命令的 Oracle 数据库用户不拥有该模式，则该用户需要 ANALYZE ANY TABLE 权限。这些权限由数据库管理员授予用户。有关 capture-schema 的信息，请参见《Sun Java System Application Server 9.1 Reference Manual》。

Derby 类型 4 驱动程序

默认情况下 Application Server 附带有 Derby JDBC 驱动程序，但 Solaris 捆绑安装（该安装不包含 Derby）除外。因此，除非具有 Solaris 捆绑安装，否则无需将此 JDBC 驱动程序与 Application Server 集成。

Derby 驱动程序的 JAR 文件是 derbyclient.jar。

使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Derby

数据源类名称：指定以下名称之一：

org.apache.derby.jdbc.ClientDataSource
org.apache.derby.jdbc.ClientXADataSource

属性：
- user－指定数据库用户。
  
  仅当将 Derby 配置为使用验证时才需要使用此属性。默认情况下 Derby 不使用验证。如果提供了用户，则它是表所驻留的模式的名称。
- password－指定数据库密码。
  
  仅当将 Derby 配置为使用验证时才需要使用此属性。
- databaseName－指定数据库的名称。
- serverName－指定数据库服务器的主机名或 IP 地址。
- portNumber－指定数据库服务器的端口号（如果它与默认端口号不同）。
URL：jdbc:derby:// serverName: portNumber/databaseName ;create=true

仅当要创建数据库（如果它不存在）时才包含 ;create=true 部分。

用于 DB2 数据库的 Sun Java System JDBC 驱动程序

此驱动程序的 JAR 文件是 smbase.jar、smdb2.jar 和 smutil.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：DB2
数据源类名称：com.sun.sql.jdbcx.db2.DB2DataSource
属性：
- serverName－指定数据库服务器的主机名或 IP 地址。
- portNumber－指定数据库服务器的端口号。
- databaseName－根据需要进行设置。
- user－根据需要进行设置。
- password－根据需要进行设置。
URL：jdbc:sun:db2:// serverName: portNumber;databaseName=databaseName

用于 Oracle 8.1.7 和 9.x 数据库的 Sun Java System JDBC 驱动程序

此驱动程序的 JAR 文件是 smbase.jar、smoracle.jar 和 smutil.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Oracle
数据源类名称：com.sun.sql.jdbcx.oracle.OracleDataSource
属性：
- serverName－指定数据库服务器的主机名或 IP 地址。
- portNumber－指定数据库服务器的端口号。
- SID－根据需要进行设置。
- user－根据需要进行设置。
- password－根据需要进行设置。
URL：jdbc:sun:oracle:// serverName[: portNumber][;SID=databaseName ]

用于 Microsoft SQL Server 数据库的 Sun Java System JDBC 驱动程序

此驱动程序的 JAR 文件是 smbase.jar、smsqlserver.jar 和 smutil.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：mssql
数据源类名称：com.sun.sql.jdbcx.sqlserver.SQLServerDataSource
属性：
- serverName－指定数据库服务器的主机名或 IP 地址以及端口。
- portNumber－指定数据库服务器的端口号。
- user－根据需要进行设置。
- password－根据需要进行设置。
- selectMethod－设置为 cursor。
URL：jdbc:sun:sqlserver:// serverName[: portNumber]

用于 Sybase 数据库的 Sun Java System JDBC 驱动程序

此驱动程序的 JAR 文件是 smbase.jar、smsybase.jar 和 smutil.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Sybase
数据源类名称：com.sun.sql.jdbcx.sybase.SybaseDataSource
属性：
- serverName－指定数据库服务器的主机名或 IP 地址。
- portNumber－指定数据库服务器的端口号。
- databaseName－根据需要进行设置。这是可选项。
- user－根据需要进行设置。
- password－根据需要进行设置。
URL：jdbc:sun:sybase:// serverName[: portNumber]

IBM DB2 8.1 类型 2 驱动程序

DB2 驱动程序的 JAR 文件是 db2jcc.jar、db2jcc_license_cu.jar 和 db2java.zip。对环境变量进行如下设置：

LD_LIBRARY_PATH=/usr/db2user/sqllib/lib:${j2ee.home}/lib
DB2DIR=/opt/IBM/db2/V8.1
DB2INSTANCE=db2user
INSTHOME=/usr/db2user
VWSPATH=/usr/db2user/sqllib
THREADS_FLAG=native

使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：DB2
数据源类名称：com.ibm.db2.jcc.DB2SimpleDataSource
属性：
- user－根据需要进行设置。
- password－根据需要进行设置。
- databaseName－根据需要进行设置。
- driverType－设置为 2。
- deferPrepares－设置为 false。

用于 Sybase ASE 12.5 数据库的 JConnect 类型 4 驱动程序

Sybase 驱动程序的 JAR 文件是 jconn2.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Sybase

数据源类名称：指定以下名称之一：

com.sybase.jdbc2.jdbc.SybDataSource
com.sybase.jdbc2.jdbc.SybXADataSource

属性：
- serverName－指定数据库服务器的主机名或 IP 地址。
- portNumber－指定数据库服务器的端口号。
- user－根据需要进行设置。
- password－根据需要进行设置。
- databaseName－根据需要进行设置。不要指定完整的 URL，仅指定数据库名称。
- BE_AS_JDBC_COMPLIANT_AS_POSSIBLE－设置为 true。
- FAKE_METADATA－设置为 true。

MM MySQL 类型 4 驱动程序（非 XA）

MySQL 驱动程序的 JAR 文件是 mysql-connector-java-version-bin-g.jar，例如 mysql-connector-java-3.1.12-bin-g.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：mysql
数据源类名称：指定以下名称之一：
```
com.mysql.jdbc.jdbc2.optional.MysqlDataSource
```
属性：
- serverName－指定数据库服务器的主机名或 IP 地址。
- port－指定数据库服务器的端口号。
- user－根据需要进行设置。
- password－根据需要进行设置。
- databaseName－根据需要进行设置。
- URL－如果使用的是全局事务，则可以设置此属性而不是 serverName、port 和 databaseName。
  
  MM MySQL 类型 4 驱动程序未提供用于设置所需的 relaxAutoCommit 属性的方法，因此必须通过设置 URL 属性来间接设置它：
```
jdbc:mysql://host:port/database?relaxAutoCommit="true"
```

MM MySQL 类型 4 驱动程序（仅限 XA）

MySQL 驱动程序的 JAR 文件是 mysql-connector-java-version-bin-g.jar，例如 mysql-connector-java-3.1.12-bin-g.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：mysql
数据源类名称：指定以下名称之一：
```
com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
```
属性：
- serverName－指定数据库服务器的主机名或 IP 地址。
- port－指定数据库服务器的端口号。
- user－根据需要进行设置。
- password－根据需要进行设置。
- databaseName－根据需要进行设置。
- URL－如果使用的是全局事务，则可以设置此属性而不是 serverName、port 和 databaseName。
  
  MM MySQL 类型 4 驱动程序未提供用于设置所需的 relaxAutoCommit 属性的方法，因此必须通过设置 URL 属性来间接设置它：
```
jdbc:mysql://host:port/database?relaxAutoCommit="true"
```

用于 Oracle 8.1.7 和 9.x 数据库的 Inet Oraxo JDBC 驱动程序

Inet Oracle 驱动程序的 JAR 文件是 Oranxo.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Oracle
数据源类名称：com.inet.ora.OraDataSource
属性：
- user－指定数据库用户。
- password－指定数据库密码。
- serviceName－指定数据库的 URL。语法如下：
```
jdbc:inetora:server:port:dbname
```
  例如：
```
jdbc:inetora:localhost:1521:payrolldb
```
  在此示例中，localhost 为运行 Oracle 服务器的计算机的主机名，1521 为 Oracle 服务器的端口号，payrolldb 为数据库的 SID。有关数据库 URL 语法的更多信息，请参见 Oracle 文档。
- serverName－指定数据库服务器的主机名或 IP 地址。
- port－指定数据库服务器的端口号。
- streamstolob－如果 BLOB 或 CLOB 数据类型的大小超过 4 KB 且此驱动程序用于 CMP，则必须将此属性设置为 true。
- xa-driver-does-not-support-non-tx-operations－设置为值 true。可选：仅当从同一连接池同时获取非 XA 连接和 XA 连接时才需要。可能会降低性能。
  
  作为设置此属性的替代方法，可以创建两个连接池，一个用于非 XA 连接，另一个用于 XA 连接。

用于 Microsoft SQL Server 数据库的 Inet Merlia JDBC 驱动程序

Microsoft SQL Server 驱动程序的 JAR 文件是 Merlia.jar 。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：mssql
数据源类名称：com.inet.tds.TdsDataSource
属性：
- serverName－指定数据库服务器的主机名或 IP 地址以及端口。
- port－指定数据库服务器的端口号。
- user－根据需要进行设置。
- password－根据需要进行设置。

用于 Sybase 数据库的 Inet Sybelux JDBC 驱动程序

Inet Sybase 驱动程序的 JAR 文件是 Sybelux.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Sybase
数据源类名称：com.inet.syb.SybDataSource
属性：
- serverName－指定数据库服务器的主机名或 IP 地址。
- portNumber－指定数据库服务器的端口号。
- user－根据需要进行设置。
- password－根据需要进行设置。
- databaseName－根据需要进行设置。不要指定完整的 URL，仅指定数据库名称。

用于 Oracle 8.1.7 和 9.x 数据库的 Oracle 瘦类型 4 驱动程序

Oracle 驱动程序的 JAR 文件是 ojdbc14.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Oracle

数据源类名称：指定以下名称之一：

oracle.jdbc.pool.OracleDataSource
oracle.jdbc.xa.client.OracleXADataSource

属性：
- user－根据需要进行设置。
- password－根据需要进行设置。
- URL－使用以下语法指定完整的数据库 URL：
```
jdbc:oracle:thin:[user/password]@host[:port]/service
```
  例如：
```
jdbc:oracle:thin:@localhost:1521:customer_db
```
- xa-driver-does-not-support-non-tx-operations－设置为值 true。可选：仅当从同一连接池同时获取非 XA 连接和 XA 连接时才需要。可能会降低性能。
  
  作为设置此属性的替代方法，可以创建两个连接池，一个用于非 XA 连接，另一个用于 XA 连接。
注 –
必须在“事务服务”中设置 oracle-xa-recovery-workaround 属性，才能使全局事务的恢复正常进行。有关详细信息，请参见特定数据库的解决方法。

使用此驱动程序时，无法将 2000 字节以上的数据插入到一列中。要解决此问题，请使用 OCI 驱动程序（JDBC 类型 2）。

用于 Oracle 8.1.7 和 9.x 数据库的 OCI Oracle 类型 2 驱动程序

OCI Oracle 驱动程序的 JAR 文件是 ojdbc14.jar。请确保可通过 LD_LIBRARY_PATH 使用共享库且设置了 ORACLE_HOME 属性。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Oracle

数据源类名称：指定以下名称之一：

oracle.jdbc.pool.OracleDataSource
oracle.jdbc.xa.client.OracleXADataSource

属性：
- user－根据需要进行设置。
- password－根据需要进行设置。
- URL－使用以下语法指定完整的数据库 URL：
```
jdbc:oracle:oci:[user/password]@host[:port]/service
```
  例如：
```
jdbc:oracle:oci:@localhost:1521:customer_db
```
- xa-driver-does-not-support-non-tx-operations－设置为值 true。可选：仅当从同一连接池同时获取非 XA 连接和 XA 连接时才需要。可能会降低性能。
  
  作为设置此属性的替代方法，可以创建两个连接池，一个用于非 XA 连接，另一个用于 XA 连接。

IBM Informix 类型 4 驱动程序

使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Informix

数据源类名称：指定以下名称之一：

com.informix.jdbcx.IfxDataSource
com.informix.jdbcx.IfxXADataSource

属性：
- serverName－指定 Informix 数据库服务器名称。
- portNumber－指定数据库服务器的端口号。
- user－根据需要进行设置。
- password－根据需要进行设置。
- databaseName－根据需要进行设置。这是可选项。
- IfxIFXHost－指定数据库服务器的主机名或 IP 地址。

CloudScape 5.1 类型 4 驱动程序

CloudScape 驱动程序的 JAR 文件是 db2j.jar、db2jtools.jar、db2jcview.jar、jh.jar 、db2jcc.jar 和 db2jnet.jar。使用以下设置配置连接池：

名称：稍后配置 JDBC 资源时使用此名称。
资源类型：指定相应的值。
数据库供应商：Cloudscape
数据源类名称：com.ibm.db2.jcc.DB2DataSource
属性：
- user－根据需要进行设置。
- password－根据需要进行设置。
- databaseName－根据需要进行设置。