ジャンプ先

• リクエスト
• レスポンス

このJDBCXAパラメータの表示

get

/management/weblogic/{version}/serverConfig/partitions/{name}/resourceGroups/{name}/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'を指定しないでください。

セキュリティ

• Admin: basic
  型: Basic

  説明: A user in the Admin security role.
• デプロイヤ: 基本
  型: Basic

  説明: A user in the Deployer security role.
• モニター: 基本
  型: Basic

  説明: A user in the Monitor security role.
• オペレータ: 基本
  型: Basic

  説明: A user in the Operator security role.

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json

200レスポンス

このJDBCXAパラメータを返します。

本文()

ルート・スキーマ: 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

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

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

• xaRetryDurationSeconds(optional): integer(int32)
  デフォルト値: 0

  トランザクション・マネージャがリソース上で復元操作を実行する際の持続時間を秒単位で決定します。値をゼロに指定すると、再試行は実行されません。

• xaRetryIntervalSeconds(optional): integer(int32)
  デフォルト値: 60

  XARetryDurationSecondsが正の値に指定される場合のXA再試行操作間の秒数。

• 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を有効化する必要があります。

{
    "type":"object",
    "properties":{
        "keepLogicalConnOpenOnRelease":{
            "default":false,
            "type":"boolean",
            "description":"<p>Enables WebLogic Server to keep the logical JDBC connection open for a global transaction when the physical XA connection is returned to the connection pool. </p><p>Select this option if the XA driver used to create database connections or the DBMS requires that a logical JDBC connection be kept open while transaction processing continues (although the physical XA connection can be returned to the connection pool).</p><p>Only applies to data sources that use an XA driver.</p><p>Use this setting to work around specific problems with JDBC XA drivers.</p>"
        },
        "keepXaConnTillTxComplete":{
            "default":true,
            "type":"boolean",
            "description":"<p>Enables WebLogic Server to associate the same XA database connection from the connection pool with a global transaction until the transaction completes.</p><p>Only applies to connection pools that use an XA driver.</p><p>Use this setting to work around specific problems with JDBC XA drivers.</p>"
        },
        "needTxCtxOnClose":{
            "default":false,
            "type":"boolean",
            "description":"<p>Specifies whether the XA driver requires a distributed transaction context when closing various JDBC objects (result sets, statements, connections, and so forth). Only applies to connection pools that use an XA driver.</p><p>When enabled, SQL exceptions that are thrown while closing the JDBC objects without a transaction context will be suppressed.</p><p>Use this setting to work around specific problems with JDBC XA drivers.</p>"
        },
        "newXaConnForCommit":{
            "default":false,
            "type":"boolean",
            "description":"<p>Specifies that a dedicated XA connection is used for commit and rollback processing for a global transaction.</p><p>Only applies to data sources that use an XA driver.</p><p>Use this setting to work around specific problems with JDBC XA drivers.</p>"
        },
        "recoverOnlyOnce":{
            "default":false,
            "type":"boolean",
            "description":"<p>Specifies that the transaction manager calls recover on the resource only once. Only applies to data sources that use an XA driver.</p><p>Use this setting to work around specific problems with JDBC XA drivers.</p>"
        },
        "resourceHealthMonitoring":{
            "default":true,
            "type":"boolean",
            "description":"<p>Enables JTA resource health monitoring for an XA data source.  When enabled, if an XA resource fails to respond to an XA call within the period specified in MaxXACallMillis, WebLogic Server  marks the data source as unhealthy and blocks any further calls to the resource.</p><p> This property applies to XA data sources only, and is ignored for data sources that use a non-XA driver.</p>"
        },
        "xaRetryDurationSeconds":{
            "default":0,
            "type":"integer",
            "format":"int32",
            "description":"<p>Determines the duration in seconds for which the transaction manager will perform recover operations on the resource.  A value of zero indicates that no retries will be performed.</p>"
        },
        "xaRetryIntervalSeconds":{
            "default":60,
            "type":"integer",
            "format":"int32",
            "description":"<p>The number of seconds between XA retry operations if XARetryDurationSeconds is set to a positive value.</p>"
        },
        "xaSetTransactionTimeout":{
            "default":false,
            "type":"boolean",
            "description":"<p>Enables WebLogic Server to set a transaction branch timeout based on the value for XaTransactionTimeout.</p><p>When enabled, the WebLogic Server Transaction Manager calls <code>XAResource.setTransactionTimeout()</code> before calling <code>XAResource.start</code>, and passes either the XA Transaction Timeout value or the global transaction timeout. </p><p>You may want to set a transaction branch timeout if you have long-running transactions that exceed the default timeout value on the XA resource.</p><p><b>Note:</b> To use this feature, the resource manager (typically, the JDBC driver) must support the <code>javax.transaction.xa.XAResource.setTransactionTimeout()</code> method. </p>"
        },
        "xaTransactionTimeout":{
            "default":0,
            "type":"integer",
            "format":"int32",
            "description":"<p>The number of seconds to set as the transaction branch timeout.</p><p>If set, this value is passed as the transaction timeout value in the <code>XAResource.setTransactionTimeout()</code> call on the XA resource manager, typically the JDBC driver. </p><p>When this value is set to <code></code>, the WebLogic Server Transaction Manager passes the global WebLogic Server transaction timeout in seconds in the method.</p><p>If set, this value should be greater than or equal to the global WebLogic Server transaction timeout.</p><p><b>Note:</b> You must enable XaSetTransactionTimeout to enable setting the transaction branch timeout.</p>"
        }
    },
    "description":""
}

先頭に戻る