本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Oracle Data Pump 匯入

Oracle Data Pump 是一個公用程式，可讓您將 Oracle 資料匯出至傾印檔案，並將其匯入至另一個 Oracle 資料庫。是 Oracle 匯出/匯入公用程式的長期替代方案。將大量資料從 Oracle 資料庫移動到 Amazon RDS 資料庫執行個體時，建議使用 Oracle Data Pump。

本節中的範例顯示將資料匯入 Oracle 資料庫的一種方法，但是 Oracle Data Pump 支援其他技術。如需詳細資訊，請參閱 Oracle 資料庫文件。

本節中的範例使用 DBMS_DATAPUMP 套件。您可以使用 Oracle Data Pump 命令列公用程式 impdp 和 expdp 來完成相同的工作。您可以在安裝 Oracle 用戶端 (包括 Oracle Instant Client) 期間，將這些公用程式安裝在遠端主機上。如需詳細資訊，請參閱《如何使用 Oracle 用戶端為我的 Amazon RDS for Oracle 資料庫執行個體執行 Data Pumt 來匯入或匯出？》

Oracle Data Pump 概觀

Oracle Data Pump 由下列元件組成：

Oracle Data Pump 可以用於以下案例：

如需下載 Oracle Data Pump 公用程式，請參閱 Oracle Technology Network 網站的 Oracle 資料庫軟體下載。如需了解在 Oracle 資料庫各版本間遷移的相容性考量，請參閱 Oracle 資料庫文件。

Oracle Data Pump 工作流程

通常，您會在下列階段使用 Oracel Data Pump：

Oracle Data Pump 最佳實務

當您使用 Oracle Data Pump 將資料匯入 RDS for Oracle 執行個體時，我們建議您採用下列最佳實務：

以 Oracle Data Pump 及 Amazon S3 儲存貯體匯入資料

以下匯入程序使用 Oracle Data Pump 及 Amazon S3 儲存貯體。步驟如下：

要求以 Oracle Data Pump 及 Amazon S3 儲存貯體匯入資料

此程序有以下要求：

步驟 1：授予權限給 RDS for Oracle 目標資料庫執行個體上的資料庫使用者

在此步驟中，您會建立要匯入資料的結構描述，並授與使用者必要的權限。

步驟 2：使用 DBMS_DAPUMP 將資料匯出倒傾印檔案

若要建立傾印檔案，請使用 DBMS_DATAPUMP 套件。

步驟 3：將傾印檔案上傳至 Amazon S3 儲存貯體

使用 Amazon RDS 程序 rdsadmin.rdsadmin_s3_tasks.upload_to_s3，將傾印檔案複製到 Amazon S3 儲存貯體。以下範例將所有檔案從 DATA_PUMP_DIR 目錄上傳至名為 amzn-s3-demo-bucket 的 Amazon S3 儲存貯體。

SELECT rdsadmin.rdsadmin_s3_tasks.upload_to_s3(
  p_bucket_name    =>  'amzn-s3-demo-bucket',       
  p_directory_name =>  'DATA_PUMP_DIR') 
AS TASK_ID FROM DUAL;

SELECT 陳述式以 VARCHAR2 資料類型傳回任務 ID。如需詳細資訊，請參閱將檔案從 RDS for Oracle 資料庫執行個體上傳至 Amazon S3 儲存貯體。

步驟 4：將傾印檔案從 Amazon S3 儲存貯體下載到您的目標資料庫執行個體

使用 Amazon RDS 程序 rdsadmin.rdsadmin_s3_tasks.download_from_s3 執行此步驟。當您將文件下載到目錄時，如果目錄中已存在名稱相同的檔案，則程序 download_from_s3 會略過下載。如欲從下載目錄移除檔案，請使用 Oracle 網站上的 UTL_FILE.FREMOVE。

步驟 5：使用 DBMS_DATAPUMP 將您的傾印檔案匯入目標資料庫執行個體

使用 DBMS_DATAPUMP 將結構描述匯入 RDS for Oracle 資料庫執行個體。您可能需要額外選項，例如 METADATA_REMAP。

對 Data Pump 匯入進行故障診斷

若要檢查 Data Pump 匯入任務的狀態，請查詢匯入日誌檔案：

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('DATA_PUMP_DIR', 'sample_imp.log'));

常見的錯誤包括：

若要重新執行部分失敗的匯入，請將 TABLE_EXISTS_ACTION => 'REPLACE'新增至匯入參數以覆寫現有的物件。

步驟 6：清除

匯入資料後，您可以刪除不繼續保留的檔案。

以 Oracle Data Pump 及資料庫連結匯入資料

以下匯入程序會使用 Oracle Data Pump 和 Oracle DBMS_FILE_TRANSFER 套件。步驟如下：

使用 Oracle Data Pump 及 DBMS_FILE_TRANSFER 套件的匯入程序具有下列步驟。

匯入 Oracle Data Pump 及資料庫連結的要求

此程序有以下要求：

步驟 1：授予權限給 RDS for Oracle 目標資料庫執行個體上的使用者

如欲向 RDS for Oracle 目標資料庫執行個體的使用者授予權限，請進行下列步驟：

步驟 2：向來源資料庫的使用者授予權限

