Administration Console オンライン ヘルプ

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

JDBC データ ソース : コンフィグレーション : トランザクション

コンフィグレーション オプション     関連タスク     関連トピック

JDBC データ ソースのトランザクション プロトコルは、データ ソースからの接続が、トランザクション処理中にどのように扱われるかを決定します。JDBC データ ソースのトランザクションはグローバル (XA) および非グローバル (ローカル) のいずれかです。

このページでは、この JDBC データ ソースのトランザクション オプションを定義します。

コンフィグレーション オプション

名前 説明
グローバル トランザクションのサポート

データ ソースからの非 XA 接続がグローバル トランザクションに参加できるように するには、このオプションを選択します。

アプリケーションにグローバル トランザクションが含まれる場合の多くでは、データベース 接続の作成に XA JDBC ドライバを使用する必要があります。 EJB 使用時は、このオプションを有効化する必要があります。非 XA JDBC ドライバ使用時にグローバル トランザクションのサポートを有効化 した場合、トランザクション処理のオプションを選択する必要があります。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCDataSourceParamsBean.GlobalTransactionsProtocol

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

ロギング ラスト リソース

ロギング ラスト リソース (LLR) トランザクションの最適化を使用して 非 XA JDBC 接続が分散トランザクションに参加できるようにします。[2 フェーズ コミットのエミュレート] の代わりに使用することをお勧めします。

このオプションを選択した場合、接続が使用されるトランザクション ブランチは、 トランザクション内の最後のリソースとして処理され、1 フェーズ コミット 操作として処理されます。操作の結果がリソース自身のログ ファイルに 書き込まれ、この結果から、トランザクションの準備フェーズが成功した のか、失敗したのかを判断できます。このオプションはパフォーマンス面で 優れており、2 フェーズ コミットをエミュレートする場合に比べてデータの 安全性に優れています。

2 フェーズ コミットのエミュレート

JTA を使用して非 XA JDBC 接続が分散トランザクションへの参加を エミュレートできるようにします。このオプションは、ヒューリスティックな状況に耐えられる アプリケーションでのみ使用してください。

このオプションを選択した場合、接続が使用されるトランザクション ブランチは、 トランザクションの準備フェーズの結果として常に「成功」を返します。 このオプションはパフォーマンス面で優れていますが、データに障害が 発生する可能性があります。

1 フェーズ コミット

1 フェーズ コミット トランザクション処理を使用して非 XA JDBC 接続が 分散トランザクションに参加できるようにします。このオプションを 有効化すると、他のリソースはグローバル トランザクションに 参加できません。

XA データソース インタフェースを使用

WebLogic Server で JDBC ドライバの XA インタフェースが使用されることを指定します。

データベース接続の作成に使用される JDBC ドライバ クラスが JDBC ドライバの XA バージョンと非 XA バージョンの両方を実装している場合、この属性を設定すると、JDBC ドライバが XA ドライバまたは非 XA ドライバとして扱われるよう指定できます。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCDriverParamsBean.UseXaDataSourceInterface

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

XA トランザクション タイムアウトの設定

WebLogic Server が XaTransactionTimeout の値に基づいてトランザクション ブランチ タイムアウトを設定できるようにします。

有効化すると、WebLogic Server トランザクション マネージャが XAResource.start の前に XAResource.setTransactionTimeout() を呼び出して、XA トランザクション タイムアウト値またはグローバル トランザクション タイムアウトのいずれかを渡します。

トランザクション ブランチ タイムアウトは、XA リソースに対してデフォルトのタイムアウト値を超過して長時間実行されているトランザクションがある場合などに設定します。

注意 : この機能を使用するには、リソース マネージャ (通常は JDBC ドライバ) が javax.transaction.xa.XAResource.setTransactionTimeout() メソッドをサポートしている必要があります。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.XaSetTransactionTimeout

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

XA トランザクション タイムアウト

トランザクション ブランチがタイムアウトするように設定する秒数。

設定すると、この値は、XA リソース マネージャ (通常は JDBC ドライバ) における XAResource.setTransactionTimeout() 呼び出しのトランザクション タイムアウト値として渡されます。

この値に 0 を設定すると、WebLogic Server トランザクション マネージャはグローバル WebLogic Server トランザクション タイムアウト (秒単位) をメソッドに渡します。

このプロパティを設定する場合には、グローバル WebLogic Server トランザクション タイムアウトと同じか、それよりも大きい値にする必要があります。

