12.4.3. 数据源环境变量
DB_SERVICE_PREFIX_MAPPING
定义要配置的数据源的逗号分隔列表。
例如:
DB_SERVICE_PREFIX_MAPPING=test-mysql=TEST_MYSQL
.如需更多信息,请参阅配置 Persistent Datasources。${NAME}_${DATABASE_TYPE}_SERVICE_HOST
定义数据源
connection_url
属性的数据库服务器主机名或 IP。例如:
EXAMPLE_MYSQL_SERVICE_HOST=192.0.2.0
${NAME}_${DATABASE_TYPE}_SERVICE_PORT
- 定义数据库服务器端口。
${PREFIX}_USERNAME
- 定义数据源的用户。
${PREFIX}_PASSWORD
- 定义数据源的密码。
${PREFIX}_DATABASE
定义数据源的数据库名称。
例如,
CLOUD_DATABASE=myDatabase
。${PREFIX}_DRIVER
为数据源定义 Java 数据库驱动程序。
例如,
CLOUD_DRIVER=postgresql
${PREFIX}_BACKGROUND_VALIDATION
-
指定后台线程是否在使用前验证数据库连接。值为
true
或false
(默认)。默认情况下启用 <validate-on-match&
gt; 方法。 ${PREFIX}_BACKGROUND_VALIDATION_MILLIS
-
如果您将
${PREFIX}_BACKGROUND_VALIDATION
环境变量设置为true
,则指定以毫秒为单位验证的频率。默认值为10000
。 ${PREFIX}_CONNECTION_CHECKER
指定用于验证与数据库的连接的连接检查器类。
例如,
CLOUD_CONNECTION_CHECKER=org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker
${PREFIX}_EXCEPTION_SORTER
指定在致命数据库连接异常时检测和清理异常分类器类。
例如,
CLOUD_EXCEPTION_SORTER=org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter
${PREFIX}_JNDI
定义数据源的 JNDI 名称。
默认为
java:jboss/datasources/<name>_<database_type>
。启动脚本自动从DB_SERVICE_PREFIX_MAPPING
环境变量生成值。例如,
CLOUD_JNDI=java:jboss/datasources/test-postgresql
${PREFIX}_JTA
-
定义非 XA 数据源的 Java 事务 API(JTA)选项。值为
true
(默认)或false
。 ${PREFIX}_MAX_POOL_SIZE
- 定义数据源的最大池大小。
${PREFIX}_MIN_POOL_SIZE
- 定义数据源的最小池大小。
${PREFIX}_NONXA
-
将数据源定义为非 XA 数据源。值为
true
或false
(默认)。 ${PREFIX}_TX_ISOLATION
定义数据库的 java.sql.Connection 事务隔离级别。
例如,
CLOUD_TX_ISOLATION=TRANSACTION_READ_UNCOMMITTED
${PREFIX}_URL
定义非 XA 数据源的连接 URL。
如果没有指定连接 URL,启动脚本会自动从其他环境变量生成它,如下所示:
url="jdbc:${DRIVER}://${HOST}:${PORT}/${DATABASE}"
.但是,启动脚本只为 PostgreSQL 和 MySQL 等内部数据源构建正确的连接 URL。如果使用任何其他非 XA 数据源,则必须指定连接 URL。
例如,
CLOUD_URL=jdbc:postgresql://localhost:5432/postgresdb
${PREFIX}_XA_CONNECTION_PROPERTY_<PROPERTY_NAME>
定义 XA 数据源的连接属性。
请参考相应的驱动程序文档,以使数据源查找可在连接上设置哪些 XA 属性。
例如,
CLOUD_XA_CONNECTION_PROPERTY_DatabaseName=/opt/eap/standalone/data/databases/db/accounts
这个示例在配置中添加以下内容:
<xa-datasource-property name="DatabaseName">/opt/eap/standalone/data/databases/db/accounts</xa-datasource-property>