JDBC データ ソースの作成
このページでは、JDBC データ ソースを作成します。JDBC データ ソースは、 JDBC 接続のプールを介したデータベース接続を提供する JNDI ツリーにバインド されたオブジェクトです。アプリケーションから JNDI ツリーのデータ ソースをルックアップ して、データ ソースからのデータベース接続を予約できます。
コンフィグレーション オプション
名前 説明 名前 WebLogic ドメイン内のこのデータ ソースを識別するユニークな名前。
MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCDataSourceBean.Name
JNDI 名 このデータ ソースのバインド先への JNDI パス。デフォルトでは、JNDI 名は データ ソースの名前です。
データ ソースに複数の JNDI 名を指定するには、各 JNDI 名を 個別の行に入力します。
JNDI パスをルックアップするアプリケーションは、このデータ ソースに 対応する
javax.sql.DataSource
インスタンス を取得します。MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCDataSourceParamsBean.JNDINames
データベースの種類 データベースのデータベース管理システムを選択してください。 Administration Console により、選択した DBMS に合わせて 既存の JDBC ドライバのリストが調整され、DBMS でサポート されているフォーマットで接続プロパティが構築されます。
データベース ドライバ 物理データベース接続の作成に使用するドライバを選択してください。 データ ソースにデータベース接続がプールされ、アプリケーションで 使用および再使用されます。
* はドライバが Oracle WebLogic Server に明示的にサポートされていることを示します。
ドライバがリストされていない場合は、[その他] を選択してください。
グローバル トランザクションのサポート このデータ ソースからのデータベース接続をグローバル トランザクションで使用する場合は、 このオプションを選択します。
EJB 使用時は、このオプションを有効にする必要があります。
非 XA JDBC ドライバ使用時にグローバル トランザクションのサポートを有効にした場合、 トランザクション処理のオプションを選択する必要があります。
ロギング ラスト リソース ロギング ラスト リソース (LLR) トランザクションの最適化を使用して データ ソースからの非 XA JDBC 接続がグローバル トランザクションに参加できるようにする 場合は、このオプションを選択します。[2 フェーズ コミットのエミュレート] の代わりにこの オプションを使用することをお勧めします。
このオプションを選択した場合、接続が使用されるトランザクション ブランチは、 トランザクション内の最後のリソースとして処理され、1 フェーズ コミット 操作として処理されます。操作の結果がリソース自身のログ ファイルに 書き込まれ、この結果から、トランザクションの準備フェーズが成功した のか、失敗したのかを判断できます。このオプションはパフォーマンス面で 優れており、2 フェーズ コミットをエミュレートする場合に比べてデータの 安全性に優れています。
2 フェーズ コミットのエミュレート JTA を使用してデータ ソースからの非 XA JDBC 接続がグローバル トランザクション への参加をエミュレートできるようにする場合は、このオプションを選択します。この オプションは、ヒューリスティックな状況に耐えられるアプリケーションでのみ使用して ください。
このオプションを選択した場合、接続が使用されるトランザクション ブランチは、 トランザクションの準備フェーズの結果として常に「成功」を返します。 このオプションはパフォーマンス面で優れていますが、データに障害が 発生する可能性があります。
1 フェーズ コミット 1 フェーズ コミット トランザクション処理を使用してデータ ソースからの 非 XA JDBC 接続がグローバル トランザクションに参加できるようにする 場合は、このオプションを選択します。このオプションを有効にすると、他の リソースはグローバル トランザクションに参加できません。
2 フェーズ コミット このオプションは、XA JDBC ドライバを選択すると自動的に選択されます。このオプションを有効にすると、データ ソースからのデータベース接続は完全に グローバル トランザクションに参加し、WebLogic Server トランザクション マネージャ により 2 フェーズ コミット プロトコルが適用されます。
データベース名 接続先のデータベースの名前を入力します。
サービス名 接続先のデータベースのサービス名を入力します。
ホスト名 データベース サーバの名前または IP アドレスを入力します。
ポート データベース サーバが接続要求をリスンするポート番号を 入力します。
データベース ユーザ名 データベース接続の作成に使用するデータベース ユーザ名を 入力します。
ドライバ クラス名 データ ソースの接続プールでの物理データベース接続の作成に使用する JDBC ドライバ クラスの完全パッケージ名。
例 :
com.pointbase.jdbc.jdbcUniversalDriver
ドライバは、
java.sql.Driver
インタフェースを実装するクラスの名前である必要があります。絶対パス名については、使用するドライバのマニュアルを参照してください。ドライバ クラスは、データ ソースのデプロイ先のいずれかのサーバのクラスパスに含まれる必要があります。
MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCDriverParamsBean.DriverName
URL 接続先データベースの URL。URL の書式は、使用する JDBC ドライバによって異なります。
URL は、物理データベース接続を作成するために JDBC ドライバに渡されます。
MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCDriverParamsBean.Url
プロパティ 物理的なデータベース接続の作成で使用するために JDBC ドライバに渡される プロパティのリスト (たとえば、「server=dbserver1」の対)。「プロパティ=値」の 対は、それぞれ別の行に記述します。
ドライバ レベルの機能を有効にするには、ドライバ プロパティとその値を [プロパティ] リストに追加します。[プロパティ] リストにあるドライバ レベルの プロパティがドライバの ConnectionPoolDataSource オブジェクトに 設定されます。
- 注意 :
- セキュリティ上の理由で、WebLogic Server がプロダクション モードで 動作している場合は、このプロパティ リストにデータベース パスワードを指定 することはできません。プロパティ リストにパスワードが指定されていると、 データ ソースのデプロイメントが失敗します。このセキュリティ チェックを オーバーライドするには、サーバの起動時にコマンドライン引数 "weblogic.management.allowClearTextPasswords" を使用 します。
MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCDriverParamsBean.Properties
テスト対象のテーブル名 物理データベース接続のテスト時に使用するデータベース テーブルの名前。[テスト頻度] を指定し、[予約時に接続をテスト] を有効化した場合、この名前は必須になります。
接続のテストに使用されるデフォルトの SQL コードは次のとおりです。
select count(*) from TestTableName
ほとんどのデータベース サーバはこの SQL を最適化してテーブル スキャンを回避しますが、[テスト対象のテーブル名] を、行が少ない (またはまったくない) テーブルの名前に設定することも有益です。
[テスト対象のテーブル名] が「
SQL
」で始まる場合、「SQL」より後の文字列は、標準のクエリの代わりに接続をテストするリテラルの SQL ステートメントとして扱われます。MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCConnectionPoolParamsBean.TestTableName