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 驅動程式

Derby JDBC 驅動程式預設隨附於 Application Server，但 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 驅動程式

Inet 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 Thin 類型 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 - 予以適當設定。