12.3. 创建数据源

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

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

12.3.1. 创建非 XA 数据源

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

使用管理控制台定义非 XA 数据源
  1. 导航到 ConfigurationSubsystemsDatasources & DriversDatasources
  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
    注意

    在受管域中,您必须指定 --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
connection-url
有关支持的数据库的连接 URL 格式的详情,请查看 Datasource Connection URL 列表。

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