ジャンプ先

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

このJDBCデータ・ソース・パラメータの表示

get

/management/weblogic/{version}/edit/JDBCSystemResources/{name}/JDBCResource/JDBCDataSourceParams

このJDBCデータ・ソース・パラメータを表示します。

リクエスト

パス・パラメータ

• 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は指定できません。

セキュリティ

• 管理者: 基本
  タイプ: 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レスポンス

このJDBCデータ・ソース・パラメータを返します。

本文()

ルート・スキーマ: JDBC Data Source Params

タイプ: object

ソースを表示

• algorithmType(optional): string
  デフォルト値: Failover

  指定可能な値: [ "Load-Balancing", "Failover" ]

  マルチ・データ・ソースの接続リクエスト処理を決定するアルゴリズム。

  次のいずれかのタイプのアルゴリズムを指定できます。

  • フェイルオーバー

    接続リクエストはリストの最初のデータ・ソースに送信されます。リクエストが失敗した場合、リクエストはリストの次のデータ・ソースに送信されます。以降も同様です。有効な接続が取得されるか、あるいはリストの終わりに達するまで、この処理は繰り返されます。リストの終わりに達した場合には、例外がスローされます。

  • ロード・バランシング

    接続リクエストは、マルチ・データ・ソースによってメンバー・データ・ソースに均等に分散されます。このアルゴリズムを指定すると、マルチ・データ・ソースはフェイルオーバー処理も提供します。つまり、リクエストが失敗すると、そのリクエストは、有効な接続が取得されるか、あるいはリストの終わりに達するまで、マルチ・データ・ソースによってリストの次のデータ・ソースに送信されます。リストの終わりに達した場合には、例外がスローされます。

• connectionPoolFailoverCallbackHandler(optional): string
  デフォルト値: oracle.doceng.json.BetterJsonNull@57c4d037

  マルチ・データ・ソースがマルチ・データ・ソース内の別のデータ・ソースに接続リクエストをフェイルオーバーまたはフェイルバックする準備ができているときに、送られたコールバックを処理するアプリケーション・クラスの名前。

  この名前は、weblogic.jdbc.extensions.ConnectionPoolFailoverCallbackインタフェースを実装するアプリケーション・クラスの絶対名である必要があります。

• dataSourceList(optional): string
  デフォルト値: oracle.doceng.json.BetterJsonNull@1111d62f

  マルチ・データ・ソースが接続リクエストを送信するデータ・ソースのリスト。リスト内のデータ・ソースの順番でフェイルオーバーの順序が決まります。

• failoverRequestIfBusy(optional): boolean
  デフォルト値: false

  「フェイルオーバー」アルゴリズムのマルチ・データ・ソースに対して、現在のデータ・ソースのすべての接続が使用されている場合に、マルチ・データ・ソースが接続リクエストを次のデータ・ソースにフェイルオーバーできるようにします。

• globalTransactionsProtocol(optional): string
  デフォルト値: OnePhaseCommit

  指定可能な値: [ "TwoPhaseCommit", "LoggingLastResource", "EmulateTwoPhaseCommit", "OnePhaseCommit", "None" ]

  データ・ソースのトランザクション・プロトコル(グローバル・トランザクション処理動作)を決定します。オプションは次のとおりです:

  • TwoPhaseCommit: 標準XA トランザクション処理。XAドライバが必要です。

  • LoggingLastResource: 1つの非XAリソースに対するパフォーマンス強化。

  • EmulateTwoPhaseCommit: 1つの非XAリソースがグローバル・トランザクションに参加することを有効化します。ただし、データにリスクが発生することがあります。

  • OnePhaseCommit: 非XAドライバを使用した、1フェーズXAトランザクション処理。これがデフォルトの設定です。

  • None: ローカル・トランザクションのみサポートします。

• JNDINames(optional): array Items
  タイトル: Items

  このデータ・ソースのJNDIパス。デフォルトでは、JNDI名はデータ・ソースの名前です。

  JNDIパスを参照するアプリケーションは、このデータ・ソースに対応するjavax.sql.DataSourceインスタンスを取得します。

• keepConnAfterGlobalTx(optional): boolean
  デフォルト値: false

  WebLogic Serverがグローバル・トランザクションをコミットするときに、接続を解放するかわりに必要に応じて別の物理接続を取得することで、論理的接続に関連付けられている物理的なデータベース接続を保持できるようにします。

  このオプションをtrueに設定すると、データベースでの追加の接続の構成が必要となる場合があります。

  この設定を使用すると、JDBC XAドライバに関する特定の問題に対処できます。

• proxySwitchingCallback(optional): string
  デフォルト値: oracle.doceng.json.BetterJsonNull@fd43412

  Proxyデータ・ソースに対する切替えコールバック・クラスの名前。

  このクラスはweblogic.jdbc.extensions.DataSourceSwitchingCallbackインタフェースを実装する必要があります。

• proxySwitchingProperties(optional): string
  デフォルト値: oracle.doceng.json.BetterJsonNull@3e8c4396

  Proxyデータ・ソースに対する切替えコールバック・メソッドに渡される切替えプロパティを指定します。

• scope(optional): string
  デフォルト値: Global

  指定可能な値: [ "Global", "Application" ]

  データ・ソースの範囲を指定します。

  次のスコープのいずれかを指定できます。

  • Global

    指定されたJNDINameでデータ・ソースがクラスタワイドのJNDIツリーにバインドされることが指定され、クラスタ全体の任意のJDBCクライアントでデータ・ソースを使用できます。

    これがデフォルトの設定です。

  • Application

    指定されたJNDINameでデータ・ソースがアプリケーションのローカル・ネームスペースにバインドされることが指定され、アプリケーション内のJDBCクライアントでのみデータ・ソースを使用できます。これはパッケージ化されたデータソースに対してのみ使用でき、JDBCシステム・リソースについては無視されます。

