Usar o Data Pump para Exportar Dados para o Cloud Object Storage no Oracle Database 26ai

O Oracle Database 26ai suporta exportações diretas do Oracle Data Pump do Autonomous AI Database para o seguinte Cloud Object Storage:

Oracle Cloud Infrastructure Object Storage
Amazon S3
Armazenamento do Blob do Azure ou Armazenamento do Data Lake do Azure
Google Cloud Storage

Com esse método de exportação, o Oracle Data Pump grava os arquivos de dump diretamente no Cloud Object Storage de destino. Você não precisa primeiro salvar os arquivos de dump em um diretório de banco de dados e depois carregá-los separadamente.

Para executar uma exportação direta, você:

Crie uma credencial para o Cloud Object Storage de destino usando DBMS_CLOUD.CREATE_CREDENTIAL.
Especifique o nome da credencial usando o parâmetro credential do Data Pump.
Especifique a localização do Cloud Object Storage de destino usando o parâmetro dumpfile.
Execute a Exportação do Data Pump usando um arquivo de parâmetros.

Para obter informações gerais sobre como usar o parâmetro credential do Data Pump, consulte Usar o Oracle Data Pump para exportar dados para o Object Store usando o parâmetro CREDENTIAL (Versão 19.9 ou Posterior).

Antes de Começar

Antes de começar:

Crie um bucket ou contêiner no Cloud Object Storage de destino.
Obtenha as credenciais necessárias para acessar o Cloud Object Storage de destino.
Instale o Oracle Data Pump 19.9 ou uma versão posterior. A Oracle recomenda o uso da versão mais recente de Downloads do Oracle Instant Client, incluindo o pacote Ferramentas.
Estabeleça conexão com o Autonomous AI Database usando o serviço HIGH para obter o melhor desempenho de exportação.

O parâmetro directory especifica o diretório de banco de dados usado para o arquivo de log do Data Pump. Os arquivos de dump são gravados diretamente no Cloud Object Storage Service especificado pelo parâmetro dumpfile.

Criar uma Credencial do Cloud Object Storage

Crie uma credencial para o Cloud Object Storage para o qual você deseja exportar os arquivos de dump.

Exemplos

Os exemplos a seguir mostram como criar credenciais para cada Cloud Object Storage suportado. Use o nome da credencial que você cria no arquivo de parâmetros do Data Pump correspondente.

Armazenamento de Objetos do OCI

Para o Oracle Cloud Infrastructure Object Storage, use a autenticação nativa do OCI suportada para o Oracle Database 26ai. Por exemplo:

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

Amazon S3

Para o Amazon S3, especifique o ID da chave de acesso da AWS como username e a chave de acesso secreto da AWS como password:

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

Armazenamento de Blob do Azure

Para Armazenamento Blob do Azure ou Armazenamento do Data Lake do Azure, especifique o nome da conta de armazenamento como username e o token de assinatura de acesso compartilhado (SAS) como password:

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

Google Cloud Storage

Para o Google Cloud Storage, crie uma credencial usando as informações da conta de serviço exigidas pelo método de autenticação do Google Cloud Storage. Por exemplo:

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

Para obter mais informações:

Criar um Arquivo de Parâmetros do Data Pump

Crie um arquivo de parâmetros que especifique os objetos a serem exportados, a credencial e o URL do Cloud Object Storage. Os exemplos a seguir usam o DATA_PUMP_DIR para o arquivo de log e o %L para criar arquivos de dump adicionais, conforme necessário.

Exportar um Esquema para o Armazenamento Blob do Azure

O seguinte arquivo de parâmetros exporta o esquema HR para o Armazenamento de Blob do 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

Exportar um Banco de Dados Completo para o Amazon S3

O arquivo de parâmetros a seguir exporta o banco de dados completo para o 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

Exportar um Banco de Dados Completo para o OCI Object Storage

O arquivo de parâmetros a seguir exporta o banco de dados completo para um bucket do OCI Object Storage. Ele usa a credencial OCI_OBJECT_STORAGE_CRED criada na etapa anterior.

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

Neste exemplo, o Data Pump usa a credencial do OCI para autenticar com o Object Storage e grava os arquivos de dump no bucket especificado. Substitua <NAMESPACE>, <REGION> e <BUCKET> pelos valores da sua tenancy do OCI.

Exportar um Esquema para o Google Cloud Storage

O arquivo de parâmetros a seguir exporta o esquema HR para um bucket do Google Cloud Storage. Ele usa a credencial GCS_CRED criada na etapa anterior.

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

Neste exemplo, o Data Pump exporta somente o esquema HR e grava os arquivos de dump no bucket do Google Cloud Storage especificado.

Executar a Exportação do Data Pump

Execute a Exportação do Data Pump com o arquivo de parâmetros. Por exemplo:

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

Para o exemplo do Amazon S3, execute:

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

Para o exemplo do OCI Object Storage, execute:

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

Para o exemplo do Google Cloud Storage, execute:

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

O arquivo de log do Data Pump é gravado em DATA_PUMP_DIR. Os arquivos de dump são gravados no URL do Cloud Object Storage especificado no arquivo de parâmetros.

Observações de Uso

Use o serviço de banco de dados HIGH para obter o melhor desempenho de exportação.
Defina parallel como aproximadamente um quarto das ECPUs disponíveis.
A variável de substituição %L cria vários arquivos de dump conforme necessário.
Considere o uso de compression=all para grandes exportações.
Use encryption_pwd_prompt=yes ao exportar dados confidenciais. Use a mesma senha de criptografia ao importar os arquivos de dump.
Para executar uma exportação completa ou exportar objetos pertencentes a outros usuários, você precisa da atribuição DATAPUMP_CLOUD_EXP.
Para obter informações sobre como fazer download de arquivos de dump, executar a Importação do Data Pump e limpar o armazenamento de objetos, consulte Fazer Download de Arquivos de Dump, Executar Importação do Data Pump e Limpar o Armazenamento de Objetos.

Para obter informações detalhadas sobre os parâmetros de Exportação do Data Pump, consulte Oracle AI Database Utilities.

Documentação do Oracle Cloud Infrastructure