Documentation sur Oracle Cloud Infrastructure

Déplacer des données vers un magasin d'objets en tant que fichiers Oracle Data Pump à l'aide de EXPORT_DATA

Vous pouvez exporter des données vers des 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, comme suit :

  1. Connectez-vous à la base de données.

  2. Stockez vos données d'identification de magasin d'objets à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL.

    Exemple :

    BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'DEF_CRED_NAME',
    username => 'adb_user@example.com',
    password => 'password'
  );
END;
/

    La création de données d'identification pour accéder au magasin d'objets Oracle Cloud Infrastructure n'est pas requise si vous activez les données d'identification du principal de ressource. Pour plus d'informations, voir Utiliser un principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure.

    Cette opération stocke les données d'identification dans la base de données dans un format chiffré. Vous pouvez utiliser n'importe quel nom pour les données d'identification. Notez que cette étape n'est requise qu'une seule fois, sauf si les données d'identification du magasin d'objets changent. Une fois que vous avez stocké les données d'identification, vous pouvez utiliser le même nom.

    Voir Procédure CREATE_CREDENTIAL pour plus d'informations sur les paramètres username et password pour différents services de stockage d'objets.

  3. Exportez des données de la base de données Autonomous AI Database vers votre magasin d'objets en nuage en tant que fichier(s) de vidage Oracle Data Pump en appelant DBMS_CLOUD.EXPORT_DATA avec le paramètre format type réglé à la valeur datapump. Par exemple :

    BEGIN
 DBMS_CLOUD.EXPORT_DATA(
    credential_name =>'DEF_CRED_NAME',
    file_uri_list =>'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp01.dmp',
    format => json_object('type' value 'datapump'),
    query => 'SELECT lakehouse_id, quantity FROM inventories'
 );
END;
/

    Les paramètres sont les suivants :

    • credential_name : Nom des données d'identification créées à l'étape précédente.

    • 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 avec la valeur datapump et définit éventuellement 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.

    Dans cet exemple, namespace-string est l'espace de noms du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

    Note

    Note : La procédure DBMS_CLOUD.EXPORT_DATA crée le ou les fichiers de vidage que vous spécifiez dans file_uri_list. 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. DBMS_CLOUD.EXPORT_DATA ne crée pas de seaux.

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

  4. Effectuez les étapes requises pour utiliser l'importation et le nettoyage d'Oracle Data Pump. Pour plus de détails, voir Télécharger les fichiers de vidage, exécuter l'importation de l'extraction de données et nettoyer le stockage d'objets.

Notes pour l'exportation de données avec DBMS_CLOUD.EXPORT_DATA :

  • 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 AI 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.

  • 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.