Export de données vers un répertoire en tant que fichiers Oracle Data Pump

Vous pouvez exporter des données vers un répertoire en tant que fichiers dump Oracle Data Pump en indiquant une requête.

Avec cette méthode d'export, vous utilisez la procédure DBMS_CLOUD.EXPORT_DATA afin d'indiquer une requête permettant de sélectionner les données à exporter en tant que fichier dump vers un répertoire.

  1. Connectez-vous à votre instance Autonomous Database.
  2. Création d'un répertoire.

    Exemple :

    CREATE DIRECTORY export_dir AS 'export_dir';
    Pour plus d'informations, reportez-vous à Création d'un répertoire dans Autonomous Database.
  3. Exportez des données à partir d'Autonomous Database vers votre répertoire en tant que fichiers dump Oracle Data Pump avec DBMS_CLOUD.EXPORT_DATA et indiquez le paramètre format type en tant que datapump. Exemples :
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        format => json_object('type' value 'datapump'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

    Exemple d'export de données en tant que plusieurs fichiers Data Pump vers un répertoire :

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales1.dmp, export_dir:sales2.dmp',
        format => json_object('type' value 'datapump'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

    Les paramètres sont les suivants :

    • file_uri_list : liste des fichiers d'export séparés par des virgules. L'utilisation de caractères génériques et de substitution n'est pas prise en charge dans file_uri_list.

    • format : indique le paramètre type requis. Les valeurs valides sont datapump, json, xml, csv et parquet. Elles définissent également éventuellement les options que vous pouvez indiquer pour l'export à l'aide du pilote d'accès ORACLE_DATAPUMP.

    • query : indique une instruction SELECT afin que seules les données requises soient exportées. La requête détermine le contenu des fichiers dump.

    Remarque

    La procédure DBMS_CLOUD.EXPORT_DATA crée les fichiers dump que vous indiquez dans file_uri_list.

    Pour obtenir des informations détaillées sur les paramètres, reportez-vous à Procédure EXPORT_DATA.

Remarques relatives à l'export de données avec DBMS_CLOUD.EXPORT_DATA :

  • Le répertoire fourni doit exister et vous devez être connecté en tant qu'utilisateur ADMIN ou disposer de l'accès WRITE au répertoire.

  • La procédure ne remplace pas les fichiers. Si un fichier dump dans file_uri_list existe, DBMS_CLOUD.EXPORT_DATA signale une erreur telle que :

    ORA-31641: unable to create dump file  "/u02/exports/123.dmp"
    ORA-27038: created file already exists
  • DBMS_CLOUD.EXPORT_DATA ne crée pas de répertoires.

  • Le nom du répertoire est sensible à la casse lorsqu'il est placé entre guillemets doubles.

  • Le nombre de fichiers dump générés par DBMS_CLOUD.EXPORT_DATA est déterminé lors de l'exécution de la procédure. Le nombre de fichiers de vidage générés dépend du nombre de noms de fichier indiqués dans le paramètre file_uri_list, ainsi que du nombre d'ECPU disponibles pour l'instance, du niveau de service et de la taille des données.

    Par exemple, si vous utilisez une instance Autonomous Database à 2 ECPU ou le service low, un seul fichier dump est exporté sans parallèle, même si vous indiquez plusieurs noms de fichier. Si vous utilisez une instance Autonomous Database à 8 ECPU avec le service medium ou high, les travaux peuvent être exécutés en parallèle et plusieurs fichiers dump sont exportés si vous indiquez plusieurs noms de fichier.

  • La valeur du paramètre query que vous indiquez peut être une requête avancée, si nécessaire, telle qu'une requête incluant des jointures ou des sous-requêtes.

  • Les fichiers dump que vous créez avec DBMS_CLOUD.EXPORT_DATA ne peuvent pas être importés à l'aide d'Oracle Data Pump impdp. Selon la base de données, vous pouvez utiliser ces fichiers comme suit :

    • Sur une base de données Autonomous Database, vous pouvez utiliser les fichiers dump avec les procédures DBMS_CLOUD qui prennent en charge le paramètre de format type avec la valeur datapump. Vous pouvez importer les fichiers dump à l'aide de DBMS_CLOUD.COPY_DATA ou appeler DBMS_CLOUD.CREATE_EXTERNAL_TABLE pour créer une table externe.

    • Sur les autres bases de données Oracle Database, comme sur site Oracle Database 19c, vous pouvez importer les fichiers dump créés avec la procédure DBMS_CLOUD.EXPORT_DATA à l'aide du pilote d'accès ORACLE_DATAPUMP. Pour plus d'informations, reportez-vous à Déchargement et chargement de données avec le pilote d'accès ORACLE_DATAPUMP.