常见参数验证数据库实例文件控制数据块变更跟踪反复检查存档重做日志备份存档重做日志执行完整备份执行增量备份执行表空间备份

执行 Oracle 数据库实例的常见 RMAN 任务

在下一节中，您可以了解如何在运行 Oracle 的 Amazon RDS 数据库实例上执行 Oracle Recovery Manager (RMAN) DBA 任务。为了提供托管服务体验，Amazon RDS 未提供数据库实例的 Shell 访问权限。并且它还限制了对需要高级权限的某些系统程序和表的访问。

您可以使用 Amazon RDS 包 rdsadmin.rdsadmin_rman_util 执行适用于 Oracle 的 Amazon RDS 数据库到磁盘的 RMAN 备份。rdsadmin.rdsadmin_rman_util 包支持完整和增量数据库文件备份、表空间备份和存档日志备份。

RMAN 备份使用 Amazon RDS 数据库实例主机上的存储空间。在执行备份时，将 Oracle 目录对象作为过程调用中的参数进行指定。将备份文件放在指定目录中。您可以使用默认目录（如 DATA_PUMP_DIR），或创建新目录。有关更多信息，请参阅在主数据存储空间中创建和删除目录。

在 RMAN 备份完成后，您可以从适用于 Oracle 的 Amazon RDS 数据库实例主机复制备份文件。您可能出于还原到非 RDS 主机目的或出于长期存储备份目的而执行此操作。例如，您可以将备份文件复制到 Amazon S3 存储桶。有关更多信息，请参阅使用 Amazon S3 集成。

RMAN 备份的备份文件保留在 Amazon RDS 数据库实例主机上，直到您手动删除它们。您可以使用 UTL_FILE.FREMOVE Oracle 过程从目录中删除文件。有关更多信息，请参阅 Oracle 文档中的 FREMOVE 过程。

在备份存档重做日志或执行包括存档重做日志的完整或增量备份时，重做日志保留必须设置为非零值。有关更多信息，请参阅保留存档重做日志。

注意

要备份和还原到另一个适用于 Oracle 的 Amazon RDS 数据库实例，您可以继续使用 Amazon RDS 备份和还原功能。有关更多信息，请参阅备份和还原 Amazon RDS 数据库实例。

目前，适用于 Oracle 的 Amazon RDS 数据库实例不支持 RMAN 还原。

主题

RMAN 过程的常见参数
验证数据库实例文件
启用和禁用数据块更改跟踪
反复检查存档重做日志
备份存档重做日志
执行完整数据库备份
执行增量数据库备份
执行表空间备份

RMAN 过程的常见参数

