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

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

JDBCストア: 構成

構成オプション     関連タスク     関連トピック

このページでは、永続的なJMSメッセージやストア・アンド・フォワード・メッセージなどのサブシステム・データを格納するための、JDBC対応のストアを構成します。

構成オプション

名前 説明
名前

このJDBCストアの名前。この名前は、WebLogicドメイン内で一意である必要があります。

MBean属性:
JDBCStoreMBean.Name

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

ターゲット

ファイル・ストア、JDBCストアまたはレプリケートされたストアをホストするための候補となる、現在のドメインに定義済のサーバー・インスタンス、クラスタまたは移行可能ターゲット。リソース・グループまたはリソース・グループ・テンプレートにスコープ指定する場合は、仮想ターゲットからターゲットを継承します。

クラスタを選択する場合、JMSサーバーと同じクラスタを指定する必要があります。移行可能なターゲットを選択する場合、移行可能なJMSサーバーまたはSAFエージェントと同じ移行可能なターゲットを指定する必要があります。ベスト・プラクティスは、パス・サービスが独自のカスタム・ストアを使用し、ストアとして同じターゲットを共有することです。

MBean属性:
PersistentStoreMBean.Targets

スコープ

このJDBCストアに、ドメイン、パーティションまたはリソース・グループ・テンプレート内からアクセス可能にするかどうかを指定します。

データ・ソース

このJDBCストアがそのバッキング表にアクセスするために使用するJDBCデータ・ソース。XA JDBCドライバを使用するように構成された、またはグローバル・トランザクションをサポートするように構成されたJDBCデータ・ソースを使用するようにJDBCストアを構成することはできません。

MBean属性:
JDBCStoreMBean.DataSource

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

接頭辞名

JDBCストアのデータベース表(WLStore)の接頭辞。次のフォーマットで指定します。[[[catalog.]schema.]prefix]

[[catalog.]schema.]prefixフォーマット内の各ピリオド記号は重要です。schemaは一般的に多くのデータベースのユーザー名に対応します。接頭辞が指定されていない場合、JDBCストアの表名は単にWLStoreとなり、データベースではJDBC接続のユーザーに基づいて暗黙的にスキーマが決定されます。JDBC WLStore表名の接頭辞は常に構成するのがベスト・プラクティスです。

JDBCストアの接頭辞の使用に関する具体的なガイドラインについては、WebLogic Server環境の構成の「WebLogicストアの使用方法」の項を参照してください。

MBean属性:
GenericJDBCStoreMBean.PrefixName

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

論理名

同一の名前を使用する別々のサーバー上にある別々のストアを参照するための、サブシステムで使用する名前。

たとえば、タイマー・サービスを使用するEJBが、論理名を使用してストアを参照するとします。この論理名は、各サーバーに物理名の異なるストアがあったとしても、同じクラスタの複数のサーバーにおいて有効であると考えられます。

同じドメインまたは同じクラスタ内の複数のストアが、同じ論理名を共有できます。ただし、ある特定の論理名を、同じサーバー上の複数のストアに割り当てることはできません。

MBean属性:
PersistentStoreMBean.LogicalName

DDLファイルからの表の作成

JDBCストアのバッキング表の作成に使用されるデータ定義言語(Data Definition Language:DDL)ファイルを指定します。

  • このフィールドは、JDBCストアのバッキング表WLStoreがすでに存在する場合は無視されます。

  • DDLファイルが指定されていない場合に、バッキング表が存在しないことがJDBCストアによって検出されると、JDBCストアでは、データベース・ベンダーに固有のあらかじめ構成されたDDLファイルを実行して、自動的に表を作成します。あらかじめ構成されたこれらのファイルは、MIDDLEWARE_HOME\modules\com.bea.core.store.jdbc_x.x.x.x.jarファイルのweblogic\store\io\jdbc\ddlディレクトリにあります。

  • DDLファイルが指定されている場合に、バッキング表が存在しないことがJDBCストアによって検出されると、JDBCストアは、まずファイル・パス内のDDLファイルを検索し、見つからない場合は、CLASSPATH内でファイルを検索します。ファイルがみつかった時点で、そのDDLファイル内のSQLが実行されてJDBCストアのデータベース表が作成されます。DDLファイルがみつからず、バッキング表が存在していない場合、JDBCストアは起動に失敗します。

MBean属性:
GenericJDBCStoreMBean.CreateTableDDLFile

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

各バッチの最大削除数

各データベース呼出しで削除される表行の最大数。

  • 可能な場合、JDBCストアはJDBC 3.0バッチ処理を使用してクライアントの同時リクエストをバッチ処理します。

  • 同時挿入および同時書込みの最大バッチ・サイズを構成できます。

  • JDBC 3.0バッチ処理を無効化するには、最大バッチ・サイズを1に設定します。

  • 最大バッチ・サイズは、クライアントの同時リクエストの最大数には影響しません。

MBean属性:
JDBCStoreMBean.DeletesPerBatchMaximum

最小値: 1

最大値: 100

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

各バッチの最大挿入数

各データベース呼出しで挿入される表行の最大数。

  • 可能な場合、JDBCストアはJDBC 3.0バッチ処理を使用してクライアントの同時リクエストをバッチ処理します。

  • 同時挿入および同時書込みの最大バッチ・サイズを構成できます。

  • JDBC 3.0バッチ処理を無効化するには、最大バッチ・サイズを1に設定します。

  • 最大バッチ・サイズは、クライアントの同時リクエストの最大数には影響しません。

MBean属性:
JDBCStoreMBean.InsertsPerBatchMaximum

最小値: 1

最大値: 100

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

各文の最大削除数

各データベース呼出しで削除される表行の最大数。

  • JDBCストアでクライアントの同時リクエストをバッチ処理するためにJDBC 3.0バッチ処理を使用しない場合にのみ適用されます。

  • 文ごとの最大削除数は、クライアントの同時リクエストの最大数には影響しません。

  • データベースによっては、構成した値よりも低い値がJDBCストアによって選択される場合があります。

MBean属性:
JDBCStoreMBean.DeletesPerStatementMaximum

最小値: 1

最大値: 100

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

ワーカー数

ワーカー負荷を処理するJDBCストア・ワーカー・スレッドの数。

  • 1という値は、単一スレッドが使用されることを示しています(デフォルト)。

  • 1より大きな値は、複数のスレッドが使用されることを示しています。

  • Oracleデータベースでは、ワーカー数が1より大きい場合に、JDBCストア表用に主キー索引を逆索引に再作成することをお薦めします。

  • Oracle以外のデータベースの場合の索引作成については、データベース提供元のドキュメントを参照してください。

MBean属性:
JDBCStoreMBean.WorkerCount

最小値: 1

最大値: 1000

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

ワーカー優先バッチ・サイズ

「ワーカー数」属性が1より大きい値に構成されている場合のバッチ・サイズを指定します。

各ワーカー・スレッドにJDBCストアが増分として割り当てるワークロードを構成するために使用します。ワークロードは、各JDBCワーカー・スレッドで処理するためにグループ化されてプッシュされるIOリクエストで構成されています。IOリクエストが非常に大きい(たとえば1M)場合、この属性をより小さい値に調整してください。

MBean属性:
JDBCStoreMBean.WorkerPreferredBatchSize

最小値: 1

最大値: 2147483647

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

3ステップのしきい値

JDBCストアが1つのステップ(挿入)ではなく3つのステップ(挿入、選択、移入)を使用してOracle Blobデータ型に移入する場合は、しきい値をバイト単位で指定します。

レコード・データ用にデフォルトのLong Rawデータ型ではなく、Blobデータ型が使用される場合に、Oracleデータベースのみに適用されます。

デフォルト値は200000です。

MBean属性:
JDBCStoreMBean.ThreeStepThreshold

最小値: 4000

最大値: 2147483647

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

Oracle Piggybackコミットの有効化

データベース・サーバーに対して個別のコミット呼出しを発行するかわりに、トランザクションの最後の操作でINSERTまたはDELETE操作のバッチをコミットでき、サーバーのラウンド・トリップをセーブします。この機能は、少ない操作数または小さいメッセージのトランザクションが多いアプリケーションにメリットがあります。この機能は、Oracle Exalogic環境でJDBCストアを構成している場合にのみ使用する必要があります。

MBean属性:
JDBCStoreMBean.OraclePiggybackCommitEnabled

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

接続キャッシュ・ポリシー

接続キャッシュ・ポリシー設定は、JDBCストアによってキャッシュされるJDBC接続数を制御します。接続キャッシュ・ポリシーを「なし」に変更する前に、ストアの管理ガイドを参照することを強くお薦めします。

MBean属性:
JDBCStoreMBean.ConnectionCachingPolicy

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

関連タスク

関連トピック


先頭に戻る