9.JDBCデータソースに関する設定

JDBCデータソースに関する設定について説明します。

9.1.JDBCデータソース設定項目・設定方法

JDBCデータソースのMO名は、「jdbc-datasource.datasource-name」です。datasource-nameは、"jdbc/"で始まるJDBCデータソースの定義名です。JNDIサーバへの登録名を兼ねます。 JDBC データソースの登録を行うと、JDBCデータソースの定義情報がdomain.xmlに登録され、同時に、JNDIサーバへの登録が行われます。また、管理コマンド等で設定変更を行った際には、 domain.xmlの変更とJNDIサーバへの再登録が行われます。domain.xmlの設定をエディタ等で修正してもJNDIサーバへの再登録が行われないため、変更内容を動作に反映させることはできません。

コマンドで各項目を参照・設定する際は、「server.resources.jdbc-datasource.datasource-name」という名前を指定します。また、統合運用管理ツールでは、ドメイン ツリーの「WebOTXAdmin[ホスト名].ドメイン名.resources.jdbc-datasource.datasource-name」を選択します。項目の設定方法については「2.各サービスの属性の設定」を参照してください。

JDBCデータソースの属性やプロパティの値を変更した場合、アプリケーションで、JNDIサーバからJDBCデータソースを再取得した際に、変更内容が動作に反映されます。 ただし、java:comp/env指定で、アプリケーション固有の名前空間からJDBCデータソースを取得する場合に、変更内容を動作に反映するためには、プロセス(JavaVM)の再起動が必要です。コネクションに関連する属性やプロパティ（dataSourceType や jdbcMajorVersion、dataSourceName、serverName、networkProtocol、portNumber、userName、password、loginTimeout、jdbcDriverName、cursorMode、characterEncoding、maxStatements、useJTA、useOneConnectionPerTransaction、useDatabaseCluster、checkGarbageOption）を変更する場合は、プロパティ置換までの待機時間(propertyCycle)が経過した後で、そのプールに存在するコネクション全てが消滅し、新しいコネクションが作成されます。

なお、JDBCデータソースでは、旧バージョンで提供していたdsadmコマンドも利用することができます。dsadmコマンドのリファレンスについては「JDBCデータソースコマンドリファレンス」を参照ください。

定義の追加

> dsadm bind property-file-name

項目の参照

> dsadm list

項目の設定

> dsadm rebind property-file-name

9.2.JDBCデータソース設定項目一覧

JDBCデータソースのMOを介して、次の項目を参照・設定することができます。

Dottedname : server.resources.jdbc-datasource.datasource-name

そのほかに、アプリケーションプロセスにおけるリソースのロード設定に関する属性があります。詳細は、「6.4リソースのプロセス単位のロード設定(Standard/Enterprise Editionの場合)」を参照してください。

Dottedname : server.resources.jdbc-datasource.datasource-name.property

Javaのシステムプロパティに、次の項目を設定することができます。JDBCデータソースのMOを介して設定する項目に優先する、プロセス内共通の設定となります。通常のログ出力内容の設定方法については、 「運用編(ログ)」を参照してください。

9.3.Oracleでの設定内容

OracleのJDBCドライバのDataSourceインタフェースを使用する場合、dataSourceTypeに JDBCEX_Oracle を設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
databaseName	TransactionサービスのDB識別名を設定します。通常、設定する必要はありません。	---（設定しません）
その他	jdbcDriverNameとcursorMode、characterEncoding、networkProtocol、autoRecoveryOnOnePhaseCommit以外のプロパティを、必要に応じて設定します。	←（同じです）

9.4.DB2での設定内容

DB2 Universal JDBCドライバのDataSourceインタフェースを使用する場合、dataSourceTypeに JDBCEX_DB2 を設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
databaseName	TransactionサービスのDB識別名を設定します。通常、設定する必要はありません。	---（設定しません）
その他	jdbcDriverNameとcursorMode、characterEncoding、networkProtocol、autoRecoveryOnOnePhaseCommit以外のプロパティを、必要に応じて設定します。	←（同じです）

9.5.Microsoft SQL Serverでの設定内容

Microsoft SQL ServerのJDBCドライバのDataSourceインタフェースを使用する場合、dataSourceTypeに JDBCEX_MSSqlServer を設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
cursorMode	データベースカーソルの利用有無を設定します。 設定値はSelectMethodプロパティ値としてJDBCドライバに設定されます。	←（同じです）
characterEncoding	文字列引数を送信する際の変換方法を設定します。 設定値はUnicodeかどうかを表すブール値に変換され、SendStringParametersAsUnicodeプロパティ値としてJDBCドライバに設定されます。ただし、Microsoft SQL Server 2005のJDBCドライバを使用してJTA連携を行う場合、必ず、Unicodeとして処理が行われます。	←（同じです）
databaseName	TransactionサービスのDB識別名を設定します。通常、設定する必要はありません。	---（設定しません）
その他	jdbcDriverNameとnetworkProtocol、autoRecoveryOnOnePhaseCommit以外のプロパティを、必要に応じて設定します。	←（同じです）

9.6.Sybaseでの設定内容