您可以使用 Amazon RDS 包 rdsadmin.rdsadmin_rman_util 中的过程来通过 RMAN 执行任务。有几个参数是包中的过程通用的。该包具有以下常见参数。

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_owner`	varchar2	`p_directory_name` 中指定的目录的有效拥有者。	—	是	包含备份文件的目录的拥有者。
`p_directory_name`	varchar2	有效的数据库目录名称。	–	是	包含备份文件的目录的名称。
`p_label`	varchar2	`a-z`、`A-Z`、`0-9`、`'_'`、`'-'`、`'.'`	—	否	包括在备份文件名中的唯一字符串。注意限制为 30 个字符。
`p_compress`	布尔值	`TRUE`、`FALSE`	`FALSE`	否	指定 `TRUE` 以启用基本备份压缩。指定 `FALSE` 以禁用基本备份压缩。
`p_include_archive_logs`	布尔值	`TRUE`、`FALSE`	`FALSE`	否	指定 `TRUE` 以在备份中包括存档重做日志。指定 `FALSE` 以从备份中排除存档重做日志。如果您在备份中包括存档重做日志，请使用 `rdsadmin.rdsadmin_util.set_configuration` 过程将保留设置为一小时或更长时间。另外，就在要运行备份之前调用 `rdsadmin.rdsadmin_rman_util.crosscheck_archivelog` 过程。否则，由于缺少已被 Amazon RDS 管理过程删除的存档重做日志文件，备份可能会失败。
`p_include_controlfile`	布尔值	`TRUE`、`FALSE`	`FALSE`	否	指定 `TRUE` 以在备份中包括控制文件。指定 `FALSE` 以从备份中排除控制文件。
`p_optimize`	布尔值	`TRUE`、`FALSE`	`TRUE`	否	指定 `TRUE` 以启用备份优化（如果包括存档重做日志）以减小备份大小。指定 `FALSE` 以禁用备份优化。
`p_parallel`	number	对于 Oracle Database 企业版 (EE)，为介于 `1` 和 `254` 之间的有效整数。对于其他 Oracle Database 版本为 `1`。	`1`	否	通道数。
`p_rman_to_dbms_output`	布尔值	`TRUE`、`FALSE`	`FALSE`	否	为 `TRUE` 时，在 `DBMS_OUTPUT` 目录中的文件之外，RMAN 输出还发送到 `BDUMP` 包。在 SQL*Plus 中，使用 `SET SERVEROUTPUT ON` 查看输出。为 `FALSE` 时，RMAN 输出只发送到 `BDUMP` 目录中的文件。
`p_section_size_mb`	number	有效的整数	`NULL`	否	扇区大小，以兆字节 (MB) 为单位。通过将每个文件拆分为指定扇区大小来并行验证。为 `NULL` 时将忽略参数。
`p_validation_type`	varchar2	`'PHYSICAL'`、`'PHYSICAL+LOGICAL'`	`'PHYSICAL'`	否	检测损坏的程度。指定 `'PHYSICAL'` 检查物理损坏。物理损坏的例子包括数据块在标头和脚注中不匹配。指定 `'PHYSICAL+LOGICAL'` 在物理损坏之外，还检查逻辑不一致的情况。逻辑损坏的例子包括数据块损坏。

验证数据库实例文件

您可以使用 Amazon RDS 包 rdsadmin.rdsadmin_rman_util 验证适用于 Oracle 的 Amazon RDS 数据库实例文件，例如数据文件、表空间、控制文件或服务器参数文件 (SPFILE)。

有关 RMAN 验证的更多信息，请参阅验证数据库文件和备份以及 Oracle 文档中的 VALIDATE。

主题

验证数据库实例
验证表空间
验证控制文件
验证 SPFILE
验证数据文件

验证数据库实例

要验证 Amazon RDS Oracle 数据库实例使用的所有相关文件，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.validate_database。

该过程使用 RMAN 任务的以下常见参数：

p_validation_type
p_parallel
p_section_size_mb
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

以下示例使用参数的默认值来验证数据库实例。


exec rdsadmin.rdsadmin_rman_util.validate_database;

以下示例使用参数的指定值来验证数据库实例。


BEGIN rdsadmin.rdsadmin_rman_util.validate_database( p_validation_type => 'PHYSICAL+LOGICAL', p_parallel => 4, p_section_size_mb => 10, p_rman_to_dbms_output => FALSE); END; /

当 p_rman_to_dbms_output 参数设置为 FALSE 时，RMAN 输出写入到 BDUMP 目录中的文件。

要查看 BDUMP 目录中的文件，请运行以下 SELECT 语句。



SELECT * FROM table(rdsadmin.rds_file_util.listdir('BDUMP')) order by mtime;

要查看 BDUMP 目录中文件的内容，请运行以下 SELECT 语句。



SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','rds-rman-validate-nnn.txt'));

将文件名替换为您要查看的文件的名称。

验证表空间

要验证与表空间关联的文件，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.validate_tablespace。

该过程使用 RMAN 任务的以下常见参数：

p_validation_type
p_parallel
p_section_size_mb
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

此过程还使用以下其他参数。

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_tablespace_name`	varchar2	有效的空间表名称	—	是	表空间的名称。

验证控制文件

要仅验证 Amazon RDS Oracle 数据库实例使用的控制文件，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.validate_current_controlfile。

该过程使用 RMAN 任务的以下常见参数：

p_validation_type
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

验证 SPFILE

要仅验证 Amazon RDS Oracle 数据库实例使用的服务器参数文件 (SPFILE)，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.validate_spfile。

该过程使用 RMAN 任务的以下常见参数：

p_validation_type
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

验证数据文件

要验证数据文件，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.validate_datafile。

该过程使用 RMAN 任务的以下常见参数：

p_validation_type
p_parallel
p_section_size_mb
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

