使用 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 Support 備註 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 儲存貯體下載到目標資料庫執行個體。以下範例會從名為 DOC-EXAMPLE-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    =>  'DOC-EXAMPLE-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 位元)，其平台識別碼為。6您可以通過查詢找到平台 ID V$TRANSPORTABLE_PLATFORM。

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'));

請確定匯入已成功完成，再繼續下一個步驟。

請依照 為單一可用區資料庫執行個體建立資料庫快照 中的指示擷取手動資料庫快照。

啟動 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;