JDBC GridLinkデータ・ソースの作成
このページでは、JDBC GridLinkデータ・ソースを作成します。JDBC GridLinkデータ・ソースは、JDBC接続のプールを介したデータベース接続を提供するJNDIツリーにバインドされたオブジェクトです。アプリケーションからJNDIツリーのデータ・ソースをルックアップして、データ・ソースからのデータベース接続を予約できます。
構成オプション
名前 説明 名前 WebLogicドメイン内のこのデータ・ソースを識別する一意な名前。
MBean属性(アプリケーション・モジュールには適用しない):
JDBCDataSourceBean.Name
JNDI名 このデータ・ソースのバインド先のJNDIパス。デフォルトでは、JNDI名はデータ・ソースの名前です。
データ・ソースに複数のJNDI名を指定するには、各JNDI名を個別の行に入力します。
JNDIパスをルックアップするアプリケーションは、このデータ・ソースに対応する
javax.sql.DataSource
インスタンスを取得します。MBean属性(アプリケーション・モジュールには適用しない):
JDBCDataSourceParamsBean.JNDINames
データベース・ドライバ 物理データベース接続の作成に使用するドライバを選択してください。データ・ソースにデータベース接続がプールされ、アプリケーションで使用および再使用されます。
*はドライバがOracle WebLogic Serverに明示的にサポートされていることを示します。
データベースのタイプ データベースのデータベース管理システムを選択してください。管理コンソールにより、選択したDBMSに合わせて既存のJDBCドライバのリストが調整され、DBMSでサポートされているフォーマットで接続プロパティが構築されます。
データベース名 接続先のデータベースの名前を入力します。
サービス名 接続先のデータベースのサービス名を入力します。
ホスト名 データベース・サーバーの名前またはIPアドレスを入力します。
ポート データベース・サーバーが接続リクエストをリスニングするポート番号を入力します。
データベース・ユーザー名 データベース接続の作成に使用するデータベース・ユーザー名を入力します。
ドライバ・クラス名 データ・ソースの接続プールでの物理データベース接続の作成に使用するJDBCドライバ・クラスの完全パッケージ名。
たとえば:
oracle.jdbc.OracleDriver
ドライバは、
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文として扱われます。たとえば:SQL BEGIN; Null; END;
Oracleデータベースの場合、「テスト対象の表名」を
SQL PINGDATABASE
に設定すると、pingDatabase()
メソッドを使用してOracle接続のテストが実行されるため、接続テストのオーバーヘッドを減らすことができます。JDBC 4.0データベースでは、SQL ISVALIDを使用して、接続にisValid ()
メソッドを使用できます。MBean属性(アプリケーション・モジュールには適用しない):
JDBCConnectionPoolParamsBean.TestTableName
スコープ