使用 Oracle Data Pump 导入

Oracle Data Pump 是一个实用程序，可让您将 Oracle 数据导出到转储文件并将其导入到另一个 Oracle 数据库。长期来看，它最终会取代 Oracle Export/Import 实用程序。Oracle Data Pump 是将大量数据从 Oracle 数据库迁移到 Amazon RDS 数据库实例的建议方法。

本节中的示例展示了将数据导入 Oracle 数据库的一种方法，但 Oracle Data Pump 支持其他方法。有关更多信息，请参阅 Oracle Database 文档。

本节中的示例使用 DBMS_DATAPUMP 包。您可以使用 Oracle Data Pump 命令行实用程序 impdp 和 expdp 完成相同的任务。您可以在远程主机上安装这些实用程序以作为 Oracle 客户端安装的一部分，包括 Oracle 即时客户端。有关更多信息，请参阅如何使用 Oracle Instant Client 为我的 Amazon RDS for Oracle 数据库实例运行 Data Pump 导入或导出？

Oracle Data Pump 概述

Oracle Data Pump 由以下组件组成：

您可以将 Oracle Data Pump 用于以下场景：

要下载 Oracle Data Pump 实用工具，请参阅 Oracle Technology Network 网站上的 Oracle 数据库软件下载。有关在 Oracle Database 的版本之间进行迁移时的兼容性注意事项，请参阅 Oracle Database 文档。

Oracle Data Pump 工作流

通常，您在以下阶段使用 Oracle 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_DATAPUMP 将数据导出到转储文件中

要创建转储文件，请使用 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 数据转储和 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');