Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Importation à l'aide d'Oracle Data Pump

Oracle Data Pump est un utilitaire qui vous permet d'exporter des données Oracle vers un fichier de vidage et de les importer dans une autre base de données Oracle. Il s'agit d'un remplacement à long terme des utilitaires d'importation/importation d'Oracle. Oracle Data Pump est la méthode recommandée pour déplacer de grandes quantités de données d'une base de données Oracle vers une RDS instance de base de données Amazon.

Les exemples de cette section montrent une façon d'importer des données dans une base de données Oracle, mais Oracle Data Pump prend en charge d'autres techniques. Pour plus d'informations, consultez la documentation Oracle Database.

Les exemples de cette section utilisent le package DBMS_DATAPUMP. Vous pouvez accomplir les mêmes tâches en utilisant les utilitaires de ligne de commande Oracle Data Pump impdp et expdp. Vous pouvez installer ces utilitaires sur un hôte distant dans le cadre d'une installation de client Oracle, y compris Oracle Instant Client. Pour plus d'informations, consultez Comment utiliser Oracle Instant Client pour exécuter Data Pump Import ou Export pour mon instance de base de données Amazon RDS pour Oracle ?

Présentation d'Oracle Data Pump

Oracle Data Pump est constitué des composants suivants :

Vous pouvez utiliser Oracle Data Pump dans les scénarios suivants :

Pour télécharger les utilitaires Oracle Data Pump, veuillez consulter Oracle Database Software Downloads sur le site web Oracle Technology Network. Pour en savoir plus sur la compatibilité lors de la migration entre les versions d'Oracle Database, veuillez consulter la documentation Oracle Database.

Flux de travail Oracle Data Pump

En général, vous utilisez Oracle Data Pump pour les opérations suivantes :

Bonnes pratiques d'Oracle Data Pump

Lorsque vous utilisez Oracle Data Pump pour importer des données dans une RDS instance Oracle, nous vous recommandons de suivre les meilleures pratiques suivantes :

Importation de données avec Oracle Data Pump et un compartiment Amazon S3

Le processus d'importation suivant utilise Oracle Data Pump et un compartiment Amazon S3. La procédure est la suivante :

Conditions requises pour importer des données avec Oracle Data Pump et un compartiment Amazon S3

Le processus est soumis aux exigences suivantes :

Étape 1 : accorder des privilèges à l'utilisateur de base de données sur l'instance de base de données cible RDS pour Oracle

Dans cette étape, vous créez les schémas dans lesquels vous prévoyez d'importer des données et vous accordez aux utilisateurs les privilèges nécessaires.

Étape 2 : Exporter les données dans un fichier de vidage à l'aide de DBMS _ DATAPUMP

Pour créer un fichier de vidage, utilisez le package DBMS_DATAPUMP.

Étape 3 : Charger le fichier de vidage dans votre compartiment Amazon S3

Utilisez la RDS procédure Amazon rdsadmin.rdsadmin_s3_tasks.upload_to_s3 pour copier le fichier de vidage dans le compartiment Amazon S3. L'exemple suivant charge tous les fichiers du répertoire DATA_PUMP_DIR dans le compartiment Amazon S3 nommé amzn-s3-demo-bucket.

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;

L'instruction SELECT renvoie l'ID de la tâche dans un type de données VARCHAR2. Pour de plus amples informations, veuillez consulter Téléchargement de fichiers depuis votre instance de base de données RDS pour Oracle vers un compartiment Amazon S3.

Étape 4 : téléchargez le fichier de vidage depuis votre compartiment Amazon S3 vers votre instance de base de données cible.

Effectuez cette étape à l'aide de la RDS procédure Amazonrdsadmin.rdsadmin_s3_tasks.download_from_s3. Lorsque vous téléchargez un fichier dans un répertoire, la procédure download_from_s3 ignore le téléchargement si un fichier de même nom existe déjà dans le répertoire. Pour supprimer un fichier du répertoire de téléchargement, utilisez UTL_FILE. FREMOVE, disponible sur le site Web d'Oracle.

Étape 5 : Importez votre fichier de vidage dans votre instance de base de données cible à l'aide de DBMS _ DATAPUMP

