使用 Oracle 可传输表空间进行迁移

以 Oracle 主目录的所有者身份登录到您的源主机。

确保 ORACLE_HOME 和 ORACLE_SID 环境变量指向您的源数据库。

以管理员身份登录数据库，并验证时区版本、数据库字符集和国家/地区字符集是否与目标数据库中相同。

SELECT * FROM V$TIMEZONE_FILE;
SELECT * FROM NLS_DATABASE_PARAMETERS 
  WHERE PARAMETER IN ('NLS_CHARACTERSET','NLS_NCHAR_CHARACTERSET');

按照 Oracle 支持说明 2471245.1 中所述，设置可传输表空间实用程序。

安装包括在源主机上编辑 xtt.properties 文件。以下示例 xtt.properties 文件指定 /dsk1/backups 目录中三个表空间的备份。这些是您打算传输到目标数据库实例的表空间。它还指定源平台 ID 以自动转换字节顺序。

#linux system 
platformid=13
#list of tablespaces to transport
tablespaces=TBS1,TBS2,TBS3
#location where backup will be generated
src_scratch_location=/dsk1/backups
#RMAN command for performing backup
usermantransport=1

如果您的表空间处于只读模式，请以具有 ALTER TABLESPACE 权限的用户身份登录到源数据库，并将表空间置于读/写模式。否则，请跳到下一步。

以下示例将 tbs1、tbs2 和 tbs3 置于读/写模式。

ALTER TABLESPACE tbs1 READ WRITE;
ALTER TABLESPACE tbs2 READ WRITE;
ALTER TABLESPACE tbs3 READ WRITE;

使用 xttdriver.pl 脚本备份您的表空间。或者，您可以指定 --debug 以在调试模式下运行脚本。

export TMPDIR=location_of_log_files
cd location_of_xttdriver.pl
$ORACLE_HOME/perl/bin/perl xttdriver.pl --backup

启动 SQL*Plus 或 Oracle SQL Developer，并登录到 RDS for Oracle 数据库实例。

使用 Amazon RDS 过程 rdsadmin.rdsadmin_s3_tasks.download_from_s3 将备份从 Amazon S3 桶下载到您的目标数据库实例。以下示例将所有文件从名为 amzn-s3-demo-bucket 的 Amazon S3 存储桶下载到 DATA_PUMP_DIR 目录中。

EXEC UTL_FILE.FREMOVE ('DATA_PUMP_DIR', 'res.txt');
SELECT rdsadmin.rdsadmin_s3_tasks.download_from_s3(
  p_bucket_name    =>  'amzn-s3-demo-bucket',
  p_directory_name =>  'DATA_PUMP_DIR') 
AS TASK_ID FROM DUAL;

SELECT 语句返回 VARCHAR2 数据类型的任务 ID。有关更多信息，请参阅 将文件从 Amazon S3 存储桶下载到 Oracle 数据库实例。

启动 Oracle SQL 客户端，并以主用户身份登录到目标 RDS for Oracle 数据库实例。

运行过程 rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces，同时指定要导入的表空间和包含备份的目录。

以下示例从 DATA_PUMP_DIR 目录中导入表空间 TBS1、TBS2 和 TBS3。源平台是基于 AIX 的系统（64 位），其平台 ID 为 6。您可以通过查询 V$TRANSPORTABLE_PLATFORM 查找平台 ID。

VAR task_id CLOB

BEGIN
  :task_id:=rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces(
        'TBS1,TBS2,TBS3',
        'DATA_PUMP_DIR',
        p_platform_id => 6);
END;
/

PRINT task_id

（可选）通过查询表 rdsadmin.rds_xtts_operation_info 来监控进度。xtts_operation_state 列显示值 EXECUTING、COMPLETED 或 FAILED。

SELECT * FROM rdsadmin.rds_xtts_operation_info;

使用上一步中的任务 ID 查看已完成的导入的日志。

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||'&task_id'||'.log'));

在继续下一步之前，请确保导入成功。

启动 Oracle SQL 客户端，并以主用户身份登录到目标 RDS for Oracle 数据库实例。

运行过程 rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces，同时指定要导入的表空间和包含备份的目录。

以下示例从 DATA_PUMP_DIR 目录中导入表空间 TBS1、TBS2 和 TBS3。

BEGIN
  :task_id:=rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces('TBS1,TBS2,TBS3','DATA_PUMP_DIR');
