Présente les étapes permettant d'exporter des données d'Autonomous Database vers Cloud Object Storage à l'aide de l'export Oracle Data Pump à l'aide du paramètre credential.

1. Connectez-vous à votre base de données.
2. Stockez vos informations d'identification de stockage d'objet cloud à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL. Exemples :

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

   Les valeurs fournies pour username et password dépendent du service Cloud Object Storage que vous utilisez .

   Si vous effectuez un export vers Oracle Cloud Infrastructure Object Storage, vous pouvez utiliser des URI natifs Oracle Cloud Infrastructure ou des URI Swift, mais les informations d'identification doivent être des jetons d'authentification. Pour plus d'informations, reportez-vous à Procédure CREATE_CREDENTIAL.

3. Exécutez l'export Data Pump. Le paramètre dumpfile doit être défini sur l'URL d'un bucket existant dans le stockage d'objet cloud, se terminant par un nom de fichier ou un nom de fichier avec une variable de substitution, comme exp%L.dmp, et le paramètre credential doit être défini sur le nom des informations d'identification créées à l'étape précédente. Exemples :

   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
   

   Remarques relatives aux paramètres Oracle Data Pump :

   • Si, pendant l'export avec expdp, vous avez utilisé le paramètre encryption_pwd_prompt=yes, utilisez encryption_pwd_prompt=yes et saisissez le même mot de passe à l'invite impdp que celui que vous avez indiqué lors de l'export.

   • 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 hérités. Par exemple, dumpfile=export%L.dmp. Utilisez le caractère générique %L ou %l pour les exportations à partir d'Oracle Database version 12.2 ou supérieure. Ce caractère générique étend le nom du fichier dump en un entier incrémentant de 3 chiffres à 10 chiffres, de largeur variable, commençant à 100 et se terminant à 2147483646.

   • Si votre bucket et vos données ne résident pas dans un domaine commercial (OC1), où les adresses dédiées OCI ne sont pas prises 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 adresses dédiées OCI pour le domaine commercial (OC1). namespace-string est l'espace de noms de stockage d'objet Oracle Cloud Infrastructure et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Adresses dédiées Object Storage, à Régions et domaines de disponibilité et à Présentation des espaces de noms Object Storage.

   Le paramètre credential ne peut pas être un principal de ressource OCI, un principal de service Azure, un nom de ressource Amazon ou un compte de service Google. Pour plus d'informations sur l'authentification basée sur le principal de ressource, reportez-vous à Accès aux ressources cloud en configurant des stratégies et des rôles.

   Pour des performances d'exportation optimales, utilisez le service de base de données HIGH pour la connexion d'exportation et définissez le paramètre parallel sur un quart du nombre d'ECPU (.25 x Nombre d'ECPU). Si vous utilisez un modèle de calcul d'OCPU, définissez le paramètre parallèle sur le nombre d'OCPU (1 x nombre d'OCPU).

   Pour plus d'informations sur le nom du service de base de données auquel se connecter afin d'exécuter Data Pump Export, reportez-vous à Noms de service de base de données pour Autonomous Database.

   Pour connaître le format d'URL de fichier dump des différents services Cloud Object Storage, reportez-vous à Formats d'URI DBMS_CLOUD.

   Cet exemple présente les paramètres recommandés pour l'export à partir d'Autonomous Database. Pour ces paramètres expdp, procédez comme suit :

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

   • La valeur maximale du paramètre filesize est de 20 Go pour les exports Oracle Cloud Infrastructure Object Storage Classic.

   • Si la valeur filesize indiquée est trop élevée, l'export affiche le message d'erreur suivant :

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

   • Le paramètre directory indique le répertoire data_pump_dir du fichier journal indiqué, export.log. Pour plus d'informations, reportez-vous à Accès aux fichiers journaux pour l'export Data Pump.

   Oracle Data Pump divise chaque partie de fichier dump en segments plus petits pour accélérer les téléchargements. La console Oracle Cloud Infrastructure Object Storage affiche plusieurs fichiers pour chaque partie de fichier dump que vous exportez. La taille affichée pour les fichiers dump réels est zéro (0) et celle affichée pour les segments de fichier associés 10 Mo ou moins. Exemples :

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

   Le téléchargement du fichier dump de zéro octet à partir de la console Oracle Cloud Infrastructure ou à l'aide de l'interface de ligne de commande Oracle Cloud Infrastructure ne vous fournit pas les fichiers dump complets. Pour télécharger les fichiers dump complets à partir de la banque d'objets, utilisez un outil prenant en charge Swift, tel que curl, et fournissez votre nom de connexion utilisateur et votre jeton d'authentification Swift. Exemples :

   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 de format type avec la valeur datapump, vous devez uniquement fournir le nom de fichier principal. Les procédures qui prennent en charge le type de format 'datapump' repèrent et télécharge automatiquement les segments.

   Lorsque vous utilisez DBMS_CLOUD.DELETE_OBJECT, la procédure repère et supprime automatiquement les blocs quand elle supprime le fichier principal.

4. Effectuez les étapes requises pour utiliser l'import Oracle Data Pump et le nettoyage.

   Pour plus de détails, reportez-vous à Téléchargement des fichiers dump, exécution de l'import Data Pump et nettoyage de la banque d'objets.