此过程还使用以下其他参数。

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_datafile`	varchar2	有效的数据文件 ID 编号或包含完整路径的有效数据文件名称	—	是	数据文件 ID 编号（来自 `v$datafile.file#`）或包含路径的完整数据文件名（来自 `v$datafile.name`）。
`p_from_block`	number	有效的整数	`NULL`	否	在数据文件中开始验证的块的编号。当这为 `NULL` 时，将使用 `1`。
`p_to_block`	number	有效的整数	`NULL`	否	在数据文件中结束验证的块的编号。当这为 `NULL` 时，将使用数据文件中的最大块。

启用和禁用数据块更改跟踪

数据库更改跟踪记录更改了跟踪文件中的数据块。此技术可以提高增量备份的性能。有关详细信息，请参阅 Oracle 数据库文档中的使用数据块更改跟踪来提高增量备份性能。

要为数据库实例启用数据块更改跟踪，您可以使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.enable_block_change_tracking。要禁用数据块更改跟踪，请使用 disable_block_change_tracking。这些过程不需要任何参数。

只读副本支持数据块更改跟踪。如果从使用数据块更改跟踪的源数据库创建只读副本，则副本将使用数据块更改跟踪。您无法对装载的副本启用数据块更改跟踪。如果将装载的副本置于只读模式，则不会启用数据块更改跟踪，但您可以使用 enable_block_change_tracking 启用它。如果将 Oracle 副本提升到源数据库，则可以像对任何其他 Oracle 数据库实例一样使用数据块更改跟踪。

以下数据库引擎版本支持数据块更改跟踪过程：

12.1.0.2.v15 或更高的 12.1 版本
12.2.0.1.ru-2019-01.rur-2019-01.r1 或更高的 12.2 版本
所有 18.0.0.0 版本
所有 19.0.0.0 版本

注意

在单租户 CDB 中，以下操作有效，但没有客户可见的机制可以检测操作的当前状态。另请参阅单租户 CDB 的限制。

要确定是否为您的数据库实例启用了块更改跟踪，请运行以下查询。


SELECT STATUS, FILENAME FROM V$BLOCK_CHANGE_TRACKING;

以下示例为数据库实例启用块更改跟踪。


EXEC rdsadmin.rdsadmin_rman_util.enable_block_change_tracking;

以下示例为数据库实例禁用块更改跟踪。


EXEC rdsadmin.rdsadmin_rman_util.disable_block_change_tracking;

反复检查存档重做日志

您可以使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.crosscheck_archivelog 反复检查存档重做日志。

您可以使用此过程反复检查控制文件中注册的存档重做日志并可以选择删除过期的日志记录。当 RMAN 进行备份时，它会在控制文件中创建一条记录。随着时间的推移，这些记录会增加控制文件的大小。我们建议您定期删除过期的记录。

注意

标准 Amazon RDS 备份不使用 RMAN，因此不会在控制文件中创建记录。

该过程使用 RMAN 任务的常见参数 p_rman_to_dbms_output。

有关更多信息，请参阅 RMAN 过程的常见参数。

此过程还使用以下其他参数。

