このJDBCXAパラメータの表示
/management/weblogic/{version}/edit/JDBCSystemResources/{name}/JDBCResource/JDBCXAParams
このJDBCXAパラメータを表示します。
リクエスト
- name: string
コレクション内のインスタンスのnameプロパティ。
- version: string
WebLogic RESTインタフェースのバージョン。
- excludeFields(optional): string
excludeFields問合せパラメータは、レスポンスで返されるフィールドを制限するために使用します。これはフィールド名のカンマ区切りリストです。存在する場合は、名前がリストにないフィールドのみが返されます。存在しない場合は、すべてのフィールドが返されます(fields問合せパラメータが指定されている場合を除く)。ノート: excludeFieldsが指定されている場合、fieldsは指定できません。
- excludeLinks(optional): string
excludeLinks問合せパラメータは、レスポンスで返されるリンクを制限するために使用します。これはリンク関係名のカンマ区切りリストです。存在する場合は、関係名がリストにないリンクのみが返されます。存在しない場合は、すべてのリンクが返されます(links問合せパラメータが指定されている場合を除く)。ノート: excludeLinksが指定されている場合、linksは指定できません。
- fields(optional): string
fields問合せパラメータは、レスポンスで返されるフィールドを制限するために使用します。これはフィールド名のカンマ区切りリストです。存在する場合は、名前が一致するフィールドのみが返されます。存在しない場合は、すべてのフィールドが返されます(excludeFields問合せパラメータが指定されている場合を除く)。ノート: fieldsが指定されている場合、excludeFieldsは指定できません。
- links(optional): string
links問合せパラメータは、レスポンスで返されるリンクを制限するために使用します。これはリンク関係名のカンマ区切りリストです。存在する場合は、関係名が一致するリンクのみが返されます。存在しない場合は、すべてのリンクが返されます(excludeLinks問合せパラメータが指定されている場合を除く)。ノート: linksが指定されている場合、excludeLinksは指定できません。
レスポンス
- application/json
200レスポンス
このJDBCXAパラメータを返します。
object
- keepLogicalConnOpenOnRelease(optional): boolean
デフォルト値:
false
物理XA接続が接続プールに戻されるときに、WebLogic Serverが、グローバル・トランザクションに対して論理JDBC接続を開いたまま保持できるようにします。
データベース接続の作成に使用されるXAドライバまたはDBMSで、物理XA接続が接続プールに戻されてもトランザクション処理が継続している間は論理JDBC接続が開いたまま保持される必要がある場合に、このオプションを選択します。
これは、XAドライバを使用するデータ・ソースにのみ適用されます。
この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。
- keepXaConnTillTxComplete(optional): boolean
デフォルト値:
true
トランザクションが完了するまで、接続プールからの同じXAデータベース接続をグローバル・トランザクションに関連付けることができるようにします。
これは、XAドライバを使用する接続プールにのみ適用されます。
この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。
- needTxCtxOnClose(optional): boolean
デフォルト値:
false
様々なJDBCオブジェクト(結果セット、文、接続など)が閉じられたときに、XAドライバが分散トランザクション・コンテキストを要求するかどうかを指定します。これは、XAドライバを使用する接続プールにのみ適用されます。
有効化すると、JDBCオブジェクトを閉じるときにスローされるSQL例外のうち、トランザクション・コンテキストがないものが抑制されます。
この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。
- newXaConnForCommit(optional): boolean
デフォルト値:
false
専用のXA接続がグローバル・トランザクションのコミットおよびロールバック処理に使用されることを指定します。
これは、XAドライバを使用するデータ・ソースにのみ適用されます。
この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。
- recoverOnlyOnce(optional): boolean
デフォルト値:
false
トランザクション・マネージャがリソース上で回復処理を1回のみ呼び出すことを指定します。これは、XAドライバを使用するデータ・ソースにのみ適用されます。
この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。
- resourceHealthMonitoring(optional): boolean
デフォルト値:
true
XAデータ・ソースのJTAリソース・ヘルス監視を有効化します。有効化すると、MaxXACallMillisに指定した期間内にXAリソースがXA呼出しへの応答に失敗すると、データ・ソースに異常があるものとしてマークされ、リソースに対する以降の呼出しがすべてブロックされます。
このプロパティはXAデータ・ソースにのみ適用され、非XAドライバを使用するデータ・ソースでは無視されます。
- xaRetryDurationSeconds(optional): integer(int32)
デフォルト値:
0
トランザクション・マネージャがリソースに対して回復処理を実行する期間を秒数で指定します。値0を指定すると、再試行は行われません。
- xaRetryIntervalSeconds(optional): integer(int32)
デフォルト値:
60
XA再試行処理を行う秒間隔(XARetryDurationSecondsが正の値に設定されている場合)。
- xaSetTransactionTimeout(optional): boolean
デフォルト値:
false
WebLogic ServerがXaTransactionTimeoutの値に基づいてトランザクション・ブランチ・タイムアウトを設定できるようにします。
有効化すると、WebLogic Serverトランザクション・マネージャが
XAResource.start
の前にXAResource.setTransactionTimeout()
を呼び出して、XAトランザクション・タイムアウト値またはグローバル・トランザクション・タイムアウトのいずれかを渡します。トランザクション・ブランチ・タイムアウトは、XAリソースに対してデフォルトのタイムアウト値を超過して長時間実行されているトランザクションがある場合などに設定します。
ノート:この機能を使用するには、リソース・マネージャ(通常はJDBCドライバ)が
javax.transaction.xa.XAResource.setTransactionTimeout()
メソッドをサポートしている必要があります。 - xaTransactionTimeout(optional): integer(int32)
デフォルト値:
0
トランザクション・ブランチがタイムアウトするように設定する秒数。
設定すると、この値は、XAリソース・マネージャ(通常はJDBCドライバ)における
XAResource.setTransactionTimeout()
呼出しのトランザクション・タイムアウト値として渡されます。この値に
を設定すると、WebLogic Serverトランザクション・マネージャはグローバルWebLogic Serverトランザクション・タイムアウト(秒単位)をメソッドに渡します。
このプロパティを設定する場合には、グローバルWebLogic Serverトランザクション・タイムアウトと同じか、それよりも大きい値にする必要があります。
ノート:トランザクション・ブランチ・タイムアウトを設定できるようにするには、XaSetTransactionTimeoutを有効化する必要があります。