12.6.2.5. データソースのパラメーター
| パラメーター | 説明 |
|---|---|
| jndi-name | データソースの一意の JNDI 名。 |
| pool-name | データソースの管理プール名。 |
| enabled | データソースが有効かどうかを指定します。 |
| use-java-context |
データソースをグローバルの JNDI にバインドするかどうかを指定します。
|
| spy |
JDBC レイヤーで
spy 機能を有効にします。この機能は、データソースへの JDBC トラフィックをすべてログに記録します。ロギングカテゴリーの jboss.jdbc.spy も logging サブシステムのログレベルである DEBUG に設定する必要があることに注意してください。
|
| use-ccm | キャッシュ接続マネージャーを有効にします。 |
| new-connection-sql | 接続プールに接続が追加された時に実行する SQL ステートメント。 |
| transaction-isolation |
次のいずれかになります。
|
| url-selector-strategy-class-name | インターフェイスを実装するクラスorg.jboss.jca.adapters.jdbc.URLSelectorStrategy。 |
| security |
セキュリティー設定である子要素が含まれています。表12.6「セキュリティーパラメーター」を参照してください。
|
| 検証 |
検証設定である子要素が含まれます。表12.7「検証パラメーター」を参照してください。
|
| timeout |
タイムアウト設定である子要素が含まれています。表12.8「タイムアウトパラメーター」を参照してください。
|
| statement |
ステートメント設定である子要素が含まれます。表12.9「ステートメントのパラメーター」を参照してください。
|
| パラメーター | Description |
|---|---|
| jta | XA 以外のデータソースの JTA 統合を有効にします。XA データソースには適用されません。 |
| connection-url | JDBC ドライバーの接続 URL。 |
| driver-class | JDBC ドライバークラスの完全修飾名。 |
| connection-property |
メソッドに渡される任意の接続プロパティー
Driver.connect(url,props)。各接続プロパティーは、文字列の名前と値のペアを指定します。プロパティー名は名前に由来し、値は要素の内容に由来します。
|
| pool |
プーリング設定である子要素が含まれます。表12.4「非 XA および XA データソースに共通のプールパラメーター」を参照してください。
|
| url-delimiter |
高可用性 (HA) クラスター化されたデータベースの connection-url にある URL の区切り文字。
|
| パラメーター | Description |
|---|---|
| xa-datasource-property |
実装クラス
XADataSource に割り当てるプロパティー。名前 = 値 で指定します。セッターメソッドが存在する場合は、次の形式でsetName、プロパティーは、次の形式で setter メソッドを呼び出すことによって設定されます。setName(value)。
|
| xa-datasource-class |
実装クラスの完全修飾名
javax.sql.XADataSource。
|
| driver |
JDBC ドライバーを含むクラ出力ダーモジュールへの一意の参照。受け入れられる形式は driverName # majorVersion です。minorVersion。
|
| xa-pool |
プーリング設定である子要素が含まれます。表12.4「非 XA および XA データソースに共通のプールパラメーター」 および 表12.5「XA プールパラメーター」 を参照してください。
|
| recovery |
リカバリ設定である子要素が含まれています。表12.10「リカバリーパラメーター」を参照してください。
|
| パラメーター | Description |
|---|---|
| min-pool-size | プールが保持する最小接続数 |
| max-pool-size | プールが保持可能な最大接続数 |
| prefill | 接続プールを事前に入力するかどうか。デフォルトは false です。 |
| use-strict-min | min-pool-size に達した後、アイドル接続スキャンがそれ以降の接続を閉じるためのマーキングを厳密に停止する必要があるかどうか。デフォルト値は false です。 |
| flush-strategy |
エラーが発生した場合にプールがフラッシュされるかどうか。有効な値は以下のとおりです。
デフォルトは
FailingConnectionOnly です。
|
| allow-multiple-users | 複数のユーザーが getConnection(user, password) メソッドを使いデータソースへアクセスするかどうか、および内部プールタイプがこの動作に対応するかを指定します。 |
| パラメーター | Description |
|---|---|
| is-same-rm-override | javax.transaction.xa.XAResource.isSameRM(XAResource) クラスが true または false を返すかどうか。 |
| interleaving | XA 接続ファクトリーのインターリービングを有効にするかどうかを指定します。 |
| no-tx-separate-pools |
コンテキストごとに個別のサブプールを作成するかどうか。これは、JTA トランザクションの内部と外部の両方で XA 接続を使用できない Oracle データソースに必要です。
このオプションを使用すると、実際のプールがつ作成されるため、合計プールサイズが
max-pool-size の倍になります。
|
| pad-xid | Xid のパディングを行うかどうかを指定します。 |
| wrap-xa-resource |
XAResource をラップするかどうか
org.jboss.tm.XAResourceWrapper実例。
|
| パラメーター | Description |
|---|---|
| user-name | 新規接続の作成に使うユーザー名 |
| password | 新規接続の作成に使うパスワード |
| security-domain | 認証処理を行う JAAS security-manager の名前を含みます。この名前は、JAAS ログイン設定の application-policy/name 属性に相関します。 |
| reauth-plugin | 物理接続の再認証に使う再認証プラグインを定義します。 |
| パラメーター | Description |
|---|---|
| valid-connection-checker |
インターフェイスの実装
org.jboss.jca.adaptors.jdbc.ValidConnectionCheckerこれはSQLException.isValidConnection(Connection e)接続を検証するメソッド。接続が破棄されると例外が発生します。これは、パラメーター check-valid-connection-sql が存在する場合、それをオーバーライドします。
|
| check-valid-connection-sql | プール接続の妥当性を確認する SQL ステートメント。これは、管理対象接続がプールから取得されて使用されるときに呼び出される場合があります。 |
| validate-on-match |
接続ファクトリーが指定のセットに対して管理された接続に一致させようとした時に接続レベルの検証を実行するかどうかを示します。
一致検証に true を指定することは、通常、background-validation に true を指定することと組み合わせて実行されません。クライアントが使用前に接続を検証する必要がある場合は、Validate-on-match が必要です。このパラメーターはデフォルトで false です)。
|
| background-validation |
接続がバックグラウンドスレッドで検証されることを指定します。バックグラウンド検証は、
validate-on-match で 使用しない場合のパフォーマンスの最適化です。validate-on-match が true の場合、background-validation を使用すると、冗長なチェックが発生する可能性があります。バックグラウンド検証では、使用するためにクライアントに不正な接続が提供される可能性があります (検証スキャンの時点からクライアントに渡される前までの間に接続が不良になる) ため、クライアントアプリケーションはこの可能性を考慮する必要があります。
|
| background-validation-millis | バックグラウンド検証を実行する期間 (ミリ秒単位)。 |
| use-fast-fail |
true の場合、接続が無効であれば最初に接続を割り当てしようとした時点で失敗します。デフォルトは
false です。
|
| stale-connection-checker |
のインスタンス
org.jboss.jca.adapters.jdbc.StaleConnectionCheckerブール値を提供しますisStaleConnection(SQLException e)方法。このメソッドが true を返す場合、例外はorg.jboss.jca.adapters.jdbc.StaleConnectionException、のサブクラスですSQLException。
|
| exception-sorter |
のインスタンス
org.jboss.jca.adapters.jdbc.ExceptionSorterブール値を提供しますisExceptionFatal(SQLException e)方法。このメソッドは、例外がのすべてのインスタンスにブロードキャストされるかどうかを検証しますjavax.resource.spi.ConnectionEventListenerconnectionErrorOccurred メッセージとして。
|
| パラメーター | Description |
|---|---|
| use-try-lock | 用途tryLock()それ以外のlock()。ロックが使用できない場合に即座に失敗するのではなく、タイムアウトする前に設定された秒数間ロックの取得を試みます。デフォルトは 60 秒です。例として、5 分のタイムアウトを設定するには、<use-try-lock>300</use-try-lock>。 |
| blocking-timeout-millis | 接続の待機中にブロックする最大時間 (ミリ秒単位)。この時間を超えると、例外が出力されます。これは、接続の許可を待っている間のみブロックし、新しい接続の作成に時間がかかる場合でも例外を出力しません。デフォルトは 30000、つまり 30 秒です。 |
| idle-timeout-minutes |
アイドル状態の接続が閉じられるまでの最大時間 (分単位)。指定がない場合、デフォルトは
30 分になります。実際の最大時間は、idleRemover スキャン時間によって異なります。これは、プールの最小の idle-timeout-minutes の半分です。
|
| set-tx-query-timeout |
トランザクションがタイムアウトするまでの残り時間を基にクエリーのタイムアウトを設定するかどうかを指定します。トランザクションが存在しない場合は、設定されたクエリータイムアウトが使用されます。デフォルトは
false です。
|
| query-timeout | クエリーのタイムアウト (秒単位)。デフォルトではタイムアウトはありません。 |
| allocation-retry | 例外を出力する前に接続の割り当てを再試行する回数。デフォルトは 0 で、初回の割り当て失敗で例外が発生します。 |
| allocation-retry-wait-millis |
接続の割り当てを再試行する前に待機する時間 (ミリ秒単位)。デフォルトは 5000、つまり 5 秒です。
|
| xa-resource-timeout |
ゼロ以外の場合、この値はメソッドに渡されます
XAResource.setTransactionTimeout。
|
| パラメーター | Description |
|---|---|
| track-statements |
接続がプールへ返され、ステートメントが準備済みステートメントキャッシュへ返された時に、閉じられていないステートメントをチェックするかどうか。false の場合、ステートメントは追跡されません。
|
| prepared-statement-cache-size | LRU (Least Recently Used) キャッシュにある接続毎の準備済みステートメントの数。 |
| share-prepared-statements |
アプリケーションに提供されたラッパーがアプリケーションコードによって閉じられたときに、JBoss EAP が基盤の物理ステートメントを閉じたり終了せずに、キャッシュするかどうか。デフォルトは
false です。
|
| パラメーター | Description |
|---|---|
| recover-credential | リカバリーに使用するユーザー名とパスワードのペア、あるいはセキュリティードメイン。 |
| recover-plugin |
の実装
org.jboss.jca.core.spi.recoveryRecoveryPluginクラス、リカバリに使用されます。
|
