1.4.2. JDBC 配置参考

build 时修复的 - 配置属性在构建时修复 - 所有其他配置属性在运行时可覆盖

Expand

配置属性	Type	default
在构建时修复了 `quarkus.datasource.dev-ui.enabled` 激活或禁用 dev ui 页面。环境变量： `QUARKUS_DATASOURCE_DEV_UI_ENABLED`	布尔值	`true`
在构建时间 `quarkus.datasource.dev-ui.allow-sql`时修复在 Dev UI 页面中允许 sql 查询环境变量： `QUARKUS_DATASOURCE_DEV_UI_ALLOW_SQL`	布尔值	`false`
在构建时修复了 `quarkus.datasource.dev-ui.append-to-default-select` 将此选项附加到选择以获取表值。例如：LIMIT 100 或 TOP 100 环境变量： `QUARKUS_DATASOURCE_DEV_UI_APPEND_TO_DEFAULT_SELECT`	string
build time `quarkus.datasource.dev-ui.allowed-db-host` 允许的数据库主机。默认情况下，只允许 localhost。此处提供的任何主机都将被允许。您可以使用特殊值 `*` 来允许任何 DB 主机。环境变量： `QUARKUS_DATASOURCE_DEV_UI_ALLOWED_DB_HOST`	string
在构建时间 quarkus.datasource.jdbc] `quarkus.datasource.jdbc` `quarkus.datasource."datasource-name".jdbc` 如果我们为此数据源创建 JDBC 数据源。环境变量： `QUARKUS_DATASOURCE_JDBC`	布尔值	`true`
在构建时间 quarkus.datasource.jdbc.driver] `quarkus.datasource.jdbc.driver` `quarkus.datasource."datasource-name".jdbc.driver` 数据源驱动程序类名称环境变量： `QUARKUS_DATASOURCE_JDBC_DRIVER`	string
在构建时修复了 `quarkus.datasource.jdbc.transactions` `quarkus.datasource."datasource-name".jdbc.transactions` 是否要使用常规 JDBC 事务、XA 还是禁用所有事务处理功能。启用 XA 时，您将需要一个实现 `javax.sql.XADataSource` 的驱动程序。环境变量： `QUARKUS_DATASOURCE_JDBC_TRANSACTIONS`	启用：将 JDBC 数据源与 Quarkus 的 JTA TransactionManager 集成。这是默认值。 XA ：与 `启用相似`，还支持与 Quarkus 的 JTA TransactionManager 的集成，但启用 XA 事务。需要实施 `javax.sql.XADataSource`的 JDBC 驱动程序 disabled ：禁用与 Narayana TransactionManager 的 Agroal 集成。这通常是一个好主意，且仅在特殊情况下很有用：请确保在不深入了解影响的情况下不使用此功能。	enabled
在构建时修复了 `quarkus.datasource.jdbc.enable-metrics` `quarkus.datasource."datasource-name".jdbc.enable-metrics` 启用数据源指标集合。如果未指定，则当指标扩展处于活跃状态时，将默认启用收集指标。环境变量： `QUARKUS_DATASOURCE_JDBC_ENABLE_METRICS`	布尔值
在构建时修复了 `quarkus.datasource.jdbc.telemetry` `quarkus.datasource."datasource-name".jdbc.telemetry` 启用 OpenTelemetry JDBC 检测。环境变量： `QUARKUS_DATASOURCE_JDBC_TELEMETRY`	布尔值	`false`
`quarkus.datasource.jdbc.url` `quarkus.datasource."datasource-name".jdbc.url` 数据源 URL 环境变量： `QUARKUS_DATASOURCE_JDBC_URL`	string
`quarkus.datasource.jdbc.initial-size` `quarkus.datasource."datasource-name".jdbc.initial-size` 池的初始大小。通常，您要将初始大小设置为至少与最小大小匹配，但这不强制，允许那些希望在引导时对连接的 lazy 初始化的架构，同时在启动时可以保持最小池大小。环境变量： `QUARKUS_DATASOURCE_JDBC_INITIAL_SIZE`	int
`quarkus.datasource.jdbc.min-size` `quarkus.datasource."datasource-name".jdbc.min-size` 数据源池最小值环境变量： `QUARKUS_DATASOURCE_JDBC_MIN_SIZE`	int	`0`
`quarkus.datasource.jdbc.max-size` `quarkus.datasource."datasource-name".jdbc.max-size` 数据源池最大大小环境变量： `QUARKUS_DATASOURCE_JDBC_MAX_SIZE`	int	`20`
`quarkus.datasource.jdbc.background-validation-interval` `quarkus.datasource."datasource-name".jdbc.background-validation-interval` 我们在后台验证闲置连接的时间间隔。设置为 `0` 以禁用后台验证。环境变量： `QUARKUS_DATASOURCE_JDBC_BACKGROUND_VALIDATION_INTERVAL`	持续时间 5-4 Duration 格式	`2M`
`quarkus.datasource.jdbc.foreground-validation-interval` `quarkus.datasource."datasource-name".jdbc.foreground-validation-interval` 对闲置时间超过指定间隔的连接执行前台验证。环境变量： `QUARKUS_DATASOURCE_JDBC_FOREGROUND_VALIDATION_INTERVAL`	持续时间 5-4 Duration 格式
`quarkus.datasource.jdbc.acquisition-timeout` `quarkus.datasource."datasource-name".jdbc.acquisition-timeout` 取消获取新连接前的超时时间环境变量： `QUARKUS_DATASOURCE_JDBC_ACQUISITION_TIMEOUT`	持续时间 5-4 Duration 格式	`5S`
`quarkus.datasource.jdbc.leak-detection-interval` `quarkus.datasource."datasource-name".jdbc.leak-detection-interval` 检查连接泄漏的时间间隔。环境变量： `QUARKUS_DATASOURCE_JDBC_LEAK_DETECTION_INTERVAL`	持续时间 5-4 Duration 格式	`此功能默认为禁用。`
`quarkus.datasource.jdbc.idle-removal-interval` `quarkus.datasource."datasource-name".jdbc.idle-removal-interval` 我们试图删除闲置连接的时间间隔。环境变量： `QUARKUS_DATASOURCE_JDBC_IDLE_REMOVAL_INTERVAL`	持续时间 5-4 Duration 格式	`5M`
`quarkus.datasource.jdbc.max-lifetime` `quarkus.datasource."datasource-name".jdbc.max-lifetime` 连接的最大生命周期。环境变量： `QUARKUS_DATASOURCE_JDBC_MAX_LIFETIME`	持续时间 5-4 Duration 格式	`默认情况下，连接的寿命没有限制。`
`quarkus.datasource.jdbc.transaction-isolation-level` `quarkus.datasource."datasource-name".jdbc.transaction-isolation-level` 事务隔离级别。环境变量： `QUARKUS_DATASOURCE_JDBC_TRANSACTION_ISOLATION_LEVEL`	`undefined`,`none`,`read-uncommitted`,`read-committed`,`repeatable-read`,`serializable`
`quarkus.datasource.jdbc.extended-leak-report` `quarkus.datasource."datasource-name".jdbc.extended-leak-report` 收集并显示泄漏连接中的额外故障排除信息。环境变量： `QUARKUS_DATASOURCE_JDBC_EXTENDED_LEAK_REPORT`	布尔值	`false`
`quarkus.datasource.jdbc.flush-on-close` `quarkus.datasource."datasource-name".jdbc.flush-on-close` 在返回到池后，允许刷新连接。默认情况下不启用。环境变量： `QUARKUS_DATASOURCE_JDBC_FLUSH_ON_CLOSE`	布尔值	`false`
`quarkus.datasource.jdbc.detect-statement-leaks` `quarkus.datasource."datasource-name".jdbc.detect-statement-leaks` 启用后，Agroal 能够在不关闭所有打开的声明的情况下，在返回到池时产生警告。这与跟踪打开的连接无关。禁用峰值性能，但仅在有高度信任时不会发生泄漏。环境变量： `QUARKUS_DATASOURCE_JDBC_DETECT_STATEMENT_LEAKS`	布尔值	`true`
`quarkus.datasource.jdbc.new-connection-sql` `quarkus.datasource."datasource-name".jdbc.new-connection-sql` 第一次使用连接时执行的查询。环境变量： `QUARKUS_DATASOURCE_JDBC_NEW_CONNECTION_SQL`	string
`quarkus.datasource.jdbc.validation-query-sql` `quarkus.datasource."datasource-name".jdbc.validation-query-sql` 执行的查询以验证连接。环境变量： `QUARKUS_DATASOURCE_JDBC_VALIDATION_QUERY_SQL`	string
`quarkus.datasource.jdbc.validate-on-borrow` `quarkus.datasource."datasource-name".jdbc.validate-on-borrow` 无论空闲状态如何，强制在获取(foreground 验证)前进行连接验证。由于每次调用时执行验证的开销，建议依赖默认的空闲验证，并把它保留为 `false`。环境变量： `QUARKUS_DATASOURCE_JDBC_VALIDATE_ON_BORROW`	布尔值	`false`
`quarkus.datasource.jdbc.pooling-enabled` `quarkus.datasource."datasource-name".jdbc.pooling-enabled` 禁用池以防止重复使用连接。当外部池管理 Connections 的生命周期时，请使用此选项。环境变量： `QUARKUS_DATASOURCE_JDBC_POOLING_ENABLED`	布尔值	`true`
`quarkus.datasource.jdbc.enable-recovery` `quarkus.datasource."datasource-name".jdbc.enable-recovery` 是否为此数据源启用恢复。通常，事务管理器会在恢复期间在 XA 连接上调用 xa_recover （），以获取当前处于准备或高度完成状态的事务分支列表。但是，可能会出现多个 XA 连接连接到同一数据源，该数据源将全部返回同一组分支，并且出于改进的性能原因只应该用于恢复（）调用。此配置属性的默认值为 true，因为当只有一个连接对于数据一致性至关重要时，连接可以报告其准备或高度完成分支列表。环境变量： `QUARKUS_DATASOURCE_JDBC_ENABLE_RECOVERY`	布尔值	`true`
`quarkus.datasource.jdbc.transaction-requirement` `quarkus.datasource."datasource-name".jdbc.transaction-requirement` 在获取连接时需要活跃的事务。建议用于生产环境。警告：一些扩展会获取连接，而无需为 schema 更新和模式验证等操作保留事务。在这些情况下，将此设置设置为 STRICT 可能会导致失败。环境变量： `QUARKUS_DATASOURCE_JDBC_TRANSACTION_REQUIREMENT`	`off`,`warn`,`strict`
`quarkus.datasource.jdbc.additional-jdbc-properties."property-key"` `quarkus.datasource."datasource-name".jdbc.additional-jdbc-properties."property-key"` 创建新连接时，将传递给 JDBC 驱动程序的其他未指定属性。环境变量： `QUARKUS_DATASOURCE_JDBC_ADDITIONAL_JDBC_PROPERTIES__PROPERTY_KEY_`	Map<String,String>
`quarkus.datasource.jdbc.telemetry.enabled` `quarkus.datasource."datasource-name".jdbc.telemetry.enabled` 启用 OpenTelemetry JDBC 检测。环境变量： `QUARKUS_DATASOURCE_JDBC_TELEMETRY_ENABLED`	布尔值	`如果 quarkus.datasource.jdbc.telemetry=false 和 true，则为 false （如果 quarkus.datasource.jdbc.telemetry=true）`

关于 Duration 格式

要写入持续时间值，请使用标准 java.time.Duration 格式。如需更多信息，请参阅 Duration#parse （）Java API 文档。

您还可以使用简化的格式，从数字开始：

如果值只是一个数字，它代表时间（以秒为单位）。
如果值为数字，后跟 ms，代表时间（毫秒）。

在其他情况下，简化的格式被转换为 java.time.Duration 格式以进行解析：

如果该值是一个数字，后跟 h、m 或 s，则前缀为 PT。
如果值为数字，后跟 d，则会以 P 为前缀。

1.4.2. JDBC 配置参考

学习

尝试、购买和销售

社区

關於紅帽

让开源更具包容性

关于红帽文档

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links