注意 : トランザクション ブランチ タイムアウトを設定できるようにするには、XaSetTransactionTimeout を有効化する必要があります。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.XaTransactionTimeout

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

XA 再試行期間

トランザクション マネージャがリソースに対して回復処理を実行する期間を秒数で指定します。値 0 を指定すると、再試行は行われません。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.XaRetryDurationSeconds

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

XA 再試行間隔

XA 再試行処理を行う秒間隔 (XARetryDurationSeconds が正の値に設定されている場合)。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.XaRetryIntervalSeconds

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

トランザクション完了まで XA 接続を保持

トランザクションが完了するまで、接続プールからの同じ XA データベース接続をグローバル トランザクションに関連付けることができるようにします。

これは、XA ドライバを使用する接続プールにのみ適用されます。

この設定は、JDBC XA ドライバに関する特定の問題を回避するために使用します。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.KeepXaConnTillTxComplete

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

クローズ時にトランザクション コンテキストが必要

さまざまな JDBC オブジェクト (結果セット、ステートメント、接続など) が閉じられたときに、XA ドライバが分散トランザクション コンテキストを要求するかどうかを指定します。これは、XA ドライバを使用する接続プールにのみ適用されます。

有効化すると、JDBC オブジェクトを閉じるときに送出される SQL 例外のうち、トランザクション コンテキストがないものが抑制されます。

この設定は、JDBC XA ドライバに関する特定の問題を回避するために使用します。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.NeedTxCtxOnClose

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

コミット専用に新しい XA 接続を使用

グローバル トランザクションのコミット処理またはロールバック処理で、専用の XA 接続が使用されることを指定します。

これは、XA ドライバを使用するデータ ソースにのみ適用されます。

この設定は、JDBC XA ドライバに関する特定の問題を回避するために使用します。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.NewXaConnForCommit

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

XA を 1 回だけ終了

保留中のそれぞれの XAResource.start() で、XAResource.end() が 1 回だけ呼び出されることを指定します。

このオプションによって、XA ドライバが XAResource.end(TMSUSPEND)XAResource.end(TMSUCCESS) を連続して呼び出すことができなくなります。これは、XA ドライバを使用するデータ ソースにのみ適用されます。

この設定は、JDBC XA ドライバに関する特定の問題を回避するために使用します。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.XaEndOnlyOnce

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

解放時に接続を開いたまま保持

物理 XA 接続が接続プールに戻されるときに、WebLogic Server が、グローバル トランザクションに対して論理 JDBC 接続を開いたまま保持できるようにします。

データベース接続の作成に使用される XA ドライバまたは DBMS で、物理 XA 接続が接続プールに返されてもトランザクション処理が継続している間は論理 JDBC 接続が開いたまま保持される必要がある場合に、このオプションを選択します。

これは、XA ドライバを使用するデータ ソースにのみ適用されます。

この設定は、JDBC XA ドライバに関する特定の問題を回避するために使用します。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.KeepLogicalConnOpenOnRelease

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

リソース ヘルス モニタ

XA データ ソースの JTA リソース ヘルス モニタを有効化します。有効化すると、MaxXACallMillis に指定した期間内に XA リソースが XA 呼び出しへの応答に失敗すると、データ ソースに異常があるものとしてマークされ、リソースに対する以降の呼び出しがすべてブロックされます。

このプロパティは XA データ ソースにのみ適用され、非 XA ドライバを使用するデータ ソースでは無視されます。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.ResourceHealthMonitoring

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

1 回だけ回復

トランザクション マネージャがリソース上で回復処理を 1 回のみ呼び出すことを指定します。これは、XA ドライバを使用するデータ ソースにのみ適用されます。

この設定は、JDBC XA ドライバに関する特定の問題を回避するために使用します。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.RecoverOnlyOnce

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

接続が閉じたときにローカル トランザクションをロールバック

接続が接続プールに戻される前に、WebLogic Server が接続に対して rollback() を呼び出すことができるようにします。

ロールバック呼び出しではデータベース サーバと通信する必要があるため、この属性を有効にするとパフォーマンスに影響が出ます。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCXAParamsBean.RollbackLocalTxUponConnClose

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

XA デバッグ レベル

XA ドライバの JDBC デバッグのレベルを指定します。

MBean 属性 (アプリケーション モジュールには適用しない) :
JDBCConnectionPoolParamsBean.JDBCXADebugLevel

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

関連タスク

関連トピック

 

Skip navigation bar ページの先頭