A.20. 数据源属性

allocation-retry

非 XA, XA

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

allocation-retry-wait-millis

非 XA, XA

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

allow-multiple-users

非 XA, XA

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

authentication-context

非 XA, XA

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

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

指定扩展 org.jboss.jca.adapters.jdbc.spi.listener.ConnectionListener 的类名称。此类侦听连接激活和传递，以便在连接返回到应用或池之前执行操作。指定类必须与一个模块中的 JDBC 驱动程序捆绑在一个模块中，如 安装 JDBC 驱动程序作为核心模块，或者在 单独的全局模块中，如 Define Global Modules 所示。

connection-listener-property

非 XA, XA

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

connection-properties

仅限非 XA

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

connection-url

仅限非 XA

JDBC 驱动程序连接 URL。

credential-reference

非 XA, XA

从凭证存储中用于对数据源进行身份验证的凭证。

datasource-class

仅限非 XA

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

driver-class

仅限非 XA

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

driver-name

非 XA, XA

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

Elytron-enabled

非 XA, XA

启用 Elytron 安全来处理连接身份验证。如果没有指定上下文，要使用的 Elytron authentication-context 将是当前上下文。如需更多信息，请参阅 authentication-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 扫描时间，这是任何池的最小 idle-timeout-minutes 值的一半。

initial-pool-size

非 XA, XA

池应保留的初始连接数。

交集

仅 XA

是否为 XA 连接启用交集。

JNDI-name

非 XA, XA

数据源的唯一 JNDI 名称。

jta

仅限非 XA

启用 Jakarta 交易集成。

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

连接池是否应该不包括在恢复中。

no-tx-separate-pool

仅 XA

是否为每个上下文创建单独的子池。一些 Oracle 数据源可能需要此功能，这可能不允许 XA 连接在 Jakarta 事务事务之间和外部使用。使用这个选项将导致池总大小达到 max-pool-size 的两倍，因为将创建两个实际池。

pad-xid

仅 XA

是否要用 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

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

recovery-credential-reference

仅 XA

从凭证存储中用于对数据源进行身份验证的凭证。

recovery-elytron-enabled

仅 XA

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

recovery-password

仅 XA

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

recovery-plugin-class-name

仅 XA

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

recovery-plugin-properties

仅 XA

恢复插件的属性。

recovery-security-domain

仅 XA

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

recovery-username

仅 XA

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

same-rm-override

仅 XA

jakarta.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 流量记录到数据源。注意 logging 类别 jboss.jdbc.spy 也必须在 logging 子系统中设置为 log level 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

过时的连接检查程序属性。

启用统计

非 XA, XA

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

track-statements

非 XA, XA

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

tracking

非 XA, XA

是否跟踪跨事务边界的连接句柄。

transaction-isolation

非 XA, XA

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

url-delimiter

非 XA, XA

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

url-property

仅 XA

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

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

xa-datasource-class

仅 XA

jakarta.sql.XADataSource 实现类的完全限定名称。

xa-datasource-properties

仅 XA

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

xa-resource-timeout

仅 XA

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

datasource-class-info

非 XA, XA

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