Documentation Oracle Cloud Infrastructure

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

Les étapes d'import de données vers une base de données Autonomous AI avec Oracle Data Pump varient en fonction de la version d'Oracle Data Pump.

Importer des données à l'aide d'Oracle Data Pump version 18.3 ou ultérieure

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 Autonomous AI, 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, qui inclut Oracle Data Pump, pour votre plateforme à partir de la pageTéléchargements Oracle Instant Client. Reportez-vous aux instructions d'installation de la page de téléchargement pour installation sur votre plate-forme afin de connaître les étapes d'installation requises après le téléchargement d'Oracle Instant Client.

Dans Oracle Data Pump versions 18.3 et ultérieures, l'argument credential authentifie Data Pump auprès du service Cloud Object Storage que vous utilisez pour vos fichiers source. L'argument dumpfile est une liste d'URL séparées par une virgule pour vos fichiers Data Pump.

Dans Oracle Data Pump, si vos fichiers source résident dans l'instance Oracle Cloud Infrastructure Object Storage, vous pouvez utiliser des URI natifs Oracle Cloud Infrastructure ou des URI Swift. Pour plus de détails sur ces formats d'URI de fichier, reportez-vous à Formats d'URI DBMS_CLOUD.

Pour charger un fichier dump Oracle Data Pump à partir de Cloud Object Storage, exécutez l'import Oracle Data Pump et incluez le paramètre credential :

  1. Stockez vos informations d'identification de stockage d'objet cloud à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL,

    Par exemple, pour créer des informations d'identification de jeton d'authentification 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 OCI Object Storage, la valeur de paramètre username doit inclure le domaine d'identité et le nom 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 Oracle Cloud Infrastructure, reportez-vous à Procédure CREATE_CREDENTIAL.

    Par exemple, pour créer des informations 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 informations d'identification basées sur la clé de signature Oracle Cloud Infrastructure, reportez-vous à Procédure CREATE_CREDENTIAL.

    Types d'informations d'identification pris en charge :

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

      Pour plus d'informations sur les types d'informations d'identification pour Oracle Cloud Infrastructure Cloud Object Storage, reportez-vous à Procédure CREATE_CREDENTIAL.

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

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

  2. Exécutez l'utilitaire d'import Data Pump avec le paramètre dumpfile défini sur la liste des URL de fichier dans Cloud Object Storage et le paramètre credential défini sur le nom des informations d'identification que vous avez créées à l'étape précédente.

    Par 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

    Remarques concernant les paramètres 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 nom de passe à l'invite impdp que vous avez indiquée 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 AI Database version 12.2 et supérieure. Ce caractère générique étend le nom du fichier dump en un entier incrémentant de 3 à 10 chiffres, de largeur variable, commençant à 100 et se terminant à 2147483646. Utilisez le caractère générique hérité %U ou %u pour les exports à partir d'Oracle AI Database avant la version 12.2. Si vous utilisez cette option et que plus de 99 fichiers dump sont nécessaires, vous devez indiquer plusieurs noms de fichier dump, chacun avec le paramètre %U ou %u.

    • 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

    • 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. Pour plus d'informations sur l'authentification basée sur le principal de ressource, reportez-vous à Configuration de stratégies et de rôles pour accéder aux ressources.

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

    Pour plus de détails sur les étapes requises pour utiliser une URL pré-authentifiée, reportez-vous à Utilisation de l'import Oracle Data Pump avec une URL pré-authentifiée.

    Pour dumpfile, cet exemple utilise le format d'URI recommandé à l'aide d'adresses dédiées OCI pour le domaine commercial (OC1). namespace-string est l'espace de noms Oracle Cloud Infrastructure Object Storage 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.

    Pour le format d'URL d'un fichier dump des différents services Cloud Object Storage, reportez-vous à Formats d'URI de stockage d'objets cloud.

    Dans cet exemple, les éléments suivants sont exclus lors de l'import Data Pump :

    • Clusters

    • Types d'index

    • Liens de base de données

    Pour effectuer un import complet ou importer des objets appartenant à d'autres utilisateurs, vous devez posséder le rôle DATAPUMP_CLOUD_IMP.

    Pour plus d'informations sur les objets non autorisés dans la base de données Autonomous AI, reportez-vous à Commandes SQL.

    Pour plus d'informations sur l'utilisation de l'import Oracle Data Pump, reportez-vous à Remarques sur l'import avec Oracle Data Pump.

    Pour plus de détails sur la compression de table à l'aide de l'import Oracle Data Pump sur la base de données Autonomous AI, reportez-vous à Compression de table et d'import Oracle Data Pump.

    Pour obtenir des informations détaillées sur les paramètres d'import Oracle Data Pump, reportez-vous à l'utilitaire Oracle AI Database.

