DBMS_APP

18 DBMS_APP_CONT

DBMS_APP_CONTパッケージは、使用できなくなったセッションの実行中のトランザクションがコミットされたかどうか、およびそのセッションに対する最後のコールが完了したかどうかを判断できるインタフェースを提供します。

参照:

アプリケーション・コンティニュイティとトランザクション・ガードの説明およびこれら2つの機能の関連性については、『Oracle Database開発ガイド』を参照してください。

トランザクション・ガードの使用

この章のトピックは、次のとおりです:

18.1 DBMS_APP_CONTの概要

DBMS_APP_CONTパッケージを使用して、この例の問題を解決できます。

問題の詳細

停止後にアプリケーションをリカバリする際の根本的問題の1つは、クライアントに返送されたコミット・メッセージに継続性がないことです。クライアントとサーバー間に間隔がある場合、クライアントには通信の失敗というエラー・メッセージが示されます。このエラーでは次のことがアプリケーションに知らされません。すなわち、送信によってコミット操作が実行されたかどうか、もしくは、プロシージャ・コールが予定されたすべてのコミットおよびセッション状態変更を行って完了まで実行されたか、一部の動作は失敗したか、またはクライアントから切断したまま現在も実行中というさらに悪い状態になっているかということです。

GET_LTXID_OUTCOME

GET_LTXID_OUTCOMEプロシージャの目的は、使用できなくなったセッションの実行中のトランザクションが完了したかどうかを判断することです。元のセッションが使用できなくなったためにエラーが戻されるときに使用されます。セッションが使用できなくなる理由として、セッション、インスタンス、サーバー、ネットワークの障害や、計画済停止または計画外停止があげられます。このような停止が発生すると、アプリケーションは切断エラーを受信します。しかし、このエラーでは、トランザクションがコミットされたかどうかを示す情報が提供されません。また、アプリケーションの復旧後に、どんなコミット結果が期待されているかも示されていません。

参照:

論理トランザクションIDについては、『Oracle Database概要』を参照してください。

18.2 DBMS_APP_CONTのセキュリティ・モデル

アプリケーションでは、DBMS_APP_CONTパッケージのEXECUTE権限が必要です。

この権限を付与するには、データベース管理者が次のSQL文を実行する必要があります。

GRANT execute on DBMS_APP_CONT to application user ;

18.3 DBMS_APP_CONTサブプログラムの要約

DBMS_APP_CONTパッケージには、GET_LTXID_OUTCOMEプロシージャが含まれています。

表18-1 DBMS_APP_CONTパッケージのサブプログラム

サブプログラム	説明
GET_LTXID_OUTCOMEプロシージャ	セッションが使用できなくなったときに、カスタマ・アプリケーションとサード・パーティ・アプリケーションで最後のセッションのトランザクション・ステータスを確認できるようにします。

18.3.1 GET_LTXID_OUTCOMEプロシージャ

このプロシージャは、セッションが使用できなくなったときに、カスタマ・アプリケーションとサード・パーティ・アプリケーションで最後のセッションのトランザクション・ステータスを確認できるようにします。

構文

DBMS_APP_CONT.GET_LTXID_OUTCOME (
 client_ltxid          IN    RAW, 
 committed             OUT   BOOLEAN, 
 user_call_completed   OUT   BOOLEAN)

パラメータ

表18-2 GET_LTXID_OUTCOMEプロシージャのパラメータ

パラメータ	説明
`client_ltxid`	クライアント側の論理トランザクションID。前回失敗したセッションから`LTXID`を、クライアント・ドライバで提供されたAPI、すなわちJDBCの場合は`getLTXID`、`ODP`.`net`の場合は`LogicalTransactionId`、およびOCIの場合は`LTXID`と`OCI_ATTR_GET`を使用して取得します。
`committed`	指定した論理`LTXID`のトランザクションが`COMMITTED`の場合、`TRUE`を戻します。論理`LTXID`が`COMMITTED`でない場合、`FALSE`を戻します。`FALSE`が戻されるときに`LTXID`の使用がブロックされるため、前回実行していたトランザクションがこの`LTXID`でコミットされることはありません。
`user_call_completed`	すべての情報がクライアントに戻されたかどうか。このようなメッセージの例として、自動コミットまたはコミットを正常に使用できたときに処理された行数、PL/SQLコール時のパラメータとファンクションの結果、または`COMMIT`後の処理を記述するPL/SQLなどがあげられます。正常に機能するためにコミットの戻り値のデータを必要とするアプリケーションでは、この2番目のパラメータを参照してください。

例外

表18-3 GET_LTXID_OUTCOMEプロシージャの例外

例外	説明
`ORA-14950` - `SERVER_AHEAD`	サーバーの情報が最新であるため、トランザクションは古くてすでにコミットされたものです。アプリケーションから渡された`LTXID`は古く、そのセッションで最後に使用したものではないため、これはエラーです。`GET_LTXID_OUTCOME`の目的は、リカバリ可能な停止後にそのセッションの現在のトランザクションの結果を戻すことです。
`ORA-14951` - `CLIENT_AHEAD`	クライアントがサーバーより進んでいます。これは、サーバーがフラッシュバックされた場合やメディア・リカバリを使用してリカバリされた場合、またはデータ損失を伴いながらも早期にオープンされたスタンバイである場合に発生することがあります。
`ORA-14906` - `SAME_SESSION`	`LTXID`の所有セッションでの`GET_LTXID_OUTCOME`の実行はサポートされていません。リカバリ可能な停止後は、そのセッションにおける処理がブロックされるからです。
`ORA-14909` - `COMMIT_BLOCKED`	同じユーザー名を持つ別のユーザーによって`GET_LTXID_OUTCOME`を使用してセッションのコミットがブロックされています。`GET_LTXID_OUTCOME`は、非活動状態のセッションでのみコールしてください。アプリケーション管理者に確認してください。
`ORA-14952` - `ERROR`	結果を確認できません。処理中にエラーが発生しました。エラー・スタックにエラーの詳細が示されています。