Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

12.3. 创建数据源

可以使用管理控制台或管理 CLI 创建数据源。

JBoss EAP 7 允许您在数据源属性值中使用表达式，如 enabled 属性。有关在配置中使用表达式的详情，请参阅 属性替换 部分。

12.3.1. 创建非 XA 数据源
复制链接

您可以使用管理 CLI 或管理控制台创建非 XA 数据源。

使用管理控制台定义非 XA 数据源

  1. 进入 standalone 或 domain mode 中的 datasources。

    • 在独立模式中使用以下导航：

      Configuration Subsystems Datasources & Drivers Datasources

    • 在域模式中使用以下导航：

      configuration Profiles full Datasources & Drivers Datasources

  2. 单击添加(+)按钮，然后选择 Add Datasource。
  3. 它将打开 Add Datasource 向导，您可以在其中选择数据源类型并点击 Next。这会为您的数据库创建一个模板。向导的以下页面预先填充了特定于所选数据源的值。这使得数据源创建过程变得简单。
  4. 您可以在 Test Connection 页面上测试您的连接，然后完成数据源创建过程。
  5. 检查详情，再单击 Finish 以创建数据源。
使用管理 CLI 定义非 XA 数据源

可以使用 数据源添加管理 CLI 命令来定义非 X A 数据源。

  1. 如果您还没有这样做，请安装相应的 JDBC 驱动程序并将其注册为核心模块。

  2. 使用 data-source add 命令定义数据源，并指定适当的参数值。 

    data-source add --name=DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME  --connection-url=CONNECTION_URL  --user-name=USER_NAME --password=PASSWORD
    Copy to Clipboard Toggle word wrap
    注意

    在受管域中，您必须指定 --profile=PROFILE_NAME 参数。

    有关这些参数值的提示，请参见下面的 Datasource Parameters 部分。

具体 示例，请参阅支持的数据库的 Datasource 配置 示例。

数据源参数
jndi-name
数据源的 JNDI 名称必须以 java:/ 或 java :jboss/ 开头。例如，java:jboss/datasources/ExampleDS.
driver-name

驱动程序名称值取决于 JDBC 驱动程序是作为核心模块安装的还是 JAR 部署。

  1. 对于核心模块，驱动程序名称值将是其注册时为 JDBC 驱动程序提供的名称。

  2. 对于 JAR 部署，如果其 /META-INF/services/java.sql.Driver 文件中仅列出一个类，则驱动程序名称是 JAR 的名称。如果列出多个类，则值为 JAR_NAME + "_ " + DRIVER_CLASS_NAME + "_ " + MAJOR_VERSION + "_" + MINOR_VERSION （例如，） mysql-connector-java-5.1.36-bin.jar_com.mysql.cj.jdbc.Driver_5_1）.

    部署 JDBC JAR 时，您还可以查看 JBoss EAP 服务器日志中的驱动程序名称。 

    WFLYJCA0018: Started Driver service with driver-name = mysql-connector-java-5.1.36-bin.jar_com.mysql.cj.jdbc.Driver_5_1
    Copy to Clipboard Toggle word wrap
connection-url
有关支持的数据库的连接 URL 格式的详情，请查看 Datasource Connection URL 列表。

有关所有可用数据源属性的完整列表，请参阅 Datasource Attributes 部分。

user-name
创建新数据源连接时使用的用户名。
password
创建新数据源连接时使用的密码。

12.3.2. 创建 XA 数据源
复制链接

您可以使用管理 CLI 或管理控制台创建 XA 数据源。

使用管理控制台定义 XA 数据源

  1. 进入 standalone 或 domain mode 中的 datasources。

    • 在独立模式中使用以下导航：

      Configuration Subsystems Datasources & Drivers Datasources

    • 在域模式中使用以下导航：

      configuration Profiles full Datasources & Drivers Datasources

  2. 单击添加(+)按钮，然后选择 Add XA Datasource。
  3. 它打开 Add XA Datasource 向导，您可以在其中选择数据源类型并点击 Next。这会为您的数据库创建一个模板。向导的以下页面预先填充了特定于所选数据源的值。这使得数据源创建过程变得简单。
  4. 您可以在 Test Connection 页面上测试您的连接，然后完成数据源创建过程。
  5. 检查详情，再单击 Finish 以创建数据源。
使用管理 CLI 定义 XA 数据源

XA 数据源可以使用 the xa-data-source add management CLI 命令来定义。

注意

在受管域中，您将需要指定要使用的配置文件。根据管理 CLI 命令的格式，您将在命令前面使用 /profile=PROFILE_NAME，或者传递 --profile=PROFILE_NAME 参数。

  1. 如果您还没有这样做，请安装相应的 JDBC 驱动程序并将其注册为核心模块。

  2. 使用 the xa-data-source add 命令定义数据源，并指定适当的参数值。 

    xa-data-source add --name=XA_DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME --xa-datasource-class=XA_DATASOURCE_CLASS --xa-datasource-properties={"ServerName"=>"HOST_NAME","DatabaseName"=>"DATABASE_NAME"}
    Copy to Clipboard Toggle word wrap

    有关这些参数值的提示，请参见下面的 Datasource Parameters 部分。

  3. 设置 XA 数据源属性.

    定义 XA 数据源时至少需要一个 XA 数据源属性，或者在上一步中添加数据源时会收到错误。在定义 XA 数据源时未设置的任何属性都可以在之后单独设置。

    1. 设置服务器名称。 

      /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=ServerName:add(value=HOST_NAME)
      Copy to Clipboard Toggle word wrap

    2. 设置数据库名称。 

      /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=DatabaseName:add(value=DATABASE_NAME)
      Copy to Clipboard Toggle word wrap

具体 示例，请参阅支持的数据库的 Datasource 配置 示例。

数据源参数
jndi-name
数据源的 JNDI 名称必须以 java:/ 或 java :jboss/ 开头。例如，java:jboss/datasources/ExampleDS.
driver-name

驱动程序名称值取决于 JDBC 驱动程序是作为核心模块安装的还是 JAR 部署。

  1. 对于核心模块，驱动程序名称值将是其注册时为 JDBC 驱动程序提供的名称。

  2. 对于 JAR 部署，如果其 /META-INF/services/java.sql.Driver 文件中仅列出一个类，则驱动程序名称是 JAR 的名称。如果列出了多个类，则值为 JAR_NAME + "_ " + DRIVER_CLASS_NAME + "_" + MAJOR_VERSION + "_" + MINOR_VERSION，例如： mysql-connector-java-5.1.36-bin.jar_com.mysql.cj.jdbc.Driver_5_1.

    部署 JDBC JAR 时，您还可以查看 JBoss EAP 服务器日志中的驱动程序名称。 

    WFLYJCA0018: Started Driver service with driver-name = mysql-connector-java-5.1.36-bin.jar_com.mysql.cj.jdbc.Driver_5_1
    Copy to Clipboard Toggle word wrap
xa-datasource-class
指定 javax.sql.XADataSource 类的 JDBC 驱动程序实施的 XA 数据源类。
xa-datasource-properties
定义 XA 数据源时至少需要一个 XA 数据源属性，否则在尝试添加时会收到错误。其他属性也可以在定义后添加到 XA 数据源中。

有关所有可用数据源属性的完整列表，请参阅 Datasource Attributes 部分。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat