Utilisation de Data Pump pour exporter des données vers Cloud Object Storage dans Oracle Database 26ai

Oracle Database 26ai prend en charge les exportations directes Oracle Data Pump d'Autonomous AI Database vers le stockage d'objets cloud suivant :

Oracle Cloud Infrastructure Object Storage
Amazon S3
Stockage Azure Blob ou stockage Azure Data Lake
Google Cloud Storage

Avec cette méthode d'export, Oracle Data Pump écrit les fichiers dump directement dans le stockage d'objets cloud cible. Vous n'avez pas besoin d'enregistrer les fichiers dump dans un répertoire de base de données, puis de les télécharger séparément.

Pour effectuer un export direct, procédez comme suit :

Créez des informations d'identification pour le stockage d'objet cloud cible à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL.
Indiquez le nom des informations d'identification à l'aide du paramètre credential Data Pump.
Indiquez l'emplacement Cloud Object Storage cible à l'aide du paramètre dumpfile.
Exécutez Data Pump Export à l'aide d'un fichier de paramètres.

Pour obtenir des informations générales sur l'utilisation du paramètres credential de Data Pump, reportez-vous à la section Use Oracle Data Pump to Export Data to Object Store Using CREDENTIAL Parameter (version 19.9 ou ultérieure).

Avant de commencer

Avant de commencer :

Créez un bucket ou un conteneur dans le stockage d'objet cloud cible.
Obtenez les informations d'identification requises pour accéder au stockage d'objet cloud cible.
Installez Oracle Data Pump version 19.9 ou ultérieure. Oracle recommande d'utiliser la dernière version d'Oracle Instant Client Downloads, y compris le package Tools.
Connectez-vous à Autonomous AI Database à l'aide du service HIGH pour obtenir les meilleures performances d'export.

Le paramètre directory indique le répertoire de base de données utilisé pour le fichier journal Data Pump. Les fichiers dump sont écrits directement dans le service Cloud Object Storage indiqué par le paramètre dumpfile.

Création d'informations d'identification Cloud Object Storage

Créez des informations d'identification pour le stockage d'objet cloud vers lequel exporter les fichiers dump.

Exemples

Les exemples suivants montrent comment créer des informations d'identification pour chaque stockage d'objet cloud pris en charge. Utilisez le nom des informations d'identification que vous créez dans le fichier de paramètres Data Pump correspondant.

OCI Object Storage

Pour Oracle Cloud Infrastructure Object Storage, utilisez l'authentification native OCI prise en charge pour Oracle Database 26ai. Par exemple :

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'OCI_OBJECT_STORAGE_CRED',
    username        => 'oci_user@example.com',
    password        => 'oci_authentication_token'
  );
END;
/

Amazon S3

Pour Amazon S3, indiquez l'ID de clé d'accès AWS comme username et la clé d'accès secrète AWS comme password :

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'AWS_S3_CRED',
    username        => 'AKIAEXAMPLE123456789',
    password        => 'aws_secret_access_key'
  );
END;
/

Stockage BLOB Azure

Pour Azure Blob Storage ou Azure Data Lake Storage, indiquez le nom du compte de stockage username et le jeton de signature d'accès partagé (SAS) password :

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'AZURE_BLOB_CRED',
    username        => 'myadlsstorageacct',
    password        => 'azure_sas_token'
  );
END;
/

Google Cloud Storage

Pour Google Cloud Storage, créez des informations d'identification à l'aide des informations de compte de service requises par votre méthode d'authentification Google Cloud Storage. Par exemple :

BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'GCS_CRED',
    username        => 'gcs-service-account@example-project.iam.gserviceaccount.com',
    password        => 'google_private_key'
  );
END;
/

Informations supplémentaires:

Créer un fichier de paramètres Data Pump

Créez un fichier de paramètres qui indique les objets à exporter, les informations d'identification et l'URL Cloud Object Storage. Les exemples suivants utilisent DATA_PUMP_DIR pour le fichier journal et %L pour créer des fichiers dump supplémentaires si nécessaire.

Export d'un schéma vers le stockage BLOB Azure

Le fichier de paramètres suivant exporte le schéma HR vers le stockage BLOB Azure :