参数名称数据类型有效值默认值是否必需描述

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_delete_expired`	布尔值	`TRUE`、`FALSE`	`TRUE`	否	当为 `TRUE` 时，从控制文件中删除过期的存档重做日志记录。当为 `FALSE` 时，保留控制文件中过期的存档重做日志记录。

p_delete_expired

布尔值

TRUE、FALSE

TRUE

否

当为 TRUE 时，从控制文件中删除过期的存档重做日志记录。

当为 FALSE 时，保留控制文件中过期的存档重做日志记录。

以下适用于 Oracle 的 Amazon RDS 数据库引擎版本支持此过程：

12.1.0.2.v15 或更高的 12.1 版本
12.2.0.1.ru-2019-01.rur-2019-01.r1 或更高的 12.2 版本
所有 18.0.0.0 版本
所有 19.0.0.0 版本

以下示例将控制文件中存档的重做日志记录标记为已过期，但不删除这些记录。


BEGIN rdsadmin.rdsadmin_rman_util.crosscheck_archivelog( p_delete_expired => FALSE, p_rman_to_dbms_output => FALSE); END; /

以下示例从控制文件中删除过期的存档重做日志记录。


BEGIN rdsadmin.rdsadmin_rman_util.crosscheck_archivelog( p_delete_expired => FALSE, p_rman_to_dbms_output => FALSE); END; /

备份存档重做日志

您可以使用 Amazon RDS 包 rdsadmin.rdsadmin_rman_util 备份 Amazon RDS Oracle 数据库实例的存档重做日志。

以下适用于 Oracle 的 Amazon RDS 数据库引擎版本支持备份存档重做日志的过程：

12.1.0.2.v15 或更高的 12.1 版本
12.2.0.1.ru-2019-01.rur-2019-01.r1 或更高的 12.2 版本
所有 18.0.0.0 版本
所有 19.0.0.0 版本

主题

备份所有存档重做日志
备份日期范围中的存档重做日志
备份 SCN 范围中的存档重做日志
备份序列号范围中的存档重做日志

备份所有存档重做日志

要备份 Amazon RDS Oracle 数据库实例的所有存档重做日志，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.backup_archivelog_all。

该过程使用 RMAN 任务的以下常见参数：

p_owner
p_directory_name
p_label
p_parallel
p_compress
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

以下示例备份数据库实例的所有存档重做日志。



BEGIN rdsadmin.rdsadmin_rman_util.backup_archivelog_all( p_owner => 'SYS', p_directory_name => 'MYDIRECTORY', p_parallel => 4, p_rman_to_dbms_output => FALSE); END; /

备份日期范围中的存档重做日志

要指定日期范围以备份 Amazon RDS Oracle 数据库实例的特定存档重做日志，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.backup_archivelog_date。日期范围指定要备份哪些存档重做日志。

该过程使用 RMAN 任务的以下常见参数：

p_owner
p_directory_name
p_label
p_parallel
p_compress
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

此过程还使用以下其他参数。

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_from_date`	date	介于磁盘上存在的存档重做日志的 `start_date` 和 `next_date` 之间的日期。该值必须小于或等于为 `p_to_date` 指定的值。	—	是	存档日志备份的起始日期。
`p_to_date`	date	介于磁盘上存在的存档重做日志的 `start_date` 和 `next_date` 之间的日期。该值必须大于或等于为 `p_from_date` 指定的值。	—	是	存档日志备份的结束日期。

以下示例备份数据库实例的日期范围中的存档重做日志。



BEGIN rdsadmin.rdsadmin_rman_util.backup_archivelog_date( p_owner => 'SYS', p_directory_name => 'MYDIRECTORY', p_from_date => '03/01/2019 00:00:00', p_to_date => '03/02/2019 00:00:00', p_parallel => 4, p_rman_to_dbms_output => FALSE); END; /

备份 SCN 范围中的存档重做日志

要指定系统更改号 (SCN) 范围以备份 Amazon RDS Oracle 数据库实例的特定存档重做日志，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.backup_archivelog_scn。SCN 范围指定要备份哪些存档重做日志。

该过程使用 RMAN 任务的以下常见参数：

p_owner
p_directory_name
p_label
p_parallel
p_compress
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

此过程还使用以下其他参数。

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_from_scn`	number	磁盘上存在的存档重做日志的 SCN。该值必须小于或等于为 `p_to_scn` 指定的值。	—	是	存档日志备份的起始 SCN。
`p_to_scn`	number	磁盘上存在的存档重做日志的 SCN。该值必须大于或等于为 `p_from_scn` 指定的值。	—	是	存档日志备份的结束 SCN。

以下示例备份数据库实例的 SCN 范围中的存档重做日志。



BEGIN rdsadmin.rdsadmin_rman_util.backup_archivelog_scn( p_owner => 'SYS', p_directory_name => 'MYDIRECTORY', p_from_scn => 1533835, p_to_scn => 1892447, p_parallel => 4, p_rman_to_dbms_output => FALSE); END; /

备份序列号范围中的存档重做日志

要指定序列号范围以备份 Amazon RDS Oracle 数据库实例的特定存档重做日志，请使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.backup_archivelog_sequence。序列号范围指定要备份哪些存档重做日志。

该过程使用 RMAN 任务的以下常见参数：

p_owner
p_directory_name
p_label
p_parallel
p_compress
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

此过程还使用以下其他参数。

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_from_sequence`	number	磁盘上存在的存档重做日志的序列号。该值必须小于或等于为 `p_to_sequence` 指定的值。	—	是	存档日志备份的起始序列号。
`p_to_sequence`	number	磁盘上存在的存档重做日志的序列号。该值必须大于或等于为 `p_from_sequence` 指定的值。	—	是	存档日志备份的结束序列号。

