9.13. 配置多个数据源

要启用额外的数据源，您需要设置 2 个内容 - JPA persistence.xml 文件和红帽构建的 Keycloak 配置。persistence.xml 文件充当 Jakarta Persistence API 标准的一部分，需要正确配置到 Hibernate ORM 框架。使用 persistence.xml 文件完成部分后，您需要相应地设置红帽构建的 Keycloak 配置。

额外的数据源属性可以通过标准配置源（如 CLI、keycloak.conf 或环境变量）指定。

额外的数据源可以像主数据源一样配置。这可以通过对配置选项使用类名称来实现，这还包括附加数据源的名称。例如，当主数据源使用 db-username 时，另一个是 db- username-<datasource>。有关相关选项的完整列表，请参见相关选项章节。

<persistence xmlns="https://jakarta.ee/xml/ns/persistence"
                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                         xsi:schemaLocation="https://jakarta.ee/xml/ns/persistence https://jakarta.ee/xml/ns/persistence/persistence_3_0.xsd"
                         version="3.0">
    <persistence-unit name="user-store-pu" transaction-type="JTA">
        <class>org.your.extension.UserEntity</class>
        <properties>
            <property name="jakarta.persistence.jtaDataSource" value="user-store" />
        </properties>
    </persistence-unit>
</persistence>

bin/kc.[sh|bat] start --db-kind-user-store=postgres

如果您不想通过 CLI 或 keycloak.conf 属性配置数据源，您可以使用环境变量。

您可以通过环境变量（用于 user-store 数据源）设置 DB kind，如下所示：

export KC_DB_KIND_USER_STORE=postgres
export KC_DB_USERNAME_USER_STORE=my-username

由于环境变量的默认映射，它映射到 db - kind-user-store 和 db-username-user-store 红帽构建的 Keycloak 属性。但有时候，数据源的名称可能包含一些特殊字符，如 _、$ 或 。

要通过红帽构建的 Keycloak 环境变量正确配置它，您需要明确指出数据源的密钥应是什么样子。您可以使用一对唯一红帽构建的 Keycloak 环境变量，以及 KCKEY_ 的特殊案例。

例如，对于名为 user_store$ marketing 的数据源，您可以按如下方式设置环境变量：

export KC_USER_STORE_DB_KIND=mariadb
export KCKEY_USER_STORE_DB_KIND=db-kind-user_store$marketing

您可以参阅 Configuring Red Hat build of Keycloak, in 子小节中 用于带有特殊字符 的环境变量键的内容。

在过去，我们指示用户使用原始 Quarkus 属性在某些位置配置额外的数据源。但是，如在 conf/quarkus.properties 文件中使用 Quarkus 属性被视为 不受支持，强烈建议您使用专用的附加数据源选项，如上面所述。

在能够迁移到专用选项前，您仍然可以通过 Quarkus 属性指定数据源设置，如下所示：

quarkus.datasource.user-store.db-kind=h2
quarkus.datasource.user-store.username=sa
quarkus.datasource.user-store.jdbc.url=jdbc:h2:mem:user-store;DB_CLOSE_DELAY=-1
quarkus.datasource.user-store.jdbc.transactions=xa