使用 SQL*Plus 或 Oracle SQL Developer，連線至包含要匯入之資料的 RDS for Oracle 資料庫執行個體。如有需要，建立使用者帳戶並授予必需的許可。

以下命令會建立新的使用者並授予必需的許可。

CREATE USER export_user IDENTIFIED BY my-password;
GRANT CREATE SESSION, CREATE TABLE, CREATE DATABASE LINK TO export_user;
ALTER USER export_user QUOTA 100M ON users;
GRANT READ, WRITE ON DIRECTORY data_pump_dir TO export_user;
GRANT SELECT_CATALOG_ROLE TO export_user;
GRANT EXECUTE ON DBMS_DATAPUMP TO export_user;
GRANT EXECUTE ON DBMS_FILE_TRANSFER TO export_user;            

步驟 3：使用 DBMS_DATAPUMP 建立傾印檔案

若要建立傾印檔案，請執行下列步驟：

步驟 4：建立與目標資料庫執行個體的資料庫連結

在來源資料庫執行個體與目標資料庫執行個體之間建立資料庫連結。您的本機 Oracle 執行個體必須可以和資料庫執行個體網路連線，才能建立資料庫連結以及傳輸匯出傾印檔案。

請以前一步驟的相同使用者身分執行此步驟。

如果是在相同 VPC 或對等連接 VPC 內的兩個資料庫執行個體之間建立資料庫連結，兩個資料庫執行個體之間應具備有效路由。這兩個資料庫執行個體的安全群組，皆必須允許輸入和輸出到其他資料庫執行個體。安全群組的傳入和傳出規則可以參考相同 VPC 或對等連接 VPC 的安全群組。如需更多詳細資訊，請參閱 調整資料庫連結以搭配使用 VPC 中的資料庫執行個體。

以下命令會建立名為 to_rds 的資料庫連結，可連接至目標資料庫執行個體的 Amazon RDS 主要使用者。

CREATE DATABASE LINK to_rds 
  CONNECT TO <master_user_account> IDENTIFIED BY <password>
  USING '(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<dns or ip address of remote db>)
         (PORT=<listener port>))(CONNECT_DATA=(SID=<remote SID>)))';

步驟 5：使用 DBMS_FILE_TRANSFER 將匯出的傾印檔案，複製到目標資料庫執行個體

使用 DBMS_FILE_TRANSFER，將傾印檔案從來源資料庫執行個體複製到目標資料庫執行個體。以下指令碼會將名為 sample.dmp 的傾印檔案，從來源執行個體複製到名為 to_rds 的目標資料庫連結 (在先前步驟中建立)。

BEGIN
  DBMS_FILE_TRANSFER.PUT_FILE(
    source_directory_object       => 'DATA_PUMP_DIR',
    source_file_name              => 'sample.dmp',
    destination_directory_object  => 'DATA_PUMP_DIR',
    destination_file_name         => 'sample_copied.dmp', 
    destination_database          => 'to_rds' );
END;
/ 

步驟 6：使用 DBMS_DATAPUMP 將資料檔案匯入至目標資料庫執行個體

使用 Oracle Data Pump 匯入資料庫執行個體上的結構描述。您可能需要額外選項，例如 METADATA_REMAP。

使用 Amazon RDS 主要使用者帳戶連線到資料庫執行個體以進行匯入。

DECLARE
  v_hdnl NUMBER;
BEGIN
  v_hdnl := DBMS_DATAPUMP.OPEN( 
    operation => 'IMPORT', 
    job_mode  => 'SCHEMA', 
    job_name  => null);
  DBMS_DATAPUMP.ADD_FILE( 
    handle    => v_hdnl, 
    filename  => 'sample_copied.dmp',
    directory => 'DATA_PUMP_DIR', 
    filetype  => dbms_datapump.ku$_file_type_dump_file );
  DBMS_DATAPUMP.ADD_FILE( 
    handle    => v_hdnl, 
    filename  => 'sample_imp.log', 
    directory => 'DATA_PUMP_DIR', 
    filetype  => dbms_datapump.ku$_file_type_log_file);
  DBMS_DATAPUMP.METADATA_FILTER(v_hdnl,'SCHEMA_EXPR','IN (''SCHEMA_1'')');
  DBMS_DATAPUMP.START_JOB(v_hdnl);
END;
/ 

您可以檢視資料庫執行個體上的使用者資料表，以確認資料的匯入。例如，以下查詢會傳回 schema_1 的資料表數目。

SELECT COUNT(*) FROM DBA_TABLES WHERE OWNER='SCHEMA_1'; 

步驟 7：清理

匯入資料後，您可以刪除不繼續保留的檔案。您可以使用以下命令列出 DATA_PUMP_DIR 中的檔案。

SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir('DATA_PUMP_DIR')) ORDER BY MTIME;

以下命令可用來刪除 DATA_PUMP_DIR 中不再需要的檔案。

EXEC UTL_FILE.FREMOVE('DATA_PUMP_DIR','<file name>');

例如以下命令會刪除名為 "sample_copied.dmp" 的檔案。

EXEC UTL_FILE.FREMOVE('DATA_PUMP_DIR','sample_copied.dmp');