Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

管理数据库

以下存储过程管理数据库。

rdsadmin.create_database

创建一个数据库。

语法

db2 "call rdsadmin.create_database('database_name')"

参数

以下参数是必需参数：

以下参数为可选参数：

使用说明

如果您在使用 Amazon RDS 控制台或 Amazon CLI 创建 RDS for Db2 数据库实例时未指定数据库的名称，则可以通过调用 rdsadmin.create_database 来创建数据库。有关更多信息，请参阅 创建数据库实例。

特殊注意事项：

有关这些注意事项的更多信息，请参阅 IBM Db2 文档中的 CREATE DATABASE command。

在调用 rdsadmin.create_database 之前，必须连接到 rdsadmin 数据库。在以下示例中，将 master_username 和 master_password 替换为 RDS for Db2 数据库实例信息。

db2 connect to rdsadmin user master_username using master_password

有关检查创建数据库的状态的信息，请参阅rdsadmin.get_task_status。

示例

以下示例创建一个名为 TESTJP 的数据库，该数据库具有适用于日本的 database_code_set、database_territory 和 database_collation 参数的正确组合。

db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"

rdsadmin.drop_database

删除数据库。

语法

db2 "call rdsadmin.drop_database('database_name')"

参数

以下参数是必需参数：

使用说明

仅当满足以下条件时，才可以通过调用 rdsadmin.drop_database 来删除数据库：

在调用 rdsadmin.drop_database 之前，必须连接到 rdsadmin 数据库。在以下示例中，将 master_username 和 master_password 替换为 RDS for Db2 数据库实例信息。

db2 connect to rdsadmin user master_username using master_password

有关检查删除数据库的状态的信息，请参阅rdsadmin.get_task_status。

示例

以下示例删除名为 TESTDB 的数据库。

db2 "call rdsadmin.drop_database('TESTDB')"

响应示例

如果您传递的数据库名称不正确，则存储过程将返回以下响应示例。

SQL0438N Application raised error or warning with diagnostic text: "Cannot
drop database. Database with provided name does not exist". SQLSTATE=99993

如果您使用 Amazon RDS 控制台或 Amazon CLI 创建了数据库，则存储过程将返回以下响应示例。

Return Status = 0

收到 Return Status = 0 后，调用 rdsadmin.get_task_status 存储过程。类似于以下示例的响应解释了状态。

1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. 
Reason Dropping database created via rds CreateDBInstance api is not allowed. 
Only database created using rdsadmin.create_database can be dropped

rdsadmin.update_db_param

更新数据库参数。

语法

db2 "call rdsadmin.update_db_param(
    'database_name', 
    'parameter_to_modify', 
    'changed_value)"

参数

以下参数为必需参数：

使用说明

有关检查更新数据库参数的状态的信息，请参阅rdsadmin.get_task_status。

示例

以下示例将名为 TESTDB 的数据库的 archretrydelay 参数更新为 100。

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'archretrydelay', 
    '100')";

以下示例推迟了对名为 TESTDB 的数据库上创建的对象的验证，以避免依赖性检查。

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'auto_reval', 
    'deferred_force')"

rdsadmin.restore_database

还原数据库。

语法

db2 "call rdsadmin.restore_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    restore_timestamp, 
    'backup_type')"

参数

以下输出参数是必需参数：

以下输入参数是必需参数：

使用说明

如果您在使用 Amazon RDS 控制台或 Amazon CLI 创建 RDS for Db2 数据库实例时未指定数据库的名称，则可以通过调用 rdsadmin.restore_database 来还原数据库。有关更多信息，请参阅 创建数据库实例。

在还原数据库之前，您必须为 RDS for Db2 数据库实例预调配存储空间，其大小等于或大于磁盘上备份和原始 Db2 数据库的大小之和。还原备份时，Amazon RDS 会在您的 RDS for Db2 数据库实例上提取备份文件。

每个备份文件不得超过 5TB。如果备份文件超过 5 TB，则必须将备份文件拆分为较小的文件。

为确保 rdsadmin.restore_database 存储过程还原所有文件，请勿在文件名中的时间戳后加上文件号后缀。例如，s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 还原以下文件：

SAMPLE.0.rdsdb.DBPART000.20230615010101.001
SAMPLE.0.rdsdb.DBPART000.20230615010101.002
SAMPLE.0.rdsdb.DBPART000.20230615010101.003
SAMPLE.0.rdsdb.DBPART000.20230615010101.004
SAMPLE.0.rdsdb.DBPART000.20230615010101.005

有关检查还原数据库的状态的信息，请参阅rdsadmin.get_task_status。

要在还原数据库后使数据库联机并应用其它事务日志，请参阅rdsadmin.rollforward_database。

示例

以下示例使用带有 s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 的单个文件或多个文件还原脱机备份。

db2 "call rdsadmin.restore_database(
    ?,
    'SAMPLE',
    'myS3bucket',
    'backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101',
    20230615010101,
    'OFFLINE')"

rdsadmin.rollforward_database

通过调用 rdsadmin.restore_database 还原数据库后，使数据库联机并应用其它事务日志。

语法

db2 "call rdsadmin.rollforward_database(
    ?,
    'database_name',
    's3_bucket_name', 
    s3_prefix, 
    'rollfoward_to_option', 
    'complete_rollforward')"

参数

以下输出参数是必需参数：

以下输入参数是必需参数：

以下输入参数为可选参数：

使用说明

调用 rdsadmin.restore_database 后，必须调用 rollforward_database 以应用来自 S3 存储桶的归档日志。您还可以在调用 rdsadmin.restore_database 后使用此存储过程来还原其它事务日志。

如果将 complete_rollforward 设置为 FALSE，则您的数据库处于 ROLL-FORWARD PENDING 状态并处于脱机状态。要使数据库联机，您必须调用 rdsadmin.complete_rollforward。

有关检查向前滚动数据库的状态的信息，请参阅rdsadmin.get_task_status。

示例

以下示例向前滚动到包含事务日志的数据库的联机备份，然后使数据库联机。

db2 "call rdsadmin.rollforward_database(
    ?,
    null,
    null,
    'END_OF_LOGS',
    'TRUE')"

以下示例向前滚动到不带事务日志的数据库的联机备份，然后使数据库联机。

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'S3Bucket',
    'logsfolder/,
    'END_OF_BACKUP',
    'TRUE')"

以下示例向前滚动到包含事务日志的数据库的联机备份，但不会使数据库联机。

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    null,
    'onlinebackup/TESTDB',
    'END_OF_LOGS',
    'FALSE')"

以下示例向前滚动到包含其它事务日志的数据库的联机备份，但不会使数据库联机。

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'S3Bucket',
    'logsfolder/S0000155.LOG',
    'END_OF_LOGS',
    'FALSE')"

rdsadmin.complete_rollforward

从 ROLL-FORWARD PENDING 状态使数据库联机。

语法

db2 "call rdsadmin.complete_rollforward(
    ?,
    'database_name')"

参数

以下输出参数是必需参数：

以下输入参数是必需参数：

使用说明

如果您在 complete_rollforward 设置为 FALSE 的情况下调用了 rdsadmin.rollforward_database，则您的数据库处于 ROLL-FORWARD PENDING 状态并处于脱机状态。要完成向前滚动过程并使数据库联机，请调用 rdsadmin.complete_rollforward。

有关检查完成向前滚动过程的状态的信息，请参阅rdsadmin.get_task_status。

示例

以下示例使 TESTDB 数据库联机。

db2 "call rdsadmin.complete_rollfoward(
    ?,
    'TESTDB')"