12.3. 创建数据源
可以使用管理控制台或管理 CLI 创建数据源。
JBoss EAP 7 允许您在数据源属性值中使用表达式,如 enabled
属性。有关在配置中使用表达式的详情,请参阅属性替换部分。
12.3.1. 创建非 XA 数据源
您可以使用管理 CLI 或管理控制台创建非 XA 数据源。
使用管理控制台定义非 XA 数据源
-
导航到 Configuration
Subsystems Datasources & Drivers Datasources。 - 单击添加(+)按钮,然后选择 Add Datasource。
- 它将打开 Add Datasource 向导,您可以在其中选择数据源类型并点击 Next。这会为您的数据库创建一个模板。向导的以下页面预先填充了特定于所选数据源的值。这使得数据源创建过程变得简单。
- 您可以在 Test Connection 页面上测试您的连接,然后完成数据源创建过程。
- 检查详情,再单击 Finish 以创建数据源。
使用管理 CLI 定义非 XA 数据源
可以使用 数据源添加管理 CLI 命令来定义非 X
A 数据源。
- 如果您还没有这样做,请安装相应的 JDBC 驱动程序并将其注册为核心模块。
使用
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 部署。
- 对于核心模块,驱动程序名称值将是其注册时为 JDBC 驱动程序提供的名称。
对于 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 部分。