Documentation sur Oracle Cloud Infrastructure

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

Indique comment exporter des données de la base de données Autonomous AI Database vers le stockage d'objets en nuage à l'aide d'Oracle Data Pump Export et de la propriété DEFAULT_CREDENTIAL.

Autonomous AI Database 26ai prend en charge l'exportation Data Pump vers Oracle Cloud Infrastructure Object Storage, Amazon S3, Azure Blob Storage et Google Cloud Storage. Autonomous AI Database 19c prend en charge l'exportation directe de l'extraction de données vers Oracle Cloud Infrastructure Object Storage. Voir Exporter avec les paramètres de données d'identification.

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.

Note

Note : Database Actions fournit un lien pour Oracle Instant Client. Pour accéder à ce lien à partir de Database Actions, sous Téléchargements, cliquez sur Télécharger Oracle Instant Client.

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

  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). Par 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 Data Pump Export, voir Gérer les accès simultanés et les priorités pour Autonomous AI Database.

      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.

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.