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 では、それらのドライバの製品サポートは提供していませんが、Application Server 9.1 での使用についての限定サポートを提供しています。

JDBC ドライバの統合方法、および管理コンソールまたはコマンド行インタフェースを使って設定を実装する方法の詳細については、『Sun Java System Application Server 9.1 管理ガイド』を参照してください。

注 –

Oracle データベースユーザーが capture-schema コマンドを実行するには、そのユーザーがスキーマの所有者でないかぎり、ANALYZE ANY TABLE 特権が必要です。この特権は、データベース管理者がユーザーに付与します。capture-schema については、『Sun Java System Application Server 9.1 Reference Manual』を参照してください。

Derby Type 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 リソースを設定するときにこの名前を使用します。
「リソースタイプ」: 適切な値を指定します。
「データベースベンダー」: Microsoft SQL Server
「データソースクラス名」: 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 Type 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 Type 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 Type 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 Type 4 ドライバには、必須の relaxAutoCommit プロパティーを設定する手段が用意されていないので、URL プロパティーを次のように設定することにより間接的に設定してください。
```
jdbc:mysql://host:port/database?relaxAutoCommit="true"
```

MM MySQL Type 4 ドライバ (XA のみ)

「名前」: あとで JDBC リソースを設定するときにこの名前を使用します。
「リソースタイプ」: 適切な値を指定します。
「データベースベンダー」: MySQL
「データソースクラス名」: 次のように指定します。
```
com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
```
「プロパティー」:
- serverName - データベースサーバーのホスト名または IP アドレスを指定します。
- port - データベースサーバーのポート番号を指定します。
- user - 必要に応じて設定します。
- password - 必要に応じて設定します。
- databaseName - 必要に応じて設定します。
- URL - グローバルトランザクションを使用する場合は、serverName、port、および databaseName の代わりにこのプロパティーを設定できます。
  
  MM MySQL Type 4 ドライバには、必須の relaxAutoCommit プロパティーを設定する手段が用意されていないので、URL プロパティーを次のように設定することにより間接的に設定してください。
```
jdbc:mysql://host:port/database?relaxAutoCommit="true"
```

Oracle 8.1.7 および 9.x データベース用の Inet Oraxo JDBC ドライバ

この 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 データ型のサイズが 4K バイトを超え、このドライバが CMP で使用される場合は、このプロパティーを true に設定してください。
- xa-driver-does-not-support-non-tx-operations - true の値に設定します。これは任意指定です。同じ接続プールから非 XA 接続と XA 接続の両方が取得される場合にのみ必要です。パフォーマンスが低下する可能性があります。
  
  このプロパティーを設定する代わりに、非 XA 接続用とXA 接続用の 2 つの接続プールを作成することもできます。

Microsoft SQL Server データベース用の Inet Merlia JDBC ドライバ

この Microsoft SQL Server ドライバの JAR ファイルは Merlia.jar です。次のように接続プールを設定します。

「名前」: あとで JDBC リソースを設定するときにこの名前を使用します。
「リソースタイプ」: 適切な値を指定します。
「データベースベンダー」: Microsoft SQL Server
「データソースクラス名」: 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 Type 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 接続用の 2 つの接続プールを作成することもできます。
注 –
グローバルトランザクションの復旧が正しく動作するためには、トランザクションサービスで oracle-xa-recovery-workaround プロパティーを設定する必要があります。詳細については、「特定のデータベースに関する問題の回避方法」を参照してください。

このドライバを使用する場合、2000 バイトを超えるデータを列に挿入することはできません。この問題を回避するには、OCI ドライバ (JDBC Type 2) を使用します。

Oracle 8.1.7 および 9.x データベース用の OCI Oracle Type 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 接続用の 2 つの接続プールを作成することもできます。

IBM Informix Type 4 ドライバ

次のように接続プールを設定します。

「名前」: あとで JDBC リソースを設定するときにこの名前を使用します。
「リソースタイプ」: 適切な値を指定します。
「データベースベンダー」: Informix
「データソースクラス名」: 次のいずれかを指定します。
```
com.informix.jdbcx.IfxDataSource
com.informix.jdbcx.IfxXADataSource
```
「プロパティー」:
- serverName - Informix データベースサーバー名を指定します。
- portNumber - データベースサーバーのポート番号を指定します。
- user - 必要に応じて設定します。
- password - 必要に応じて設定します。
- databaseName - 必要に応じて設定します。これは任意指定です。
- IfxIFXHost - データベースサーバーのホスト名または IP アドレスを指定します。

CloudScape 5.1 Type 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 - 必要に応じて設定します。