A.17. 数据源参数

allocation-retry

非 XA, XA

在抛出异常前，应尝试分配连接的次数。默认值为 0， 因此在第一次失败时抛出异常。

allocation-retry-wait-millis

非 XA, XA

重试分配连接之间等待的时间（以毫秒为单位）。默认值为 5000 ms。

allow-multiple-users

非 XA, XA

无论多个用户是否将通过 getConnection (user、password) 方法访问数据源，以及内部池类型帐户用于此行为。

background-validation

非 XA, XA

使用前，是否应在后台线程中验证连接与验证。后台验证通常不会与 validate-on-match 一起使用，或者有多余的检查。使用后台验证时，连接在验证时间不良的机会，并被移交给客户端，因此应用程序必须考虑这一点。

background-validation-millis

非 XA, XA

后台验证将运行的频率（以毫秒为单位）。

blocking-timeout-wait-millis

非 XA, XA

在抛出异常前等待连接时（以毫秒为单位）的最长时间（以毫秒为单位）。请注意，只有在等待锁定连接时此块，如果创建新连接需要很长时间，则永远不会抛出异常。

capacity-decrementer-class

非 XA, XA

定义在池中减少连接的策略。

capacity-decrementer-properties

非 XA, XA

在类中注入的属性，定义在池中减少连接的策略。

capacity-incrementer-class

非 XA, XA

定义用于在池中递增连接的策略的类。

capacity-incrementer-properties

非 XA, XA

在类中注入的属性，定义用于在池中递增连接的策略。

check-valid-connection-sql

非 XA, XA

用于检查池连接的有效性的 SQL 语句。从池中获取受管连接时，可以调用此设置。

connectable

非 XA, XA

启用 CMR 的使用，这意味着本地资源可以可靠地参与 XA 事务。

connection-listener-class

非 XA, XA

指定扩展 org.jboss.jca.adapters.jdbc.spi.listener.ConnectionListener 的类名称。此类侦听连接激活和传递，以便在返回到应用或到池的连接之前执行操作。使用两个资源 jar （将 JDBC 驱动程序安装为核心模块）或单独的全局模块（定义全局模块）中，必须将指定的类与 JDBC驱动程序捆绑到一起(定义全局模块)。

connection-listener-property

非 XA, XA

要注入到 connection-listener-class 中指定的类的属性。注入的属性符合 3.0.0 约定。例如，如果您指定了名为 foo 的属性，则连接监听程序类需要有一个方法 setFoo，它接受 String 作为参数。

connection-properties

仅限非 XA

传递给 Driver.connect (url,props) 方法的任意字符串名称/值对连接属性。

connection-url

仅限非 XA

JDBC 驱动程序连接 URL。

datasource-class

仅限非 XA

JDBC 数据源类的完全限定名称。

driver-class

仅限非 XA

JDBC 驱动程序类的完全限定名称。

driver-name

非 XA, XA

定义数据源应使用的 JDBC 驱动程序。它是与已安装驱动程序名称匹配的符号名称。如果驱动程序部署为 JAR，则名称是部署的名称。

enabled

非 XA, XA

是否应该启用数据源。

enlistment-trace

非 XA, XA

是否应该记录 trace。

exception-sorter-class-name

非 XA, XA

一个 org.jboss.jca.adapters.jdbc.ExceptionSorter 实例，它提供了一种验证异常是否应该广播错误的方法。

exception-sorter-properties

非 XA, XA

exception sorter 属性。

flush-strategy

非 XA, XA

指定在出错时应如何清除池。有效值为：

idle-timeout-minutes

非 XA, XA

连接在关闭前可以闲置的最长时间（以分钟为单位）。如果没有指定，则默认为 30 分钟。实际最长时间还取决于 IdleRemover 扫描时间，这是任何池的最小 idle-timeout-minutes 值的一半。

initial-pool-size

非 XA, XA

池应保存的初始连接数。

交集

XA Only

是否为 XA 连接启用交集。

jndi-name

非 XA, XA

数据源的唯一 JNDI 名称。

JTA

仅限非 XA

启用 JTA 集成。

max-pool-size

非 XA, XA

池可以保存的最大连接数。

MCP

非 XA, XA

ManagedConnectionPool 实现。例如，org.jboss.jca.core.connectionmanager.pool.mcp.SemaphoreArrayListManagedConnectionPool

min-pool-size

非 XA, XA

池可以容纳的最小连接数。

new-connection-sql

非 XA, XA

每当将连接添加到连接池时要执行的 SQL 语句。

no-recovery

XA Only

连接池是否应从恢复中排除。

no-tx-separate-pool

XA Only

是否为每个上下文创建单独的子池。一些 Oracle datasources 可能需要此项，它们可能不允许 XA 连接在 JTA 事务内和外部使用。使用此选项将导致您的总池大小两倍的 max-pool-size，因为将创建两个实际池。

pad-xid

XA Only

是否用完 Xid。

password

非 XA, XA

