管理コンソール・オンライン・ヘルプ

前 次 新規ウィンドウで目次を開く
ここから内容の開始

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

スコープ

関連タスク


先頭に戻る