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