Documentation sur Oracle Cloud Infrastructure

Exporter des 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 spécifiant une interrogation.

Avec cette méthode d'exportation, vous utilisez la procédure DBMS_CLOUD.EXPORT_DATA pour spécifier une interrogation permettant de sélectionner les données à exporter en tant que fichier de vidage vers un répertoire.

  1. Connectez-vous à votre instance de base de données Autonomous AI Database.
  2. Créer un répertoire.

    Exemple :

    CREATE DIRECTORY export_dir AS 'export_dir';
    Pour plus d'informations, voir Créer un répertoire dans Autonomous AI Database.
  3. Exportez les données de la base de données IA autonome vers votre répertoire en tant que fichier(s) de vidage Oracle Data Pump avec DBMS_CLOUD.EXPORT_DATA et spécifiez le paramètre format type comme datapump. 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 pour exporter des 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'exportation. 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 : Spécifie le paramètre type requis. Les valeurs valides sont datapump, json, xml, csv et parquet et définit également facultativement les options que vous pouvez spécifier pour l'exportation avec le pilote d'accès ORACLE_DATAPUMP.

    • query : Spécifie un énoncé SELECT afin que seules les données requises soient exportées. L'interrogation détermine le contenu des fichiers dump.

    Note

    La procédure DBMS_CLOUD.EXPORT_DATA crée les fichiers de vidage que vous spécifiez dans file_uri_list.

    Pour des informations détaillées sur les paramètres, voir ProcédureEXPORT_DATA.

Notes pour l'exportation 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 avoir l'accès WRITE au répertoire.

  • La procédure ne remplace pas les fichiers. Si un fichier de vidage existe dans file_uri_list, 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 encadré de guillemets doubles.

  • Le nombre de fichiers de vidage 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 que vous fournissez 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 de base de données d'IA autonome à 2 ECPU ou le service low, un seul fichier de vidage est exporté sans parallélisme, même si vous fournissez plusieurs noms de fichier. Si vous utilisez une instance de base de données du service d'intelligence artificielle autonome à 8 ECPU avec le service medium ou high, les tâches peuvent être exécutées en parallèle et plusieurs fichiers de vidage sont exportés si vous fournissez plusieurs noms de fichier.

  • La valeur de paramètre query que vous fournissez peut être une interrogation avancée, si nécessaire, telle qu'une interrogation qui inclut des jointures ou des sous-interrogations.

  • Les fichiers de vidage 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 :

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

    • Sur n'importe quel autre service Oracle Database, tel qu'Oracle Database 19c sur place, vous pouvez importer les fichiers de vidage créés avec la procédure DBMS_CLOUD.EXPORT_DATA à l'aide du pilote d'accès ORACLE_DATAPUMP. Pour plus d'informations, voir Déchargement et chargement de données avec le pilote d'accès ORACLE_DATAPUMP.