DBMS_DATAPUMPÀ utiliser pour importer le schéma dans votre instance de base de données RDS pour Oracle. Des options supplémentaires telles que METADATA_REMAP peuvent être nécessaires.

Étape 6 : nettoyer

Après l'importation des données, vous pouvez supprimer les fichiers que vous ne souhaitez plus conserver.

Importation de données avec Oracle Data Pump et un lien de base de données

Le processus d'importation suivant utilise Oracle Data Pump et le TRANSFER package Oracle DBMSFILE_ _. La procédure est la suivante :

Le processus d'importation utilisant Oracle Data Pump et le package DBMS_FILE_TRANSFER comporte les étapes suivantes :

Conditions requises pour importer des données avec Oracle Data Pump et un lien vers une base de données

Le processus est soumis aux exigences suivantes :

Étape 1 : accorder des privilèges à l'utilisateur sur l'instance de base de données cible RDS pour Oracle

Pour accorder des privilèges à l'utilisateur sur l'instance de base de données cible RDS pour Oracle, procédez comme suit :

Étape 2 : Accorder des privilèges à l'utilisateur sur la base de données source

Utilisez SQL *Plus ou Oracle SQL Developer RDS pour vous connecter à l'instance de base de données Oracle contenant les données à importer. Le cas échéant, créez un compte utilisateur et accordez les autorisations nécessaires.

Les commandes suivantes créent un nouvel utilisateur et accordent les autorisations nécessaires.

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;            

Étape 3 : créer un fichier de vidage à l'aide de DBMS _ DATAPUMP

Pour créer un fichier de vidage, procédez comme suit :

Étape 4 : créer un lien de base de données vers l'instance de base de données cible

Créez un lien de base de données entre votre instance de base de données source et votre instance de base de données cible. Notez que votre instance Oracle locale doit avoir une connectivité réseau à l'instance de base de données pour créer un lien de base de données et transférer votre fichier de vidage.

Exécutez cette étape en étant connecté au même compte d'utilisateur qu'à l'étape précédente.

Si vous créez un lien de base de données entre deux instances de base de données internes VPC ou homologuesVPCs, les deux instances de base de données doivent avoir une route valide entre elles. Le groupe de sécurité de chaque instance de base de données doit autoriser le trafic entrant dans l'autre instance de base de données et le trafic sortant de cette instance. Les règles entrantes et sortantes des groupes de sécurité peuvent faire référence à des groupes de sécurité provenant du même groupe VPC ou d'un groupe pair. VPC Pour de plus amples informations, veuillez consulter Ajustement des liens de base de données à utiliser avec des instances de base de données dans un VPC.

La commande suivante crée un lien de base de données nommé to_rds qui se connecte à l'utilisateur RDS principal Amazon sur l'instance de base de données cible.

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

Étape 5 : Copiez le fichier de vidage exporté sur l'instance de base de données cible à l'aide de DBMS _ FILE _ TRANSFER

Utilisez DBMS_FILE_TRANSFER pour copier le fichier de vidage depuis l'instance de base de données source vers l'instance de base de données cible. Le script suivant copie un fichier de vidage appelé sample.dmp depuis l'instance source vers un lien de base de données cible appelé to_rds (créé dans l'étape précédente) :

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;
/ 

Étape 6 : Importez le fichier de données dans l'instance de base de données cible à l'aide de DBMS _ DATAPUMP

Utilisez Oracle Data Pump pour importer le schéma dans l'instance de base de données. Des options supplémentaires telles que METADATA _ REMAP peuvent être nécessaires.

Connectez-vous à l'instance de base de données avec le compte utilisateur RDS principal Amazon pour effectuer l'importation.

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;
/ 

Vous pouvez vérifier l'importation des données en consultant les table de l'utilisateur sur l'instance de base de données. Par exemple, la requête suivante renvoie le nombre de tables de schema_1.

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

Étape 7 : nettoyer

Après l'importation des données, vous pouvez supprimer les fichiers que vous ne souhaitez plus conserver. Vous pouvez répertorier les fichiers de DATA_PUMP_DIR à l'aide de la commande suivante.

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

Pour supprimer des fichiers dont vous n'avez plus besoin dans DATA_PUMP_DIR, utilisez la commande suivante :

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

Par exemple, la commande suivante supprime le fichier appelé "sample_copied.dmp".

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