Import de données à l'aide d'Oracle Data Pump version 18.3 ou ultérieure avec le principal de ressource OCI

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

Si vous utilisez Oracle Data Pump expdp pour effectuer l'export directement vers la banque d'objets, vous devez utiliser les informations d'identification utilisées pour l'export lorsque vous effectuez l'import avec impdp. Dans ce cas, l'import Oracle Data Pump ne prend pas en charge les informations d'identification de principal de ressource Oracle Cloud Infrastructure. D'autres méthodes de téléchargement sont prises en charge pour l'utilisation de impdp à l'aide des informations d'identification de principal de ressource. Par exemple, si vous téléchargez des fichiers Oracle Data Pump sur la banque d'objets à l'aide de DBMS_CLOUD.PUT_OBJECT, vous pouvez importer les fichiers à l'aide d'Oracle Data Pump impdp à l'aide des informations d'identification de principal de ressource. De même, lorsque vous utilisez la console Oracle Cloud Infrastructure pour télécharger des fichiers Data Pump vers la banque d'objets, vous pouvez utiliser les informations d'identification de principal de ressource pour les importer dans une instance de base de données Autonomous AI avec Oracle Data Pump impdp.

Dans Oracle Data Pump, si vos fichiers source résident dans le service Oracle Cloud Infrastructure Object Storage, vous pouvez utiliser des URI natifs Oracle Cloud Infrastructure ou des URI Swift. Pour plus de détails sur ces formats d'URI de fichier, reportez-vous à Formats d'URI DBMS_CLOUD.

  1. Configurez les stratégies et les groupes dynamiques, et activez le principal de ressource Oracle Cloud Infrastructure pour accéder à l'emplacement de la banque d'objets où résident les fichiers Data Pump à importer.

    Pour plus d'informations, reportez-vous à Utilisation du principal de ressource pour accéder aux ressourcesOracle Cloud Infrastructure.

  2. Exécutez l'utilitaire d'import Data Pump avec le paramètre dumpfile défini sur la liste des URL de fichier dans Cloud Object Storage et le paramètre credential défini sur OCI$RESOURCE_PRINCIPAL.

    Par 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

    Remarques concernant les paramètres Data Pump :

    • Si, au cours de l'export avec expdp, vous avez utilisé le paramètre encryption_pwd_prompt=yes, utilisez également encryption_pwd_prompt=yes et saisissez le même mot de passe à l'invite impdp que vous avez indiquée 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 et supérieure. Ce caractère générique étend le nom du fichier dump en un entier incrémentant de 3 à 10 chiffres, de largeur variable, commençant à 100 et se terminant à 2147483646.

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

    • 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

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

      Pour plus de détails sur les étapes requises pour utiliser une URL pré-authentifiée, reportez-vous à Utilisation de l'import Oracle Data Pump avec une URL pré-authentifiée.

Pour dumpfile, cet exemple utilise le format d'URI recommandé à l'aide d'adresses dédiées OCI pour le domaine commercial (OC1). namespace-string est l'espace de noms Oracle Cloud Infrastructure Object Storage 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.

Pour le format d'URL d'un fichier dump des différents services Cloud Object Storage, reportez-vous à Formats d'URI de stockage d'objets cloud.

Dans cet exemple, les éléments suivants sont exclus lors de l'import Data Pump :

  • Clusters

  • Types d'index

  • Liens de base de données

Pour effectuer un import complet ou importer des objets appartenant à d'autres utilisateurs, vous devez posséder le rôle DATAPUMP_CLOUD_IMP.

Pour plus d'informations sur les objets non autorisés dans la base de données Autonomous AI, reportez-vous à Commandes SQL.

Pour plus d'informations sur l'utilisation de l'import Oracle Data Pump, reportez-vous à Remarques sur l'import avec Oracle Data Pump.

Pour obtenir des informations détaillées sur les paramètres d'import Oracle Data Pump, reportez-vous à l'utilitaire Oracle AI Database.

Importer des données à l'aide d'Oracle Data Pump version 12.2 et antérieure

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

Data Pump Import versions 12.2.0.1 et antérieures ne dispose pas du paramètre credential. Si vous utilisez une ancienne version de l'utilitaire d'import Data Pump, vous devez définir une propriété d'informations d'identification par défaut pour Autonomous AI Database et utiliser le mot-clé default_credential dans le paramètre dumpfile.

Dans Oracle Data Pump, si vos fichiers source résident dans le service Oracle Cloud Infrastructure Object Storage, vous pouvez utiliser des URI natifs Oracle Cloud Infrastructure ou des URI Swift. Pour plus de détails sur ces formats d'URI de fichier, reportez-vous à Formats d'URI DBMS_CLOUD.