以下示例备份数据库实例的序列号范围中的存档重做日志。


BEGIN rdsadmin.rdsadmin_rman_util.backup_archivelog_sequence( p_owner => 'SYS', p_directory_name => 'MYDIRECTORY', p_from_sequence => 11160, p_to_sequence => 11160, p_parallel => 4, p_rman_to_dbms_output => FALSE); END; /

执行完整数据库备份

您可以使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.backup_database_full 执行备份中包括的所有数据块文件的备份。

该过程使用 RMAN 任务的以下常见参数：

p_owner
p_directory_name
p_label
p_parallel
p_section_size_mb
p_include_archive_logs
p_optimize
p_compress
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

以下适用于 Oracle 的 Amazon RDS 数据库引擎版本支持此过程：

12.1.0.2.v15 或更高的 12.1 版本
12.2.0.1.ru-2019-01.rur-2019-01.r1 或更高的 12.2 版本
所有 18.0.0.0 版本
所有 19.0.0.0 版本

以下示例使用参数的指定值来执行数据库实例的完整备份。


BEGIN rdsadmin.rdsadmin_rman_util.backup_database_full( p_owner => 'SYS', p_directory_name => 'MYDIRECTORY', p_parallel => 4, p_section_size_mb => 10, p_rman_to_dbms_output => FALSE); END; /

执行增量数据库备份

您可以使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.backup_database_incremental 执行数据库实例的增量备份。

有关增量备份的更多信息，请参阅 Oracle 文档中的增量备份。

该过程使用 RMAN 任务的以下常见参数：

p_owner
p_directory_name
p_label
p_parallel
p_section_size_mb
p_include_archive_logs
p_include_controlfile
p_optimize
p_compress
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

以下适用于 Oracle 的 Amazon RDS 数据库引擎版本支持此过程：

12.1.0.2.v15 或更高的 12.1 版本
12.2.0.1.ru-2019-01.rur-2019-01.r1 或更高的 12.2 版本
所有 18.0.0.0 版本
所有 19.0.0.0 版本

此过程还使用以下其他参数。

参数名称数据类型有效值默认值是否必需描述

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_level`	number	`0`、`1`	`0`	否	指定 `0` 以启用完整增量备份。指定 `1` 以启用非累积增量备份。

p_level

number

0、1

0

否

指定 0 以启用完整增量备份。

指定 1 以启用非累积增量备份。

以下示例使用参数的指定值来执行数据库实例的增量备份。


BEGIN rdsadmin.rdsadmin_rman_util.backup_database_incremental( p_owner => 'SYS', p_directory_name => 'MYDIRECTORY', p_level => 1, p_parallel => 4, p_section_size_mb => 10, p_rman_to_dbms_output => FALSE); END; /

执行表空间备份

您可以使用 Amazon RDS 过程 rdsadmin.rdsadmin_rman_util.backup_tablespace 执行数据库实例表空间备份。

该过程使用 RMAN 任务的以下常见参数：

p_owner
p_directory_name
p_label
p_parallel
p_section_size_mb
p_include_archive_logs
p_include_controlfile
p_optimize
p_compress
p_rman_to_dbms_output

有关更多信息，请参阅 RMAN 过程的常见参数。

此过程还使用以下其他参数。

参数名称	数据类型	有效值	默认值	是否必需	描述
`p_tablespace_name`	varchar2	有效的空间表名称。	—	是	要备份的表空间的名称。

以下适用于 Oracle 的 Amazon RDS 数据库引擎版本支持此过程：

12.1.0.2.v15 或更高的 12.1 版本
12.2.0.1.ru-2019-01.rur-2019-01.r1 或更高的 12.2 版本
所有 18.0.0.0 版本
所有 19.0.0.0 版本

以下示例使用参数的指定值来执行表空间备份。


BEGIN rdsadmin.rdsadmin_rman_util.backup_tablespace( p_owner => 'SYS', p_directory_name => 'MYDIRECTORY', p_tablespace_name => MYTABLESPACE, p_parallel => 4, p_section_size_mb => 10, p_rman_to_dbms_output => FALSE); END; /

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

日志任务

Oracle 计划程序任务