Importer des données avec la dernière version d'Oracle Data Pump ou une version plus ancienne

Oracle recommande d'utiliser la dernière version d'Oracle Data Pump pour importer des données à partir de fichiers Data Pump dans votre base de données IA autonome, car elle contient des améliorations et des correctifs pour une meilleure expérience.

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

   Par exemple, pour créer des données d'identification de jeton d'authentification pour Oracle Cloud Infrastructure avec le domaine d'identité par défaut :

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

   Pour le service de stockage d'objets pour OCI, la valeur du paramètre username doit inclure le domaine d'identité et le nom d'utilisateur de votre profil. Vous pouvez trouver le domaine d'identité associé à un utilisateur dans la console Oracle Cloud Infrastructure. Par exemple, avec le domaine d'identité oracleidentitycloudservice, il s'agit des éléments suivants :

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

   Pour plus d'informations sur l'authentification par jeton d'authentification pour Oracle Cloud Infrastructure, voir Procédure CREATE_CREDENTIAL.

   Par exemple, pour créer des données d'identification basées sur la clé de signature Oracle Cloud Infrastructure :

   BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL (
          credential_name => 'DEF_CRED_NAME',
          user_ocid       => ‘ocid1.user.oc1..aaaaaaaauq54mi7zdyfhw33ozkwuontjceel7fok5nq3bf2vwetkpqsoa’,
          tenancy_ocid    => ‘ocid1.tenancy.oc1..aabbbbbbaafcue47pqmrf4vigneebgbcmmoy5r7xvoypicjqqge32ewnrcyx2a’,
          private_key     => ‘MIIEogIBAAKCAQEAtUnxbmrekwgVac6FdWeRzoXvIpA9+0r1.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
          fingerprint     => ‘f2:db:f9:18:a4:aa:fc:94:f4:f6:6c:39:96:16:aa:27’);
   END;
   /

   Pour plus d'informations sur les données d'identification basées sur la clé de signature Oracle Cloud Infrastructure, voir Procédure CREATE_CREDENTIAL.

   Types de données d'identification pris en charge :

   • L'importation Data Pump prend en charge les données d'identification basées sur un jeton d'authentification pour Oracle Cloud Infrastructure et les données d'identification basées sur une clé de signature pour Oracle Cloud Infrastructure.

     Pour plus d'informations sur les types de données d'identification pour le service de stockage d'objets en nuage d'Oracle Cloud Infrastructure, voir Procédure CREATE_CREDENTIAL.

   • Data Pump prend en charge l'utilisation d'une URL préauthentifiée d'Oracle Cloud Infrastructure Object Storage pour le paramètre dumpfile. Lorsque vous utilisez une URL préauthentifiée, vous devez fournir le paramètre credential et la valeur credential peut être NULL. Pour plus d'informations, voir Utilisation des demandes préauthentifiées.

   • Data Pump prend en charge l'utilisation de données d'identification de principal de ressource avec impdp. Pour plus d'informations, voir Importer des données à l'aide d'Oracle Data Pump version 18.3 ou ultérieure avec le principal de ressource OCI.

2. Exécutez Data Pump Import avec le paramètre dumpfile réglé à la liste des URL de fichier dans votre stockage d'objets en nuage et le paramètre credential réglé au nom des données d'identification que vous avez créées à l'étape précédente. Exemple :

   impdp admin/password@db2022adb_high \       
        directory=data_pump_dir \       
        credential=def_cred_name \       
        dumpfile= https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/export%l.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        exclude=cluster,indextype,db_link

   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.

     Utilisez le caractère générique %U ou %u existant pour les exportations à partir d'Oracle Database avant la version 12.2. Si vous utilisez cette option et que plus de 99 fichiers de vidage sont nécessaires, vous devez spécifier plusieurs noms de fichier de vidage, chacun avec le paramètre %U ou %u.

   • 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

   • Le paramètre credential ne peut pas être 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.

   • Lorsque vous spécifiez la valeur dumpfile en tant qu'URL préauthentifiée, le paramètre credential est requis et la valeur peut être NULL.

     Voir Utiliser l'importation Oracle Data Pump avec une URL préauthentifiée pour plus de détails sur les étapes requises pour utiliser une URL préauthentifiée.

   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.

   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.

   Dans cet exemple, les éléments suivants sont exclus lors de l'importation de l'extraction de données :

   • Grappes

   • Indextypes

   • Liens de base de données

   Pour effectuer une importation complète ou pour importer des objets appartenant à d'autres utilisateurs, vous devez disposer du rôle DATAPUMP_CLOUD_IMP.

   Pour plus d'informations sur les objets non autorisés dans la base de données du service d'intelligence artificielle autonome, voir Commandes SQL.

   Voir Notes pour l'importation avec Oracle Data Pump pour des notes supplémentaires sur l'utilisation d'Oracle Data Pump Import.

   Voir Importation et compression de table d'Oracle Data Pump pour plus de détails sur la compression de table à l'aide de l'importation Oracle Data Pump sur Autonomous AI Database.

   Pour plus d'informations sur les paramètres de la fonction d'importation d'Oracle Data Pump, voir Utilitaires d'Oracle Database.