创建新连接时使用的密码。

pool-fair

非 XA, XA

定义池是否应该公平。此设置是用于管理 JCA 中的连接池的 Semaphore 类的一部分，它在一些用例中提供了性能优势，因为不需要禁止连接顺序。

pool-prefill

非 XA, XA

是否应预先填充池。

pool-use-strict-min

非 XA, XA

min-pool-size 是否应该严格考虑。

prepared-statements-cache-size

非 XA, XA

在 Least Recently Used (LRU)缓存中每个连接的准备语句数量。

query-timeout

非 XA, XA

查询的超时时间（以秒为单位）。默认为没有超时。

reauth-plugin-class-name

非 XA, XA

reauthentication 插件实现的完全限定类名称，用于重新验证物理连接。

reauth-plugin-properties

非 XA, XA

reauthentication 插件的属性。

recovery-password

XA Only

用于连接到资源进行恢复的密码。

recovery-plugin-class-name

XA Only

恢复插件实现的完全限定类名称。

recovery-plugin-properties

XA Only

恢复插件的属性。

recovery-security-domain

XA Only

用于连接到资源进行恢复的安全域。

recovery-username

XA Only

用于连接到资源以恢复的用户名。

same-rm-override

XA Only

javax.transaction.xa.XAResource.isSameRM (XAResource) 类返回 true 或 false。

security-domain

非 XA, XA

处理身份验证的 JAAS security-manager 的名称。此名称与 JAAS 登录配置的 application-policy/name 属性关联。

set-tx-query-timeout

非 XA, XA

是否根据剩余时间设置查询超时，直到事务超时为止。如果没有事务，则会使用任何配置的查询超时。

share-prepared-statements

非 XA, XA

当提供给应用程序的打包程序由应用程序代码关闭时，JBoss EAP 是否应该缓存而不是关闭或终止底层物理声明。默认值为 false。

spy

非 XA, XA

在 JDBC 层上启用 spy 功能。这会将所有 JDBC 流量记录到数据源。请注意，日志记录类别 jboss.jdbc.spy 还必须设置为 logging 子系统中的日志级别 DEBUG。

stale-connection-checker-class-name

非 XA, XA

一个 org.jboss.jca.adapters.jdbc.StaleConnectionChecker 实例，它提供 isStaleConnection (SQLException) 方法。如果此方法返回 true，则异常会嵌套在 org.jboss.jca.adapters.jdbc.StaleConnectionException 中。

stale-connection-checker-properties

非 XA, XA

stale 连接检查程序属性。

启用统计

非 XA, XA

是否启用运行时统计信息。默认值为 false。

track-statements

非 XA, XA

当连接返回到池时，是否要检查未关闭的声明，并且一个语句返回到准备的声明缓存。如果为 false，则不会跟踪语句。有效值：

tracking

非 XA, XA

是否跟踪跨事务界限的连接处理。

transaction-isolation

非 XA, XA

java.sql.Connection 事务隔离级别。有效值：

url-delimiter

非 XA, XA

connection-url 用于高可用性(HA)数据源的 URL 的分隔符。

url-property

XA Only

xa-datasource-property 值中 URL 属性的属性。

url-selector-strategy-class-name

非 XA, XA

实现 org.jboss.jca.adapters.jdbc.URLSelectorStrategy 的类。

use-ccm

非 XA, XA

启用缓存的连接管理器。

use-fast-fail

非 XA, XA

如果为 true，在连接无效时在第一次尝试时失败连接分配。如果为 false，请一直尝试直到池耗尽为止。

use-java-context

非 XA, XA

是否将数据源绑定到全局 JNDI。

use-try-lock

非 XA, XA

内部锁定的超时值。这会在锁定不可用时，在超时前尝试获取配置的秒数，而不是立即失败。使用 tryLock （） 而不是 lock （）。

user-name

非 XA, XA

创建新连接时使用的用户名。

valid-connection-checker-class-name

非 XA, XA

一个 org.jboss.jca.adaptors.jdbc.ValidConnectionChecker 的实现，它提供 SQLException.isValidConnection (Connection e) 方法来验证连接。一个例外表示连接被销毁。如果存在，这将覆盖参数 check-valid-connection-sql。

valid-connection-checker-properties

非 XA, XA

有效的连接检查程序属性。

validate-on-match

非 XA, XA

当连接工厂尝试匹配受管连接时，是否执行连接验证。当客户端必须在使用前验证连接时，应使用此选项。validate-on-match 通常不用于 background-validation，否则将进行冗余检查。

wrap-xa-resource

XA Only

是否在 org.jboss.tm.XAResourceWrapper 实例中嵌套 XAResource。

xa-datasource-class

XA Only

javax.sql.XADataSource 实施类的完全限定名称。

xa-datasource-properties

XA Only

XA 数据源属性的字符串名称/值对。

xa-resource-timeout

XA Only

如果非零，则这个值将传递到 XAResource.setTransactionTimeout 方法。