Utiliser Oracle Data Pump pour exporter des données vers un magasin d'objets à l'aide du paramètre CREDENTIAL

La figure présente les étapes pour exporter des données de votre base de données Autonomous AI Database vers le stockage d'objets en nuage à l'aide de l'exportation d'Oracle Data Pump à l'aide du paramètre credential.

Oracle recommande d'utiliser la dernière version d'Oracle Data Pump pour exporter des données depuis Autonomous AI Database vers d'autres bases de données Oracle, car elle contient des améliorations et des correctifs pour une meilleure expérience. Téléchargez la dernière version d'Oracle Instant Client et téléchargez l'ensemble d'outils, qui inclut Oracle Data Pump, pour votre plate-forme à partir des téléchargements Oracle Instant Client. Consultez les instructions d'installation sur la page de téléchargement pour connaître les étapes d'installation requises après le téléchargement d'Oracle Instant Client et de l'ensemble d'outils.

Si vous utilisez Oracle Data Pump version 19.9 ou ultérieure, vous pouvez utiliser le paramètre credential comme indiqué dans ces étapes. Pour obtenir des instructions sur l'utilisation d'Oracle Data Pump versions 19.8 et antérieures, voir Utiliser Oracle Data Pump pour exporter des données vers un magasin d'objets en définissant la propriété DEFAULT_CREDENTIAL.

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

2. Stockez vos données d'identification du service de stockage d'objets en nuage à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL. Par exemple :

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

   Les valeurs que vous indiquez pour username et password dépendent du service de stockage d'objets en nuage que vous utilisez .

   Si vous exportez vers Oracle Cloud Infrastructure Object Storage, les méthodes d'authentification disponibles dépendent de la version de la base de données :

   • Dans Oracle AI Database 26ai, vous pouvez utiliser les URI natifs d'Oracle Cloud Infrastructure avec l'authentification native OCI, notamment les informations d'identification et de connexion du principal de ressource.

   • Dans Oracle AI Database 19c, vous pouvez utiliser les URI natifs d'Oracle Cloud Infrastructure ou les URI Swift, mais les données d'identification doivent être des jetons d'authentification.

   Pour plus d'informations, voir Procédure CREATE_CREDENTIAL pour plus d'informations.

3. Exécutez Data Pump Export avec le paramètre dumpfile réglé à l'URL d'un seau existant dans votre stockage d'objets en nuage, se terminant par un nom de fichier ou un nom de fichier avec une variable de substitution, telle que exp%L.dmp, et avec le paramètre credential réglé au nom des données d'identification que vous avez créées à l'étape précédente. Par exemple :

   expdp admin/password@db2022adb_high \
        filesize=5GB \
        credential=def_cred_name \
        dumpfile=https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/exp%L.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        logfile=export.log \
        directory=data_pump_dir

   Notes relatives aux paramètres d'Oracle Data Pump :

   • Si, lors de l'exportation avec expdp, vous avez utilisé le paramètre encryption_pwd_prompt=yes, utilisez encryption_pwd_prompt=yes et entrez le même mot de passe à l'invite impdp que vous avez spécifiée lors de l'exportation.

   • Le paramètre dumpfile prend en charge les caractères génériques %L et %l. Ce caractère générique étend le nom du fichier dumpfile en un entier incrémentant de 3 chiffres à 10 chiffres, de largeur variable, commençant à 100 et se terminant à 2147483646.

   • Si votre seau et vos données ne résident pas dans un domaine commercial, où les points d'extrémité dédiés OCI ne sont pas pris en charge, utilisez le format d'URI suivant pour dumpfile :

     https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname/o/filename

   Pour dumpfile, cet exemple utilise le format d'URI recommandé à l'aide des points d'extrémité dédiés OCI pour le domaine commercial. 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 Points d'extrémité dédiés du stockage d'objets, Régions et domaines de disponibilité et Présentation des espaces de noms du stockage d'objets.

   Pour une meilleure performance d'exportation, utilisez le service de base de données HIGH pour votre connexion d'exportation et réglez le paramètre parallel à un quart du nombre d'ECPU (.25 x nombre d'ECPU). Si vous utilisez un modèle de calcul d'OCPU, réglez le paramètre parallèle au nombre d'OCPU (1 x nombre d'OCPU).

   Pour plus d'informations sur le nom du service de base de données à connecter pour exécuter l'exportation de l'extraction de données, voir Noms du service de base de données pour la base de données autonome avec intelligence artificielle.

   Pour connaître le format d'URL du fichier de vidage pour les différents services de stockage d'objets en nuage, voir Formats d'URI DBMS_CLOUD.

   Cet exemple présente les paramètres recommandés pour l'exportation à partir d'une base de données d'IA autonome. Pour ces paramètres expdp, notez les points suivants :

   • La valeur maximale du paramètre filesize est de 10000 Mo pour les exportations d'Oracle Cloud Infrastructure Object Storage.

   • The maximum filesize parameter value is 20GB for Oracle Cloud Infrastructure Object Storage Classic exports.

   • Si filesize spécifié est trop volumineux, l'exportation affiche le message d'erreur :

     ORA-17500: ODM err:ODM HTTP Request Entity Too Large

   • Le paramètre directory spécifie le répertoire data_pump_dir pour le fichier journal spécifié, export.log. Pour plus d'informations, voir Accéder aux fichiers journaux pour l'exportation de l'extraction de données.

   Oracle Data Pump divise chaque partie du fichier de vidage en fragments plus petits pour accélérer les chargements. La console du service de stockage d'objets pour Oracle Cloud Infrastructure affiche plusieurs fichiers pour chaque partie de fichier de vidage que vous exportez. La taille des fichiers de vidage réels affichée est de zéro (0) et celle des fragments associés est de 10 Mo ou moins. Exemple :

   exp100.dmp
   exp100.dmp_aaaaaa
   exp101.dmp
   exp101.dmp_aaaaaa

   En téléchargeant les fichiers de vidage à zéro octet à partir de la console Oracle Cloud Infrastructure ou à l'aide de l'interface de ligne de commande Oracle Cloud Infrastructure, vous n'obtiendrez pas les fichiers de vidage complets. Pour télécharger les fichiers de vidage complets à partir du magasin d'objets, utilisez un outil qui prend en charge Swift, tel que curl, et fournissez votre nom de connexion d'utilisateur et votre jeton d'authentification Swift. Exemple :

   curl -O -v -X GET -u 'user1@example.com:auth_token \
      https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/namespace-string/bucketname/exp100.dmp

   Si vous importez un fichier avec les procédures DBMS_CLOUD qui prennent en charge le paramètre format type avec la valeur 'datapump', vous n'avez qu'à fournir le nom du fichier principal. Les procédures qui prennent en charge le type de format 'datapump' détectent et téléchargent automatiquement les fragments.

   Lorsque vous utilisez DBMS_CLOUD.DELETE_OBJECT, la procédure détecte et supprime automatiquement les fragments lorsque la procédure supprime le fichier principal.

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.

Note

Note : Pour effectuer une exportation complète ou pour exporter des objets appartenant à d'autres utilisateurs, vous devez disposer du rôle DATAPUMP_CLOUD_EXP.

Pour des informations détaillées sur les paramètres d'exportation d'Oracle Data Pump, voir Utilitaires d'Oracle AI Database.