第 2 章 JDBC 数据源配置


JDBC 是最常用的基于 Java 的应用中的数据库连接 API。您可以使用 JDBC 数据源驱动程序将应用程序连接到相关数据库。

要配置 JDBC 数据源,您必须

  • quarkus-agroal 扩展添加到应用程序中
  • 为应用程序添加 db-kind 扩展
  • 指定应用程序用于访问数据源的 JDBC URL

以下示例演示了如何将 postgresql 数据源连接到您的应用,并指定数据源的访问凭据和 JDBC URL。有关如何指定 JDBC URL 的更多信息 ,请参阅设置数据源的 JDBC URL

JDBC 数据源配置示例

quarkus.datasource.db-kind=postgresql
quarkus.datasource.username=<your_username>
quarkus.datasource.password=<your_password>

quarkus.datasource.jdbc.url=jdbc:postgresql://localhost:5432/hibernate_orm_test
quarkus.datasource.jdbc.max-size=16
Copy to Clipboard Toggle word wrap

2.1. 为 JDBC 数据源安装 Quarkus 扩展

您必须安装 quarkus-agroal 扩展,以及 Quarkus JDBC 数据库驱动程序扩展来配置 JDBC 数据源。您添加的 JDBC 数据库驱动程序必须与您要使用的 JDBC 数据库的类型匹配。

以下流程演示了如何为 JDBC 数据源安装 Quarkus 扩展。

先决条件

  • 您有一个 Quarkus Maven 项目。
  • 您已为数据源设置 db-kind 属性。

流程

  1. 进入 Quarkus 项目目录。
  2. 在项目中添加 quarkus-agroal 扩展:

    ./mvnw quarkus:add-extension -Dextensions="agroal"
    Copy to Clipboard Toggle word wrap
  3. 将适当的相关数据库驱动程序类型的 Quarkus 扩展添加到应用程序中:

    ./mvnw quarkus:add-extension -Dextensions="<extension>"
    Copy to Clipboard Toggle word wrap

    例如,要添加 PostgreSQL 数据库驱动程序扩展,请使用:

    ./mvnw quarkus:add-extension -Dextensions="jdbc-postgresql"
    Copy to Clipboard Toggle word wrap
注意

如果您使用 Hibernate ORM,则不需要显式添加 Agroal 扩展依赖关系。Agroal 是 Hibernate ORM 扩展的一个不可运行的依赖关系。您必须使用 JDBC 数据源驱动程序与 Hibernate ORM。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat