Ant configuredatabase 任务参考

configuredatabase Ant 任务的参考信息。本参考信息仅针对关系数据库。它不适用于 Cloudant®。

概述

configuredatabase Ant 任务创建由 MobileFirst Server 管理服务、MobileFirst Server 实时更新服务、MobileFirst Server 推送服务、MobileFirst 运行时和 Application Center 服务使用的关系数据库。此 Ant 任务通过以下操作配置关系数据库：

检查 MobileFirst 表是否存在，并根据需要创建这些表。
如果存在较低版本的 IBM MobileFirst™ Platform Foundation 的表，请将它们迁移至当前版本。
如果存在当前版本的 IBM MobileFirst Platform Foundation 的表，那么无需执行任何操作。

此外，如果满足以下条件之一：

DBMS 类型为 Derby。
存在内部元素 <dba>。
DBMS 类型为 DB2®，并且指定的用户具有创建数据库的许可权。

那么该任务可以产生以下影响：

根据需要创建数据库（Oracle 12c 和 Cloudant 除外）。
根据需要创建用户，并授予该用户访问该数据库的权利。

注：如果您将 configuredatabase Ant 任务与 Cloudant 一同使用，此任务将不会产生任何影响。

configuredatabase 任务的属性和元素

configuredatabase 任务具有以下属性：

表 1. configuredatabase Ant 任务的属性
属性	描述	必需	缺省值
kind	数据库的类型：在 MobileFirst Server 中为：MobileFirstRuntime、MobileFirstConfig、MobileFirstAdmin 或 push。在 Application Center 中为：ApplicationCenter。	是	无
includeConfigurationTables	指定是同时在实时更新服务和管理服务上还是仅在管理服务上执行数据库操作。值为 `true` 或 `false`。	否	`true`
execute	指定是否执行 configuredatabase Ant 任务。值为 `true` 或 `false`。	否	`true`

kind: IBM MobileFirst Platform Foundation V8.0.0 支持四种类型的数据库：MobileFirst 运行时使用 MobileFirstRuntime 数据库。MobileFirst Server 管理服务使用 MobileFirstAdmin 数据库。MobileFirst Server 实时更新服务使用 MobileFirstConfig 数据库。缺省情况下，使用 MobileFirstAdmin 类型创建。MobileFirst Server 推送服务使用 push 数据库。Application Center 使用 ApplicationCenter 数据库。
includeConfigurationTables: 只有当 kind 属性为 MobileFirstAdmin 时，才可以使用 includeConfigurationTables 属性。有效值可能为 true 或 false。当将此属性设置为 true 时，configuredatabase 任务将在单个运行中对管理服务数据库和实时更新服务数据库执行数据库操作。当将此属性设置为 false 时，configuredatabase 任务将只对管理服务数据库执行数据库操作。
execute: execute 属性将启用或禁用 configuredatabase Ant 任务的执行。有效值可能为 true 或 false。当将此属性设置为 false 时，configuredatabase 任务将不执行配置或数据库操作。

configuredatabase 任务支持以下元素：

表 2. configuredatabase Ant 任务的内部元素
元素	描述	计数
`<derby>`	Derby 的参数。	0..1
`<db2>`	DB2 的参数。	0..1
`<mysql>`	MySQL 的参数。	0..1
`<oracle>`	Oracle 的参数。	0..1
`<driverclasspath>`	JDBC 驱动程序类路径。	0..1

对于每种数据库类型，您可以使用 <property> 元素指定 JDBC 连接属性来访问该数据库。 <property> 元素具有以下属性：

表 3. `<property>` 元素的属性
属性	描述	必需	缺省值
name	属性的名称。	是	无
value	属性的值。	是	无

Apache Derby

<derby> 元素具有以下属性：

表 4. `<derby>` 元素的属性
属性	描述	必需	缺省值
数据库	数据库名称。	否	MFPDATA、MFPADM、MFPCFG、MFPPUSH 或 APPCNTR，取决于类型。
datadir	包含数据库的目录。	是	无
schema	模式名称。	否	MFPDATA、MFPCFG、MFPADMINISTRATOR、MFPPUSH 或 APPCENTER，取决于类型。

<derby> 元素支持以下元素：

表 5. `<derby>` 元素的内部元素
元素	描述	计数
`<property>`	JDBC 连接属性。	0..∞

有关可用属性，请参阅 Setting attributes for the database connection URL。

DB2

<db2> 元素具有以下属性：

表 6. `<db2>` 元素的属性
属性	描述	必需	缺省值
数据库	数据库名称。	否	MFPDATA、MFPADM、MFPCFG、MFPPUSH 或 APPCNTR，取决于类型。
server	数据库服务器的主机名。	是	无
port	数据库服务器上的端口。	否	50000
user	用于访问数据库的用户名。	是	无
password	用于访问数据库的密码。	否	交互式查询
instance	DB2 实例的名称。	否	取决于服务器
schema	模式名称。	否	取决于用户

有关 DB2 用户帐户的更多信息，请参阅 DB2 安全模型概述。

<db2> 元素支持以下元素：

表 7. `<db2>` 元素的内部元素
元素	描述	计数
`<property>`	JDBC 连接属性。	0..∞
`<dba>`	数据库管理员凭证。	0..1

有关可用属性，请参阅 IBM® Data Server Driver for JDBC and SQLJ 的属性。

内部元素 <dba> 指定数据库管理员的凭证。此元素具有以下属性：

表 8. DB2 数据库的 `<dba>` 元素的属性
属性	描述	必需	缺省值
user	用于访问数据库的用户名。	是	无
password	用于访问数据库的密码。	否	交互式查询

在 <dba> 元素中指定的用户必须具有 SYSADM 或 SYSCTRL DB2 特权。有关更多信息，请参阅权限概述。

<driverclasspath> 元素必须包含 DB2 JDBC 驱动程序和关联许可证的 JAR 文件。您可以通过以下某种方式检索这些文件：

从 DB2 JDBC Driver Versions 页面下载 DB2 JDBC 驱动程序。
或者从 DB2 服务器上的 DB2_INSTALL_DIR/java 目录访存 db2jcc4.jar 文件及其关联的 db2jcc_license_*.jar 文件。

不能通过使用 Ant 任务来指定表分配的详细信息，例如，表空间。要控制表空间，必须使用DB2 数据库和用户需求部分中的手动操作指示信息。

MySQL

元素 <mysql> 具有以下属性：

表 9. `<mysql>` 元素的属性
属性	描述	必需	缺省值
数据库	数据库名称。	否	MFPDATA、MFPADM、MFPCFG、MFPPUSH 或 APPCNTR，取决于类型。
server	数据库服务器的主机名。	是	无
port	数据库服务器上的端口。	否	3306
user	用于访问数据库的用户名。	是	无
password	用于访问数据库的密码。	否	交互式查询

有关 MySQL 用户帐户的更多信息，请参阅 MySQL 用户帐户管理。

<mysql> 元素支持以下元素：

表 10. `<mysql>` 元素的内部元素
元素	描述	计数
`<property>`	JDBC 连接属性。	0..∞
`<dba>`	数据库管理员凭证。	0..1
`<client>`	允许访问数据库的主机。	0..∞

有关可用属性，请参阅 Driver/Datasource Class Names, URL Syntax and Configuration Properties for Connector/J。

内部元素 <dba> 指定数据库管理员凭证。此元素具有以下属性：

表 11. MySQL 数据库的 `<dba>` 元素的属性
属性	描述	必需	缺省值
user	用于访问数据库的用户名。	是	无
password	用于访问数据库的密码。	否	交互式查询

在 <dba> 元素中指定的用户必须是 MySQL 超级用户帐户。有关更多信息，请参阅 Securing the Initial MySQL Accounts。

每个 <client> 内部元素指定一台客户端计算机或表示多台客户端计算机的通配符。这些计算机可以连接到数据库。此元素具有以下属性：