schemas=HR
credential=AZURE_BLOB_CRED
dumpfile=https://<azure_storage_account>.blob.core.windows.net/<container>/hr_exp%L.dmp
filesize=5GB
parallel=8
directory=DATA_PUMP_DIR
logfile=hr_export.log
encryption_pwd_prompt=yes

Exporter une base de données complète vers Amazon S3

Le fichier de paramètres suivant exporte la base de données complète vers Amazon S3 :

full=y
credential=AWS_S3_CRED
dumpfile=https://s3.<aws_region>.amazonaws.com/<bucket>/adb_exp%L.dmp
filesize=5GB
parallel=8
directory=DATA_PUMP_DIR
logfile=aws_export.log
encryption_pwd_prompt=yes

Export d'une base de données complète vers OCI Object Storage

Le fichier de paramètres suivant exporte la base de données complète vers un bucket OCI Object Storage. Elle utilise les informations d'identification OCI_OBJECT_STORAGE_CRED créées à l'étape précédente.

full=y
credential=OCI_OBJECT_STORAGE_CRED
dumpfile=https://<namespace>.objectstorage.<region>.oci.customer-oci.com/n/<namespace>/b/<bucket>/o/adb_exp%L.dmp
filesize=5GB
parallel=8
directory=DATA_PUMP_DIR
logfile=oci_export.log
encryption_pwd_prompt=yes

Dans cet exemple, Data Pump utilise les informations d'identification OCI pour s'authentifier auprès d'Object Storage et écrit les fichiers dump dans le bucket indiqué. Remplacez <NAMESPACE>, <REGION> et <BUCKET> par les valeurs de votre location OCI.

Exporter un schéma vers Google Cloud Storage

Le fichier de paramètres suivant exporte le schéma HR vers un bucket Google Cloud Storage. Elle utilise les informations d'identification GCS_CRED créées à l'étape précédente.

schemas=HR
credential=GCS_CRED
dumpfile=https://storage.googleapis.com/<BUCKET>/hr_exp%L.dmp
filesize=5GB
parallel=8
directory=DATA_PUMP_DIR
logfile=gcs_export.log
encryption_pwd_prompt=yes

Dans cet exemple, Data Pump exporte uniquement le schéma HR et écrit les fichiers dump vers le bucket Google Cloud Storage indiqué.

Exécuter l'export Data Pump

Exécutez Data Pump Export avec le fichier de paramètres. Par exemple :

expdp admin/<password>@<db_service_name> parfile=azure_expdp.par

Pour l'exemple Amazon S3, exécutez :

expdp admin/<password>@<db_service_name> parfile=aws_expdp.par

Pour l'exemple OCI Object Storage, exécutez :

expdp admin/<password>@<db_service_name> parfile=oci_expdp.par

Pour l'exemple Google Cloud Storage, exécutez :

expdp admin/<password>@<db_service_name> parfile=gcs_expdp.par

Le fichier journal Data Pump est écrit dans DATA_PUMP_DIR. Les fichiers dump sont écrits dans l'URL Cloud Object Storage indiquée dans le fichier de paramètres.

Notes d'utilisation

Utilisez le service de base de données HIGH pour obtenir les meilleures performances d'export.
Définissez parallel sur environ un quart des ECPU disponibles.
La variable de substitution %L crée plusieurs fichiers dump si nécessaire.
Envisagez d'utiliser compression=all pour les exportations volumineuses.
Utilisez encryption_pwd_prompt=yes lors de l'export de données confidentielles. Utilisez le même mot de passe de cryptage lorsque vous importez les fichiers dump.
Pour effectuer un export complet ou export des objets appartenant à d' autres utilisateurs, vous devez disposer du rôle DATAPUMP_CLOUD_EXP.
Pour plus d'informations sur le téléchargement des fichiers dump, l'exécution de l'import Data Pump et le nettoyage de l'import d'objets, reportez-vous à Téléchargement des fichiers dump, exécution de l'import Data Pump et nettoyage de l'import d'objets.

Pour plus d'informations sur les paramètres d'export Data Pump, reportez-vous à Utilitaires Oracle AI Database.

Documentation Oracle Cloud Infrastructure