A.20. Datasource Attributes

allocation-retry

非 XA、XA

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

allocation-retry-wait-millis

非 XA、XA

在重试分配连接之间等待的时间，以毫秒为单位。默认值为 0 ms。

allow-multiple-users

非 XA、XA

多个用户是否将通过 getConnection（用户、密码）方法以及 内部池类型是否为此行为访问数据源。

authentication-context

非 XA、XA

定义用于区分池中连接的 javax.security.auth.Subject 的 Elytron 身份验证上下文。

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 语句。从池中获取托管连接时，可能会调用此项。

可连接

非 XA、XA

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

connection-listener-class

非 XA、XA

Specifies class name extending org.jboss.jca.adapters.jdbc.spi.listener.ConnectionListener.此类侦听连接激活和传递，以便在连接返回到应用或池之前执行操作。指定的类必须使用两个资源 JAR 将一个模块中的 JDBC 驱动程序与 JDBC 驱动程序捆绑在一起（如将 JDBC 驱动程序安装为核心模块 ）或单独的全局模块中所示，如 Define Global Modules 所示。

connection-listener-property

非 XA、XA

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

连接属性

Non-XA onlyly

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

connection-url

Non-XA onlyly

JDBC 驱动程序连接 URL。

credential-reference

非 XA、XA

凭据（来自凭据存储），用于对数据源进行身份验证。

datasource-class

Non-XA onlyly

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

driver-class

Non-XA onlyly

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

driver-name

非 XA、XA

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

elytron-enabled

非 XA、XA

启用 Elytron 安全性来处理连接身份验证。如果未指定上下文，要使用的 Elytron 身份验证-context 将为当前上下文。如需更多信息 ，请参阅身份验证 上下文。

enabled

非 XA、XA

是否应启用数据源。

enlistment-trace

非 XA、XA

是否应该记录加入追踪。默认情况下为 false。

exception-sorter-class-name

非 XA、XA

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

exception-sorter-properties

非 XA、XA

异常分类器属性。

flush-strategy

非 XA、XA

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

idle-timeout-minutes

非 XA、XA

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

initial-pool-size

非 XA、XA

池应保留的初始连接数。

interleaving

XA Only

是否为 XA 连接启用交集.

jndi-name

非 XA、XA

数据源的唯一 JNDI 名称。

jta

Non-XA onlyly

启用 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 数据源可能要求这样做，它们可能不允许 JTA 事务内部和外部使用 XA 连接。使用此选项将导致池总大小为 max-pool-size 的两倍，因为将创建两个实际池。

pad-xid

XA Only

是否 pad the Xid.

password

非 XA、XA

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

pool-fair

非 XA、XA

定义池是否应该公平。此设置是 Semaphore 类的一部分，用于在 Jakarta Connectors 中管理连接池，这在某些用例中提供了性能优势，在某些情况下不需要租用连接的顺序。

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

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

reauth-plugin-properties

非 XA、XA

重新身份验证插件的属性：

recovery-authentication-context

XA Only

定义用于区分池中连接的 javax.security.auth.Subject 的 Elytron 身份验证上下文。

recovery-credential-reference

XA Only

凭据（来自凭据存储），用于对数据源进行身份验证。

recovery-elytron-enabled

XA Only

启用 Elytron 安全性，以处理用于恢复的连接的身份验证。如果未指定 身份验证-上下文， 则使用的 Elytron authentication-context 将是当前的上下文。如需更多信息 ，请参阅身份验证 上下文。

restore-password

XA Only

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

recovery-plugin-class-name

XA Only

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

recovery-plugin-properties

XA Only

恢复插件的属性。

recovery-security-domain

XA Only

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

restore-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

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

共享准备状态

非 XA、XA

当为应用提供的打包程序受应用代码封闭时，无论是 JBoss EAP 是否应该缓存，而不是关闭或终止的底层物理语句。默认值为 false。

spy

非 XA、XA

在 JDBC 层上启用间隔功能。这会记录到数据源的所有 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

过时的连接检查器属性。

statistics-enabled

非 XA、XA

是否启用运行时统计数据。默认值为 false。

track-statements

非 XA、XA

连接返回到池时，是否检查未克隆的语句，并且语句返回到准备的语句缓存。如果为 false，则语句不会被跟踪。有效值：

tracking

非 XA、XA

是否跟踪连接处理跨越事务界限.

transaction-isolation

非 XA、XA

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

url-delimiter

非 XA、XA

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

url-property

XA Only

the 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 通常不与 后台验证 一起使用，或者将进行冗余检查。

wrap-xa-resource

XA Only

是否将 XAResource 包装到 org.jboss.tm.XAResourceWrapper 实例中。

xa-datasource-class

XA Only

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

xa-datasource-properties

XA Only

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

xa-resource-timeout

XA Only

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

datasource-class-info

非 XA、XA

jdbc-driver 的 datasource-class 和 xa-datasource-class 的可用属性。datasource-class and xa-datasource-class 属性定义实施 javax.sql.DataSource 或 javax.sql .XADataSource 类的完全限定类名称。定义的类可以具有各种属性的设置器。datasource-class-info 属性列出了可为类设置的这些属性。