END;
/
PRINT task_id

（可选）通过查询表 rdsadmin.rds_xtts_operation_info 来监控进度。xtts_operation_state 列显示值 EXECUTING、COMPLETED 或 FAILED。

SELECT * FROM rdsadmin.rds_xtts_operation_info;

使用上一步中的任务 ID 查看已完成的导入的日志。

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||'&task_id'||'.log'));

在继续下一步之前，请确保导入成功。

按照为 Amazon RDS 的单可用区数据库实例创建数据库快照中的说明制作手动数据库快照。

启动 Oracle SQL 客户端，并以主用户身份登录到目标数据库实例。

在传输的表空间中创建拥有模式的用户（如果这些用户尚不存在）。

CREATE USER tbs_owner IDENTIFIED BY password;

导入元数据，同时指定转储文件的名称及其目录位置。

BEGIN
  rdsadmin.rdsadmin_transport_util.import_xtts_metadata('xttdump.dmp','DATA_PUMP_DIR');
END;
/

（可选）查询可传输的表空间历史记录表以查看元数据导入的状态。

SELECT * FROM rdsadmin.rds_xtts_operation_info;

操作完成后，您的表空间将处于只读模式。

（可选）查看日志文件。

以下示例列出了 BDUMP 目录的内容，然后查询导入日志。

SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'BDUMP'));

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file(
  p_directory => 'BDUMP',
  p_filename => 'rds-xtts-import_xtts_metadata-2023-05-22.01-52-35.560858000.log'));

启动 SQL*Plus 或 SQL Developer，并以主用户身份登录到目标数据库实例。

使用过程 rdsadmin.rdsadmin_rman_util.validate_tablespace 验证表空间。

SET SERVEROUTPUT ON
BEGIN
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS1',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS2',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS3',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
END;
/

将表空间置于读/写模式。

ALTER TABLESPACE TBS1 READ WRITE;
ALTER TABLESPACE TBS2 READ WRITE;
ALTER TABLESPACE TBS3 READ WRITE;

按如下方式删除 DATA_PUMP_DIR 中的旧备份：

1. 通过运行 rdsadmin.rdsadmin_file_util.listdir 列出备份文件。

   SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'DATA_PUMP_DIR'));

2. 通过调用 UTL_FILE.FREMOVE 逐一删除备份。

   EXEC UTL_FILE.FREMOVE ('DATA_PUMP_DIR', 'backup_filename');

如果您导入了表空间，但没有为这些表空间导入元数据，则可以按如下方式删除孤立的数据文件：

1. 列出需要删除的孤立数据文件。以下示例运行过程 rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files。

   SQL> SELECT * FROM TABLE(rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files);
   
   FILENAME       FILESIZE
   -------------- ---------
   datafile_7.dbf 104865792
   datafile_8.dbf 104865792

2. 通过运行过程 rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import 删除孤立文件。

   BEGIN
     rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import('DATA_PUMP_DIR');
   END;
   /

   清理操作会在 BDUMP 目录中生成一个使用名称格式 rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log 的日志文件。

3. 读取上一步中生成的日志文件。以下示例读取日志 rds-xtts-delete_xtts_orphaned_files-2023-06-01.09-33-11.868894000.log。

   SELECT * 
   FROM TABLE(rdsadmin.rds_file_util.read_text_file(
          p_directory => 'BDUMP',
          p_filename  => 'rds-xtts-delete_xtts_orphaned_files-2023-06-01.09-33-11.868894000.log'));
   
   TEXT
   --------------------------------------------------------------------------------
   orphan transported datafile datafile_7.dbf deleted.
   orphan transported datafile datafile_8.dbf deleted.

如果您导入了表空间并为这些表空间导入了元数据，但遇到了兼容性错误或其他 Oracle Data Pump 问题，请按如下方式清理部分传输的数据文件：

1. 通过查询 DBA_TABLESPACES 列出包含部分传输的数据文件的表空间。

   SQL> SELECT TABLESPACE_NAME FROM DBA_TABLESPACES WHERE PLUGGED_IN='YES';
   
   TABLESPACE_NAME
   --------------------------------------------------------------------------------
   TBS_3

2. 删除表空间和部分传输的数据文件。

   DROP TABLESPACE TBS_3 INCLUDING CONTENTS AND DATAFILES;