1.2. 配置数据源

数据源可以是 JDBC 数据源、被动或两者。这取决于配置和选择项目扩展。

到目前为止，无论您使用的是 JDBC 还是被动驱动程序，配置都相同。当您定义了数据库类型和凭证时，其余则取决于您所使用的驱动程序类型。可以同时使用 JDBC 和被动驱动程序。

quarkus.datasource.jdbc.driver=io.opentracing.contrib.jdbc.TracingDriver

quarkus.datasource.db-kind=other
quarkus.datasource.jdbc.driver=oracle.jdbc.driver.OracleDriver
quarkus.datasource.jdbc.url=jdbc:oracle:thin:@192.168.1.12:1521/ORCL_SVC
quarkus.datasource.username=scott
quarkus.datasource.password=tiger

@Inject
AgroalDataSource defaultDataSource;

定义多个数据源的工作方式类似于定义一个数据源，具有一个重要更改 - 您必须为每个数据源指定一个名称（配置属性）。

以下示例提供三个不同的数据源：

每个配置都有其配置：

quarkus.datasource.db-kind=h2
quarkus.datasource.username=username-default
quarkus.datasource.jdbc.url=jdbc:h2:mem:default
quarkus.datasource.jdbc.max-size=13

quarkus.datasource.users.db-kind=h2
quarkus.datasource.users.username=username1
quarkus.datasource.users.jdbc.url=jdbc:h2:mem:users
quarkus.datasource.users.jdbc.max-size=11

quarkus.datasource.inventory.db-kind=h2
quarkus.datasource.inventory.username=username2
quarkus.datasource.inventory.jdbc.url=jdbc:h2:mem:inventory
quarkus.datasource.inventory.jdbc.max-size=12

请注意，配置属性中有一个额外的部分。语法如下： quarkus.datasource.[optional name.][datasource property].

@Inject
AgroalDataSource defaultDataSource;

@Inject
@DataSource("users")
AgroalDataSource usersDataSource;

@Inject
@DataSource("inventory")
AgroalDataSource inventoryDataSource;

如果在构建时配置了数据源，默认情况下，它在运行时处于活跃状态，即 Quarkus 将在应用启动时启动对应的 JDBC 连接池或重新主动客户端。

要在运行时取消激活数据源，请将 quarkus.datasource[.optional name].active 设置为 false。然后 Quarkus 不会在应用启动时启动对应的 JDBC 连接池或被动客户端。在运行时使用对应的数据源的任何尝试都会失败，并显示清晰的错误消息。

当您希望应用程序在运行时使用预先确定的数据源集合时，这特别有用。

例如，使用以下配置：

quarkus.datasource."pg".db-kind=postgres
quarkus.datasource."pg".active=false
quarkus.datasource."pg".jdbc.url=jdbc:postgresql:///your_database

quarkus.datasource."oracle".db-kind=oracle
quarkus.datasource."oracle".active=false
quarkus.datasource."oracle".jdbc.url=jdbc:oracle:///your_database

在运行时设置 quarkus.datasource."pg".active=true 将使 PostgreSQL 数据源可用，并在运行时 设置 quarkus.datasource."oracle".active=true 将使 Oracle 数据源可用。

%pg.quarkus.hibernate-orm."pg".active=true
%pg.quarkus.datasource."pg".active=true
# Add any pg-related runtime configuration here, prefixed with "%pg."

%oracle.quarkus.hibernate-orm."oracle".active=true
%oracle.quarkus.datasource."oracle".active=true
# Add any pg-related runtime configuration here, prefixed with "%pg."

public class MyProducer {
    @Inject
    DataSourceSupport dataSourceSupport;

    @Inject
    @DataSource("pg")
    AgroalDataSource pgDataSourceBean;

    @Inject
    @DataSource("oracle")
    AgroalDataSource oracleDataSourceBean;

    @Produces
    @ApplicationScoped
    public AgroalDataSource dataSource() {
        if (dataSourceSupport.getInactiveNames().contains("pg")) {
            return oracleDataSourceBean;
        } else {
            return pgDataSourceBean;
        }
    }
}

默认情况下，数据源上的 XA 支持被禁用，因此事务最多可能包括一个数据源。在同一个事务中尝试访问多个非 XA datasources 是不安全的，将导致警告。

在 Quarkus 3.10+ 中，这会导致错误。

要安全地允许在同一事务中使用多个 JDBC 数据源：

使用 XA 时，一个数据源的回滚将在事务中注册的每个其他数据源中触发回滚。

如果无法为您的其中一个数据源启用 XA ：