Utiliser Oracle Data Pump pour exporter des données vers un magasin d'objets en définissant la propriété DEFAULT_CREDENTIAL

Affiche les étapes pour exporter des données de votre base de données autonome d'IA vers le stockage d'objets en nuage à l'aide d'Oracle Data Pump Export et définir la propriété DEFAULT_CREDENTIAL.

1. Connectez-vous à votre base de données autonome avec intelligence artificielle.
2. Stockez vos données d'identification du service de stockage d'objets en nuage à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL. 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, 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édureCREATE_CREDENTIAL.

3. En tant qu'utilisateur ADMIN, définissez les données d'identification que vous avez définies à l'étape 2 comme données d'identification par défaut pour votre base de données. Exemple :

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   La valeur DEFAULT_CREDENTIAL ne peut pas être un principal de ressource OCI, un principal de service Azure, un nom de ressource Amazon (ARN) ou un compte de service Google. Voir Configurer des politiques et des rôles pour accéder aux ressources pour plus d'informations sur l'authentification basée sur le principal de ressource.

4. 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). Exemple :

   expdp admin/password@db2022adb_high \
        filesize=5GB \
        dumpfile=default_credential: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 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 en plus des caractères génériques %U et %u existants. Par exemple, dumpfile=export%L.dmp. Utilisez le caractère générique %L ou %l pour les exportations à partir d'Oracle AI Database version 12.2 et supérieure. 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 (OC1), 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 (OC1). 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.

   Le mot clé default_credential dans le paramètre dumpfile est requis.

   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 Gérer les accès simultanés et les priorités pour la base de données d'intelligence artificielle autonome.

   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.

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