WebOTX Manual V10.2 (第4版) 目次を表示

---

8. JDBCデータソース

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

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

JDBCデータソースのMO名は、「jdbc-datasource.datasource-name」です。datasource-nameは、"jdbc/"で始まるJDBCデータソースの定義名です。JNDIサーバへの登録名を兼ねます。

JDBC データソースの登録を行うと、JDBCデータソースの定義情報がdomain.xmlに登録され、同時に、JNDIサーバへの登録が行われます。また、管理コマンド等で設定変更を行った際には、 domain.xmlの変更とJNDIサーバへの再登録が行われます。 domain.xmlの設定をエディタ等で修正する場合、use-jmx-agentがfalse(既定値true)の 場合は、JNDIサーバへの再登録が行われないため、変更内容を動作に反映させることが できません。use-jmx-agentの詳細は、 「リソースのプロセス単位のロード設定(Standardの場合)」を ご確認ください。なお、domain.xml の編集はドメイン停止状態で実施してください。

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

JDBCデータソースの属性やプロパティの値を変更した場合、JDBCデータソースへの設定変更内容の反映を行った際に、変更内容が動作に反映されます。または、アプリケーションで、JNDIサーバからJDBCデータソースを再取得した際に、変更内容を動作に反映することができます。

コネクションに関連する属性やプロパティ（dataSourceType や jdbcMajorVersion、dataSourceName、serverName、networkProtocol、portNumber、userName、password、loginTimeout、 jdbcDriverName、cursorMode、characterEncoding、maxStatements、useJTA、useOneConnectionPerTransaction、useDatabaseCluster、checkGarbageOption、clusterPoolOption、 jndiProviderUrl、wrapStatement、readTimeout、transactionIsolationLevel、driverVenderProperties）を変更する場合は、プロパティ置換までの待機時間(propertyCycle)が経過した後で、そのプールに存在するコネクション全てが消滅し、新しいコネクションが作成されます。

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

定義の追加

> dsadm bind property-file-name

項目の参照

> dsadm list

項目の設定

> dsadm rebind property-file-name

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

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

8.2.1. 一般設定項目一覧

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

8.2.2. コネクションプール設定項目一覧

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

8.2.3. コネクション制御設定項目一覧

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

8.2.4. 拡張設定項目一覧

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

8.2.5. SQLランキング設定項目一覧

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

8.2.6. ACOS Access Toolkit設定項目一覧

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

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

8.2.7. プロパティ一覧

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

8.2.8. Javaシステムプロパティ一覧

Javaのシステムプロパティに、次の項目を設定することができます。JDBCデータソースのMOを介して設定する項目に優先する、プロセス内共通の設定となります。 参照および設定方法の詳細は、[ 構築・運用 > ドメインの構築 > Java VMオプションの設定 > ユーザ独自のJava VMオプションの追加方法] を参照してください。

通常のログ出力内容の設定方法については、 [ 構築・運用 > ログ ]を参照してください。

8.3. Oracleでの設定内容

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

8.4. Microsoft SQL Serverでの設定内容

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

8.5. PostgreSQLでの設定内容

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

8.6. Apache Derby での設定内容

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

8.7. JDBC での設定内容

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

8.8. クラスパス設定

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

クラスパスの設定方法については「 構築・運用 > ドメインの構築 > Java VMオプションの設定」を参照してください。ただし、Java11をご利用の場合は、Java11ご利用の場合のクラスパス設定についての内容をご確認ください。設定では、複数バージョンのクラスが混在しないように、必要なファイルだけをクラスパスに追加してください。

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

8.8.1. Java11以降におけるクラスパス設定

Java9で拡張機能メカニズムが削除されたことにより、Java11以降をご利用の場合は、クラスパス設定の手段として「${INSTANCE_ROOT}/lib/extへの配置」はご利用いただけません。
クラスパスの設定「 構築・運用 > ドメインの構築 > Java VMオプションの設定」に記載の、「${INSTANCE_ROOT}/lib/extへの配置 」以外の方法でクラスパス設定を行ってください。
また、クラスパスに追加したJDBCドライバについて、${INSTANCE_ROOT}/config/server.policyにアクセス権の設定を行ってください。

{INSTANCE_ROOT}/libにojdbc8.jarを配置することでクラスパス設定 を行う場合であれば、{INSTANCE_ROOT}が「C:\WebOTX\domains\domain1」 の場合、ドメイン停止時に「C:\WebOTX\domains\domain1\config\server.policy」に次のようにポリシーを追加してください。

例: ポリシーの追加

grant codeBase "file:C:/WebOTX/domains/domain1/lib/ojdbc8.jar" {
    permission java.security.AllPermission;
};

{INSTANCE_ROOT}や、JDBCドライバのファイル名およびパスは、ご利用の環境に合わせて変更してください。

8.9. その他の設定

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

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

• 「インストールガイド > Windows」
• 「インストールガイド > Linux」
• 「インストールガイド > HP-UX」