Oracle Data Pump prend en charge l'importation de fichiers Data Pump dans votre base de données Autonomous AI Database à l'aide d'un principal de ressource Oracle Cloud Infrastructure en tant qu'objet de données d'identification.

1. Configurez les groupes dynamiques et les politiques et permettez au principal de ressource Oracle Cloud Infrastructure d'accéder à l'emplacement du magasin d'objets où résident les fichiers d'extraction de données à importer.

   Pour plus d'informations, voir Utiliser un principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure.

2. Exécutez Data Pump Import avec le paramètre dumpfile réglé à la liste des URL de fichier dans votre stockage d'objets en nuage et le paramètre credential réglé à OCI$RESOURCE_PRINCIPAL.

   Exemple :

   impdp admin/password@db2022adb_high \       
        directory=data_pump_dir \ 
        credential= 'OCI$RESOURCE_PRINCIPAL' \ 
        dumpfile= https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/export%l.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        exclude=cluster,indextype,db_link

   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 également 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.

     Utilisez le caractère générique %U ou %u existant pour les exportations à partir d'Oracle Database avant la version 12.2. Si vous utilisez cette option et que plus de 99 fichiers de vidage sont nécessaires, vous devez spécifier plusieurs noms de fichier de vidage, chacun avec le paramètre %U ou %u.

   • 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

   • Lorsque vous spécifiez la valeur dumpfile en tant qu'URL préauthentifiée, le paramètre credential est requis et la valeur peut être NULL.

     Voir Utiliser l'importation Oracle Data Pump avec une URL préauthentifiée pour plus de détails sur les étapes requises pour utiliser une URL préauthentifiée.

   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.

   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.

   Dans cet exemple, les éléments suivants sont exclus lors de l'importation de l'extraction de données :

   • Grappes

   • Indextypes

   • Liens de base de données

   Pour effectuer une importation complète ou pour importer des objets appartenant à d'autres utilisateurs, vous devez disposer du rôle DATAPUMP_CLOUD_IMP.

   Pour plus d'informations sur les objets non autorisés dans la base de données du service d'intelligence artificielle autonome, voir Commandes SQL.

   Voir Notes pour l'importation avec Oracle Data Pump pour des notes supplémentaires sur l'utilisation d'Oracle Data Pump Import.

   Pour plus d'informations sur les paramètres de la fonction d'importation d'Oracle Data Pump, voir Utilitaires d'Oracle Database.

Vous pouvez importer des données à partir de fichiers Data Pump dans votre base de données Autonomous AI Database à l'aide des versions de client Data Pump 12.2.0.1 et antérieures en définissant le paramètre default_credential.

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

   Par exemple, pour créer des données d'identification de jeton d'authentification pour Oracle Cloud Infrastructure :

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

   Pour plus d'informations sur l'authentification par jeton d'authentification pour Oracle Cloud Infrastructure, voir Procédure CREATE_CREDENTIAL.

   Par exemple, pour créer des données d'identification basées sur la clé de signature Oracle Cloud Infrastructure :

   BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL (
          credential_name => 'DEF_CRED_NAME',
          user_ocid       => ‘ocid1.user.oc1..aaaaaaaauq54mi7zdyfhw33ozkwuontjceel7fok5nq3bf2vwetkpqsoa’,
          tenancy_ocid    => ‘ocid1.tenancy.oc1..aabbbbbbaafcue47pqmrf4vigneebgbcmmoy5r7xvoypicjqqge32ewnrcyx2a’,
          private_key     => ‘MIIEogIBAAKCAQEAtUnxbmrekwgVac6FdWeRzoXvIpA9+0r1.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
          fingerprint     => ‘f2:db:f9:18:a4:aa:fc:94:f4:f6:6c:39:96:16:aa:27’);
   END;
   /

   Pour plus d'informations sur les données d'identification basées sur la clé de signature Oracle Cloud Infrastructure, voir Procédure CREATE_CREDENTIAL.

   Types de données d'identification pris en charge :

   • L'importation Data Pump prend en charge les données d'identification basées sur un jeton d'authentification pour Oracle Cloud Infrastructure et les données d'identification basées sur une clé de signature pour Oracle Cloud Infrastructure.

     Pour plus d'informations sur les types de données d'identification pour le service de stockage d'objets en nuage d'Oracle Cloud Infrastructure, voir Procédure CREATE_CREDENTIAL.

   • Data Pump prend en charge l'utilisation d'une URL préauthentifiée d'Oracle Cloud Infrastructure Object Storage pour dumpfile. Lorsque vous utilisez une URL préauthentifiée, la définition de DEFAULT_CREDENTIAL est requise et la valeur DEFAULT_CREDENTIAL peut être NULL. Pour plus d'informations, voir Utilisation des demandes préauthentifiées.

   • Data Pump prend en charge l'utilisation de données d'identification de principal de ressource avec impdp.

2. Définissez les données d'identification comme données d'identification par défaut pour votre base de données d'intelligence artificielle autonome, en tant qu'utilisateur ADMIN. Exemple :

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   DEFAULT_CREDENTIAL peut être un principal de ressource OCI. Exemple :

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'OCI$RESOURCE_PRINCIPAL'

   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.

   Note
   
   La valeur DEFAULT_CREDENTIAL ne peut pas être un principal de service Azure, un nom de ressource Amazon (ARN) ou un compte de service Google.

   La valeur DEFAULT_CREDENTIAL peut être réglée à NULL si vous utilisez une URL préauthentifiée.

3. Exécutez Data Pump Import avec le paramètre dumpfile réglé à la liste des URL de fichier dans votre stockage d'objets en nuage, puis réglez le mot clé default_credential. Exemple :

   impdp admin/password@db2022adb_high \      
        directory=data_pump_dir \
        dumpfile=default_credential:https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/export%l.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        exclude=cluster,indextype,db_link
   

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

     Utilisez le caractère générique %U ou %u existant pour les exportations à partir d'Oracle Database avant la version 12.2. Si vous utilisez cette option et que plus de 99 fichiers de vidage sont nécessaires, vous devez spécifier plusieurs noms de fichier de vidage, chacun avec le paramètre %U ou %u.

   • 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

   • Lorsque vous spécifiez la valeur dumpfile en tant qu'URL préauthentifiée, la définition du paramètre default_credential est requise et la valeur peut être NULL.

     Voir Utiliser l'importation Oracle Data Pump avec une URL préauthentifiée pour plus de détails sur les étapes requises pour utiliser une URL préauthentifiée.

   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.

   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.

   Dans cet exemple, les éléments suivants sont exclus lors de l'importation de l'extraction de données :

   • Grappes

   • Indextypes

   • Liens de base de données

Fournit les étapes permettant d'utiliser une URL préauthentifiée (URL PAR) avec l'importation d'Oracle Data Pump.

1. Utilisez Oracle Data Pump expdp et exportez-les vers le stockage local.

   Pour plus d'informations, voir Exporter votre base de données Oracle Database existante dans un fichier de base de données locale (Exporter sans paramètre de données d'identification).

2. Chargez les fichiers de vidage vers Oracle Cloud Infrastructure Object Storage.

   Par exemple, utilisez DBMS_CLOUD.PUT_OBJECT pour charger les fichiers de vidage.

3. Créez une URL préauthentifiée sur le service de stockage d'objets pour Oracle Cloud Infrastructure Object Storage, sur le seau du magasin d'objets s'il existe plusieurs fichiers de vidage ou sur le fichier de vidage, s'il n'y a qu'un seul fichier.

   Pour plus d'informations, voir Demandes préauthentifiées de stockage d'objets.

4. Importez les fichiers de vidage avec la valeur du paramètre dumpfile réglée à l'URL préauthentifiée.

   Pour plus d'informations, voir Importer des données à l'aide d'Oracle Data Pump version 18.3 ou ultérieure.