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 pour spécifier une requête afin 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éer un répertoire.

    Par 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 les données 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. Par exemple :
    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 délimitée par des virgules des fichiers d'export. L'utilisation de caractères génériques et de caractères 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. Vous pouvez également définir les options que vous pouvez indiquer pour l'export avec le pilote d'accès ORACLE_DATAPUMP.

    • query : indique une instruction SELECT de sorte que seules les données requises soient exportées. L'interrogation détermine le contenu du ou 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 à la 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 d'un accès WRITE au répertoire.

  • La procédure n'écrase 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 de 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 dump générés dépend du nombre de noms de fichier fournis 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 fichier dump unique est exporté sans parallélisme, 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 de paramètre query que vous fournissez peut être une requête avancée, si nécessaire, telle qu'une requête qui inclut 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. En fonction de la base de données, vous pouvez utiliser ces fichiers comme suit :

    • Sur une instance Autonomous Database, vous pouvez utiliser les fichiers dump avec les procédures DBMS_CLOUD qui prennent en charge le paramètre 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 toute autre base de données Oracle Database, telle qu'Oracle Database 19c sur site, 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.