Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

12.6.2.5. データソースのパラメーター

表12.1 非 XA および XA データソースに共通のデータソースパラメーター

パラメーター 説明
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
次のいずれかになります。
  • TRANSACTION_READ_UNCOMMITTED
  • TRANSACTION_READ_COMMITTED
  • TRANSACTION_REPEATABLE_READ
  • TRANSACTION_SERIALIZABLE
  • TRANSACTION_NONE
url-selector-strategy-class-name インターフェイスを実装するクラスorg.jboss.jca.adapters.jdbc.URLSelectorStrategy。
security
セキュリティー設定である子要素が含まれています。表12.6「セキュリティーパラメーター」を参照してください。
検証
検証設定である子要素が含まれます。表12.7「検証パラメーター」を参照してください。
timeout
タイムアウト設定である子要素が含まれています。表12.8「タイムアウトパラメーター」を参照してください。
statement
ステートメント設定である子要素が含まれます。表12.9「ステートメントのパラメーター」を参照してください。

表12.2 非 XA データソースのパラメーター

パラメーター 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 の区切り文字。　

表12.3 XA データソースのパラメーター

パラメーター 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「リカバリーパラメーター」を参照してください。

表12.4 非 XA および XA データソースに共通のプールパラメーター

パラメーター Description
min-pool-size プールが保持する最小接続数
max-pool-size プールが保持可能な最大接続数
prefill 接続プールを事前に入力するかどうか。デフォルトは false です。
use-strict-min min-pool-size に達した後、アイドル接続スキャンがそれ以降の接続を閉じるためのマーキングを厳密に停止する必要があるかどうか。デフォルト値は false です。
flush-strategy
エラーが発生した場合にプールがフラッシュされるかどうか。有効な値は以下のとおりです。
  • FailingConnectionOnly
  • IdleConnections
  • EntirePool
デフォルトは FailingConnectionOnly です。
allow-multiple-users 複数のユーザーが getConnection(user, password) メソッドを使いデータソースへアクセスするかどうか、および内部プールタイプがこの動作に対応するかを指定します。

表12.5 XA プールパラメーター

パラメーター 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実例。

表12.6 セキュリティーパラメーター

パラメーター Description
user-name 新規接続の作成に使うユーザー名
password 新規接続の作成に使うパスワード
security-domain 認証処理を行う JAAS security-manager の名前を含みます。この名前は、JAAS ログイン設定の application-policy/name 属性に相関します。
reauth-plugin 物理接続の再認証に使う再認証プラグインを定義します。

表12.7 検証パラメーター

パラメーター 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 メッセージとして。

表12.8 タイムアウトパラメーター

パラメーター 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。

表12.9 ステートメントのパラメーター

パラメーター Description
track-statements
接続がプールへ返され、ステートメントが準備済みステートメントキャッシュへ返された時に、閉じられていないステートメントをチェックするかどうか。false の場合、ステートメントは追跡されません。

有効な値

  • true: ステートメントと結果セットが追跡され、ステートメントが閉じられていない場合は警告が出力されます。
  • false: ステートメントと結果セットのいずれも追跡されません。
  • nowarn: ステートメントは追跡されますが、警告は出力されません。これがデフォルトです。
prepared-statement-cache-size LRU (Least Recently Used) キャッシュにある接続毎の準備済みステートメントの数。
share-prepared-statements
アプリケーションに提供されたラッパーがアプリケーションコードによって閉じられたときに、JBoss EAP が基盤の物理ステートメントを閉じたり終了せずに、キャッシュするかどうか。デフォルトは false です。

表12.10 リカバリーパラメーター

パラメーター Description
recover-credential リカバリーに使用するユーザー名とパスワードのペア、あるいはセキュリティードメイン。
recover-plugin
の実装org.jboss.jca.core.spi.recoveryRecoveryPluginクラス、リカバリに使用されます。
バグの報告