JDBC プロバイダーおよびデータ・ソースの構成

リレーショナル・データベースにアクセスする場合、アプリケーションはアプリケーション・サーバー用に構成された Java™ Database Connectivity (JDBC) ドライバーおよびデータ・ソースを使用します。

始める前に

各ベンダー・データベースは、JDBC 接続用に異なる JDBC ドライバー実装クラスを必要とします。JDBC プロバイダーは、これらのベンダー固有のドライバー・ファイルをカプセル化します。 JDBC プロバイダーと関連付けられたデータ・ソースを介して、アプリケー ション・サーバーは、アプリケーションとデータベース間のトランザクショ ンの物理接続を取得し管理します。
重要: DB2® データベースにアクセスする場合は、JDBC の 代わりに IBM Optim pureQuery Runtime を使用できます。pureQuery の詳細については、関連リンクのセクションにある 『タスクの概要: IBM Optim pureQuery Runtime』トピックを参照してください。
このタスクを開始する前に、 アプリケーションの API 仕様に従い、必要なデータ・ソースのバージョンを判別します。
  • 非推奨の機能 (Deprecated feature) 非推奨の機能 (Deprecated feature): depfeat
    データ・ソース (WebSphere® Application Server バージョン 4) (非推奨) は、Enterprise JavaBeans (EJB) 1.0 仕様、および Java サーブレット 2.2 仕様で使用されます。
  • 最新の標準バージョンのデータ・ソースは、それらの仕様のより拡張されたリリースを実装するアプリケーションで使用されます。
[z/OS]重要: JDBC Universal JDBC ドライバーを介して DB2 for z/OS® に接続する場合は、『DB2 Universal JDBC ドライバーを使用した DB2 for z/OS へのアクセス』を参照してください。この項目では、JDBC ドライバーと関連ファイルのインストールと必要なプ ロパティーのアクティブ化について詳細に説明しています。

手順

  1. ノード・マネージャー上に、すべての必要な JDBC ドライバー・ファイルがインストールされていることを検証します。 ベンダー別の情報については、『ベンダーによる、データ・ソースの最小必要設定』を参照してください。ユーザー定義の JDBC プロバイダーを構成する場合は、ドライバー・ファイルについての情報のデータベース資料をチェックします。
  2. JDBC プロバイダーを作成します。

    管理コンソールから JDBC プロバイダーを作成する場合は、『管理コンソールを使用した JDBC プロバイダーの構成』を参照してください。または、

    wsadmin スクリプト・クライアントを使用する場合は、『スクリプトによる JDBC プロバイダーの構成』を参照してください。または、

    Java Management Extensions (JMX) API の使用については、『Java Management Extensions API を使用した JDBC プロバイダーおよびデータ・ソースの作成』のトピックを参照してください。

  3. データ・ソースを作成します。

    管理コンソールを使用する場合は、『管理コンソールを使用したデータ・ソースの作成』を参照してください。または、

    wsadmin スクリプト・クライアントを使用する場合は、『スクリプトによる新規データ・ソースの構成』を参照してください。V4 データ・ソースの場合、『スクリプトによる新規 WAS40 データ・ソースの構成』(非推奨) のトピックを参照してください。

    JMX API の使用については、『JavaManagement Extensions API を使用した JDBC プロバイダーおよびデータ・ソースの作成』を参照してください。

    必須プロパティー: さまざまなデータベース・ベンダーが、それぞれの JDBC ドライバーの実装に対してさまざまなプロパティーを要求します。 WebSphere Application Server データ・ソース上で、これらのプロパティーを設定します。 アプリケーション・サーバーには多くのベンダーの JDBC 実装のテンプレ ートが含まれているので、管理コンソールにより必須プロパティーが明らか になり、それらに対してデータ・ソースを作成するようにプロンプトが出さ れます。 ただし、データ・アクセス構成をスクリプト記述する場合は、必須プロパティーおよび設定オプションについて『ベンダーによる、データ・ソースの最小必要設定 』を参照する必要があります。
  4. オプション: カスタム・プロパティーを構成します。

    必須プロパティーと同様に、特定のベンダー JDBC ドライバーのカ スタム・プロパティーもアプリケーション・サーバー・データ・ソース上に 設定する必要があります。 使用可能なカスタム・プロパティーの詳細については、ご使用のデータベースの資料を参照してください。 Application Server がネイティブで認識しない データベース・プロパティーの処理を容易にするようにカスタム・クラスを 構成するには、『カスタム DataStoreHelper クラスの開発』を参照してください。

    また、DB2 sslConnection カスタム・プロパティーなど、オプションのデータ・ソース・プロパティーもあり、それを構成することもできます。これらのカスタム・プロパティーについて詳しくは、DB2 Universal JDBC ドライバーのプロバイダーを使用する場合、ご使用のバージョンの DB2 for z/OS の「Application Programming Guide and Reference for Java」を参照してください。

  5. データ・ソースにリソース参照を結合します。 『エンタープライズ Bean および Web モジュールのデータ・ソース検索』を参照してください。
  6. 接続のテストを行います (非コンテナー管理パーシスタンス使用の場合)。 『テスト接続サービス』を参照してください。

タスクの結果

DB2 JDBC Universal Driver を使用する場合、 アプリケーション・サーバー JVM ログが文書化されないというデータ・ソース障害が発生する可能性があります。 DB2 データベース・ログ、または WebSphere Application Server JDBC トレース・ログ (JDBC トレースがアクティブであった場合) を確認してください。 正しくない認証クレデンシャルが障害の原因であることが検出される場合があります。 DB2 JDBC Universal Driver では、有効ではない認証クレデンシャルによって適切な方法または一貫性のある方法で 作成されたエラーが、現行では、識別も表示もされません。

正しくないクレデンシャルについての情報を受信した場合でも、データベース・ログおよび JDBC トレース・ログをチェックします。 これらのログは、認証障害について、より信頼性の高い詳細なエラー・データを提供します。

ベスト・プラクティス ベスト・プラクティス: JDBC トレース・ログは、サーバー始動時に JDBC トレース・サービスがアクティブな場合のみ存在します。 管理コンソールでサービスをアクティブ化します。 詳しくは、『サーバー始動時にトレースを使用可能にする』を参照してください。 トレース・グループとして WAS.database を指定し、トレース・ストリングとして com.ibm.ws.db2.logwriter を選択します。bprac

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_tccrtprovds
ファイル名:tdat_tccrtprovds.html