SybaseのJDBCドライバのDataSourceインタフェースを使用する場合、dataSourceTypeに JDBCEX_Sybase を設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
cursorMode	データベースカーソルの利用有無を設定します。 cursorを設定した場合、REPEAT_READプロパティ値としてfalseがJDBCドライバに設定されます。 directを設定した場合、REPEAT_READプロパティ値としてtrueがJDBCドライバに設定されます。	←（同じです）
characterEncoding	文字列引数を送信する際の変換方法を設定します。 Unicodeを設定した場合、JCONNECT_VERSIONプロパティ値として 6 がJDBCドライバに設定されます。	←（同じです）
networkProtocol	データベースとの通信プロトコルを設定します。デフォルト値はTdsです。	←（同じです）

9.7.SequeLinkでの設定内容

SequeLinkのJDBCドライバのDataSourceインタフェースを使用する場合、dataSourceTypeに JDBCEX_SequeLink を設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
networkProtocol	データベースとの通信プロトコルを設定します。デフォルト値はTcpipです。	←（同じです）
databaseName	TransactionサービスのDB識別名を設定します。通常、設定する必要はありません。	---（設定しません）
その他	jdbcDriverNameとcursorMode、characterEncoding、autoRecoveryOnOnePhaseCommit以外のプロパティを、必要に応じて設定します。	←（同じです）

9.8.Cloudscapeでの設定内容

CloudscapeのJDBCドライバのDataSourceインタフェースを使用する場合、dataSourceTypeに JDBCEX_Cloudscape を設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
networkProtocol	---（設定しません）	データベースとの通信プロトコルを設定します。 rmiを指定するか指定なしのいずれかです。rmiを指定するとローカルホストのRmiJdbcサーバにデフォルトのポート番号1099で接続します。デフォルト値は指定なしです。 サーバ名とポート番号を指定する場合は"rmi://hostname:port番号/"と記述します。
databaseName	TransactionサービスのDB識別名を設定します。通常、設定する必要はありません。	---（設定しません）
その他	jdbcDriverNameとcharacterEncoding、cursorMode以外のプロパティを、必要に応じて設定します。	←（同じです）

9.9.PostgreSQLでの設定内容

PostgreSQLのJDBCドライバのDataSourceインタフェースを使用する場合、dataSourceTypeに JDBCEX_PostgreSQL を設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
databaseName	TransactionサービスのDB識別名を設定します。通常、設定する必要はありません。	---（設定しません）
その他	jdbcDriverNameとcursorMode、characterEncoding、networkProtocol、autoRecoveryOnOnePhaseCommit以外のプロパティを、必要に応じて設定します。	←（同じです）

9.10.Apache Derby での設定内容

Apache DerbyのJDBCドライバのDataSourceインタフェースを使用する場合、dataSourceTypeに JDBCEX_Derby を設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
databaseName	TransactionサービスのDB識別名を設定します。通常、設定する必要はありません。	---（設定しません）
その他	jdbcDriverNameとcursorMode、characterEncoding、networkProtocol、autoRecoveryOnOnePhaseCommit以外のプロパティを、必要に応じて設定します。	←（同じです）

9.11.JDBC での設定内容

そのほかのJDBCドライバを使用する場合、dataSourceTypeプロパティにJDBCを設定します。また、EJBのトランザクション（JTA）と連携するかどうかによって、次の内容を設定します。

プロパティ名	JTAと連携する場合の設定内容	JTAと連携しない場合の設定内容
jdbcDriverName	dataSourceNameの説明で例示した接続文字列を使用するJDBCドライバの名前は設定する必要がありません。それ以外のJDBCドライバを使用する場合には、JDBCドライバのクラス名を設定します。	←（同じです）
autoRecoveryOnOnePhaseCommit	２フェーズコミットを実行する場合に、必要に応じて設定します。	---（設定しません）
その他	cursorModeとcharacterEncoding、networkProtocol、databaseName以外のプロパティを、必要に応じて設定します。	←（同じです）

9.12.クラスパス設定

JDBCデータソースを使用する場合は、使用するデータベースまたはJDBCドライバに応じて次のファイルをクラスパスに追加する必要があります。

クラスパスの設定方法については「運用編（ドメインの運用）」の「4.7 Java VM環境の設定」を参照してください。設定では、複数バージョンのクラスが混在しないように、必要なファイルだけをクラスパスに追加してください。

JDBCデータソースで使用するJDBCドライバの主なクラスは次の通りです。

9.13.その他の設定

OracleのOCI JDBCドライバなど、タイプ２のJDBCドライバを利用する場合には、必要に応じて環境変数の設定作業を行う必要があります。UNIX版では、Javaからロードするnativeのライブラリファイルに適切なアクセス権が付与されていることをご確認ください。 また、EJBのトランザクション（JTA）と連携する場合には、必要に応じてデータベースサーバ側の設定を行う必要があります。詳細は、オンラインリファレンスのマニュアル一覧にある注意制限事項の「6. JDBCデータソース」を参照してください。

そのほか、EJBのトランザクション（JTA）と連携する場合には、セットアップガイドの「2.3.4 データベースを使用するための準備作業（Java）」をご覧ください。