{
    "type":"object",
    "properties":{
        "JNDINames":{
            "title":"Items",
            "type":"array",
            "items":{
                "type":"string",
                "description":""
            },
            "description":"<p>The JNDI path for this Data Source. By default, the JNDI name is the name of the data source.</p><p>Applications that look up the JNDI path get a <code>javax.sql.DataSource</code> instance that corresponds to this data source. </p>"
        },
        "algorithmType":{
            "default":"Failover",
            "enum":[
                "Load-Balancing",
                "Failover"
            ],
            "type":"string",
            "description":"<p>The algorithm determines the connection request processing for the multi data source.</p><p>You can specify one of the following algorithm types:</p><ul><li><p><b>Failover</b></p><p>Connection requests are sent to the first data source in the list; if the request fails, the request is sent to the next data source in the list, and so forth. The process is repeated until a valid connection is obtained, or until the end of the list is reached, in which case an exception is thrown.</p></li><li><p><b>Load balancing</b></p><p>The multi data source distributes connection requests evenly to its member data sources. With this algorithm, the multi data source also provides failover processing. That is, if a request fails, the multi data source sends the request to the next data source in the list until a valid connection is obtained, or until the end of the list is reached, in which case an exception is thrown.</p></li></ul>"
        },
        "connectionPoolFailoverCallbackHandler":{
            "default":null,
            "type":"string",
            "description":"<p>The name of the application class to handle the callback sent when a multi data source is ready to failover or fail back connection requests to another data source within the multi data source.</p><p>The name must be the absolute name of an application class that implements the <code>weblogic.jdbc.extensions.ConnectionPoolFailoverCallback</code> interface.</p>"
        },
        "dataSourceList":{
            "default":null,
            "type":"string",
            "description":"<p>The list of data sources to which the multi data source will route connection requests. The order of data sources in the list determines the failover order.</p>"
        },
        "failoverRequestIfBusy":{
            "default":false,
            "type":"boolean",
            "description":"<p>For multi data sources with the <code>failover</code> algorithm, enables the multi data source to failover connection requests to the next data source if all connections in the current data source are in use.</p>"
        },
        "globalTransactionsProtocol":{
            "default":"OnePhaseCommit",
            "enum":[
                "TwoPhaseCommit",
                "LoggingLastResource",
                "EmulateTwoPhaseCommit",
                "OnePhaseCommit",
                "None"
            ],
            "type":"string",
            "description":"<p>Determines the transaction protocol (global transaction processing behavior) for the data source. Options include:</p><ul><li><p>TwoPhaseCommit - Standard XA transaction processing. Requires an XA driver.</p></li><li><p>LoggingLastResource - A performance enhancement for one non-XA resource.</p></li><li><p>EmulateTwoPhaseCommit - Enables one non-XA resource to participate in a global transaction, but has some risk to data.</p></li><li><p>OnePhaseCommit - One-phase XA transaction processing using a non-XA driver. This is the default setting.</p></li><li><p>None - Support for local transactions only.</p></li></ul>"
        },
        "keepConnAfterGlobalTx":{
            "default":false,
            "type":"boolean",
            "description":"<p>Enables WebLogic Server to keep the physical database connection associated with the logical connection when committing a global transaction instead releasing it and getting another physical connection when needed.</p><p>Setting this option to true may require additional connections to be configured on the database.</p><p>Use this setting to work around specific problems with JDBC XA drivers.</p>"
        },
        "proxySwitchingCallback":{
            "default":null,
            "type":"string",
            "description":"<p>The name of the switching callback class for a Proxy data source.</p><p>This class implements the <code>weblogic.jdbc.extensions.DataSourceSwitchingCallback</code> interface.</p>"
        },
        "proxySwitchingProperties":{
            "default":null,
            "type":"string",
            "description":"<p>Specifies the switching properties passed to the switching callback method for a Proxy data source.</p>"
        },
        "scope":{
            "default":"Global",
            "enum":[
                "Global",
                "Application"
            ],
            "type":"string",
            "description":"<p>Specifies the scoping of the data source.</p><p>You can specify one of the following scopes:</p><ul><li><p><b>Global</b></p><p>Specifies that the data source is bound in the cluster-wide JNDI tree with the JNDIName specified so that the data source is available for use to any JDBC client across the cluster.</p><p>This is the default setting.</p></li><li><p><b>Application</b></p><p>Specifies that the data source is bound in the application's local namespace with the JNDIName specified so that the data source is available for use only by JDBC clients within the application.  This can only be used for packaged datasources and is ignored for JDBC System resources.</p></li></ul>"
        }
    },
    "description":""
}

ネストされたスキーマ: Items

タイプ: array

タイトル: Items

このデータ・ソースのJNDIパス。デフォルトでは、JNDI名はデータ・ソースの名前です。

JNDIパスを参照するアプリケーションは、このデータ・ソースに対応するjavax.sql.DataSourceインスタンスを取得します。

ソースを表示

• 配列: string

{
    "title":"Items",
    "type":"array",
    "items":{
        "type":"string",
        "description":""
    },
    "description":"<p>The JNDI path for this Data Source. By default, the JNDI name is the name of the data source.</p><p>Applications that look up the JNDI path get a <code>javax.sql.DataSource</code> instance that corresponds to this data source. </p>"
}

トップに戻る