Importer avec d'anciennes versions d'Oracle Data Pump et définir default_credential

  1. Stockez vos informations d'identification de stockage d'objet cloud à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL,

    Par exemple, pour créer des informations d'identification de jeton d'authentification Oracle Cloud Infrastructure, procédez comme suit :

    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 Oracle Cloud Infrastructure, reportez-vous à Procédure CREATE_CREDENTIAL.

    Par exemple, pour créer des informations 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 informations d'identification basées sur la clé de signature Oracle Cloud Infrastructure, reportez-vous à Procédure CREATE_CREDENTIAL.

    Types d'informations d'identification pris en charge :

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

      Pour plus d'informations sur les types d'informations d'identification pour Oracle Cloud Infrastructure Cloud Object Storage, reportez-vous à Procédure CREATE_CREDENTIAL.

    • Data Pump prend en charge l'utilisation d'une URL pré-authentifiée 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, reportez-vous à Utilisation de demandes pré-authentifiées.

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

  2. Définissez les informations d'identification en tant qu'informations d'identification par défaut pour votre base de données Autonomous AI, en tant qu'utilisateur ADMIN. Par exemple :

    ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

    DEFAULT_CREDENTIAL peut être un principal de ressource OCI. Par exemple :

    ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'OCI$RESOURCE_PRINCIPAL'

    Pour plus d'informations sur l'authentification basée sur le principal de ressource, reportez-vous à Configuration de stratégies et de rôles pour accéder aux ressources.

    Remarque

    Remarque : 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 définie sur NULL si vous utilisez une URL pré-authentifiée.

  3. Exécutez l'utilitaire d'import Data Pump avec le paramètre dumpfile défini sur la liste des URL de fichier dans Cloud Object Storage et définissez le mot-clé default_credential. Par 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 concernant les paramètres 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 nom de passe à l'invite impdp que vous avez indiquée 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 AI Database version 12.2 et supérieure. Ce caractère générique étend le nom du fichier dump en un entier incrémentant de 3 à 10 chiffres, de largeur variable, commençant à 100 et se terminant à 2147483646.

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

    • 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

    • Lorsque vous indiquez la valeur dumpfile en tant qu'URL pré-authentifiée, vous devez définir le paramètre default_credential et la valeur peut être NULL.

      Pour plus de détails sur les étapes requises pour utiliser une URL pré-authentifiée, reportez-vous à Utilisation de l'import Oracle Data Pump avec une URL pré-authentifiée.

Pour dumpfile, cet exemple utilise le format d'URI recommandé à l'aide d'adresses dédiées OCI pour le domaine commercial (OC1). namespace-string est l'espace de noms du 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.

Pour le format d'URL d'un fichier dump des différents services Cloud Object Storage, reportez-vous à Formats d'URI de stockage d'objets cloud.

Dans cet exemple, les éléments suivants sont exclus lors de l'import Data Pump :

  • Clusters

  • Types d'index

  • Liens de base de données

Remarque

Remarque : pour effectuer un import complet ou importer des objets appartenant à d'autres utilisateurs, vous devez posséder le rôle DATAPUMP_CLOUD_IMP.

Pour plus d'informations sur les objets non autorisés dans Autonomous AI Database, reportez-vous à Commandes SQL.

Pour plus d'informations sur l'utilisation de l'import Oracle Data Pump, reportez-vous à Remarques sur l'import avec Oracle Data Pump.

Pour plus de détails sur la compression de table à l'aide de l'import Oracle Data Pump sur la base de données Autonomous AI, reportez-vous à Compression de table et d'import Oracle Data Pump.

Pour obtenir des informations détaillées sur les paramètres d'import Oracle Data Pump, reportez-vous à l'utilitaire Oracle AI Database.

Utiliser l'import Oracle Data Pump avec une URL pré-authentifiée

Fournit les étapes d'utilisation d'une URL pré-authentifiée avec l'import Oracle Data Pump.

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

    Pour plus d'informations, reportez-vous à Export de votre base de données Oracle AI Database existante vers un fichier de base de données locale (export sans paramètre d'informations d'identification).

  2. Téléchargez les fichiers dump vers Oracle Cloud Infrastructure Object Storage.

    Par exemple, utilisez DBMS_CLOUD.PUT_OBJECT pour télécharger les fichiers dump.

  3. Créez une URL pré-authentifiée sur Oracle Cloud Infrastructure Object Storage, soit sur le bucket de banque d'objets s'il existe plusieurs fichiers dump, soit sur le fichier dump s'il n'y a qu'un seul fichier.

    Pour plus d'informations, reportez-vous à Demandes pré-authentifiées Object Storage.

  4. Importez les fichiers dump avec la valeur du paramètre dumpfile définie sur l'URL pré-authentifiée.

    Pour plus d'informations, reportez-vous à Import de données à l'aide d'Oracle Data Pump version 18.3 ou ultérieure.