ルート・スキーマ: 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インスタンスを取得します。
{
"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>"
}