表 12. MySQL 数据库的 `<client>` 元素的属性
属性	描述	必需	缺省值
hostname	将 % 作为占位符的符号主机名、IP 地址或模板。	是	无

有关 hostname 语法的更多信息，请参阅 Specifying Account Names。

<driverclasspath> 元素必须包含一个 MySQL Connector/J JAR 文件。可以从 Download Connector/J 页面下载该文件。

或者，您可以将 <mysql> 元素与以下属性结合使用：

表 13. `<mysql>` 元素的替代属性
属性	描述	必需	缺省值
url	数据库连接 URL。	是	无
user	用于访问数据库的用户名。	是	无
password	用于访问数据库的密码。	否	交互式查询

注：如果使用替代属性指定数据库，该数据库和用户帐户都必须存在，数据库也必须能供用户访问。在这种情况下，configuredatabase 任务不会尝试创建数据库或用户，也不会尝试向用户授予访问权。configuredatabase 任务仅确保数据库具有当前 MobileFirst Server 版本的必需表。您无需指定内部元素 <dba> 或 <client>。

Oracle

元素 <oracle> 具有以下属性：

表 14. `<oracle>` 元素的属性
属性	描述	必需	缺省值
数据库	数据库名称或 Oracle 服务名称。注：必须始终使用服务名称来连接到 PDB 数据库。	否	ORCL
server	数据库服务器的主机名。	是	无
port	数据库服务器上的端口。	否	1521
user	用于访问数据库的用户名。请参阅此表下方的注释。	是	无
password	用于访问数据库的密码。	否	交互式查询
sysPassword	用户 `SYS` 的密码。	否	交互式查询（如果数据库尚不存在）
systemPassword	用户 `SYSTEM` 的密码。	否	交互式查询（如果数据库或用户尚不存在）

注：对于 user 属性，最好使用大写字母的用户名。Oracle 用户名通常为大写字母。不像其他数据库工具，configuredatabase Ant 任务不会将用户名中的小写字母转换为大写字母。如果 configuredatabase Ant 任务无法连接到您的数据库，请尝试用大写字母为 user 属性输入值。

有关 Oracle 用户帐户的更多信息，请参阅认证方法概述。

<oracle> 元素支持以下元素：

表 15. `<oracle>` 元素的内部元素
元素	描述	计数
`<property>`	JDBC 连接属性。	0..∞
`<dba>`	数据库管理员凭证。	0..1

有关可用连接属性的信息，请参阅 Class OracleDriver。

内部元素 <dba> 指定数据库管理员凭证。此元素具有以下属性：

表 16. Oracle 数据库的 `<dba>` 元素的属性
属性	描述	必需	缺省值
user	用于访问数据库的用户名。	是	无
password	用于访问数据库的密码。	否	交互式查询

<driverclasspath> 元素必须包含一个 Oracle JDBC 驱动程序 JAR 文件。可以从 JDBC, SQLJ, Oracle JPublisher and Universal Connection Pool (UCP) 下载 Oracle JDBC 驱动程序。

不能通过使用 Ant 任务来指定表分配的详细信息，例如，表空间。要控制表空间，可以手动创建用户帐户并在运行 Ant 任务之前向其分配缺省表空间。要控制其他详细信息，必须使用Oracle 数据库和用户需求部分中的手动操作指示信息。

或者，您可以将 <oracle> 元素与以下属性结合使用：

表 17. `<oracle>` 元素的替代属性
属性	描述	必需	缺省值
url	数据库连接 URL。	是	无
user	用于访问数据库的用户名。	是	无
password	用于访问数据库的密码。	否	交互式查询

注：如果使用替代属性指定数据库，该数据库和用户帐户都必须存在，数据库也必须能供用户访问。在这种情况下，任务不会尝试创建数据库或用户，也不会尝试向用户授予访问权。configuredatabase 任务仅确保数据库具有当前 MobileFirst Server 版本的必需表。您无需指定内部元素 <dba>。