Carregar Dados Usando o Oracle Data Pump

O Oracle Data Pump oferece movimentação muito rápida de dados em massa e de metadados entre bancos de dados da Oracle e o Autonomous Database on Dedicated Exadata Infrastructure.

A Importação do Data Pump permite que você importe dados de arquivos do Data Pump que residem no Oracle Cloud Infrastructure Object Storage e no Oracle Cloud Infrastructure Object Storage Classic. Você pode salvar seus dados no Cloud Object Store e usar o Oracle Data Pump para carregar os dados no Autonomous Database.

Observação:

Para ter a opção de "testar" para ler os tópicos a seguir, você pode conferir o Lab 9: Migrate with Data Pump no Oracle Autonomous Database Dedicated for Fleet Administrators Workshop.

Tópicos Relacionados

Exportar Dados do Oracle Database Existente

Primeiro você usa o Oracle Data Pump Export para exportar os esquemas existentes do Oracle Database. Em seguida, use o Oracle Data Pump Import para migrá-los para o Autonomous Database.

A Oracle recomenda o uso dos seguintes parâmetros do Data Pump Export para uma migração mais rápida e fácil para o Autonomous Database:

exclude=cluster, db_link
parallel=n
schemas=schema name
dumpfile=export%l.dmp

O Oracle Data Pump Export fornece vários modos de exportação. A Oracle recomenda o uso do modo de esquema para migrar para o Autonomous Database. Você pode listar os esquemas que deseja exportar usando o parâmetro schemas.

Para uma migração mais rápida, exporte seus esquemas em vários arquivos do Data Pump e use paralelismo. Você pode especificar o formato do nome do arquivo de dump que deseja usar com o parâmetro dumpfile. Defina o parâmetro parallel como pelo menos o número de CPUs que você tem no seu Autonomous Database.

Os parâmetros excluir e data_options garantem que os tipos de objeto não disponíveis no Autonomous Database não sejam exportados e as partições de tabela sejam agrupadas para que possam ser importadas mais rapidamente para o Autonomous Database.

Observação:

A Oracle recomenda que você colete as estatísticas atualizadas antes de executar o comando expdp. O pacote dbms_stats fornece vários procedimentos para coletar as estatísticas mais recentes. As estatísticas são adicionadas automaticamente ao arquivo de dump de exportação e ajudam a determinar o tamanho dos objetos e otimizar o paralelismo durante a importação. Para obter mais informações, consulte DBMS_STATS Operational Notes em Oracle Database 19c PL/SQL Packages and Types Reference e Oracle Database 23ai PL/SQL Packages and Types References.

O exemplo a seguir exporta o esquema SH de um Oracle Database de origem para migração para um Autonomous Database com 16 CPUs:

expdp sh/sh@orcl \
exclude=cluster, db_link \
parallel=16 \
schemas=sh \
dumpfile=export%l.dmp \
encryption_pwd_prompt=yes

Observações para parâmetros do Data Pump:

Se durante a exportação com expdp você usar o parâmetro encryption_pwd_prompt=yes, use também encryption_pwd_prompt=yes com sua importação e digite a mesma senha no prompt impdp para decriptografar os arquivos de dump ( lembre-se da senha fornecida durante a exportação). O tamanho máximo da senha de criptografia é 128 bytes.
O parâmetro dumpfile suporta os curingas %L e %l, além dos curingas legados %U e %u. Por exemplo, dumpfile=export%L.dmp.

Use o curinga %L ou %l para exportações do Oracle Database Release 12.2 e posterior. Este curinga expande o nome do arquivo de dump em um inteiro de incremento de largura variável de 3 dígitos para 10 dígitos, começando em 100 e terminando em 2147483646.

Use o curinga legado %U ou %u para exportações do Oracle Database anteriores à Release 12.2. Se você usar essa opção e mais de 99 arquivos de dump forem necessários, especifique vários nomes de arquivos de dump, cada um com o parâmetro %U ou %u.

Você pode usar outros parâmetros do Data Pump Export, como compression, dependendo dos seus requisitos. Para obter mais informações, consulte Oracle Data Pump Export em Oracle Database 19c Utilities ou Oracle Database 23ai Utilities.

Fazer Upload dos Arquivos de Exportação para o Cloud Object Storage

Para importar os dados exportados do Oracle Database de origem, você precisa fazer upload dos arquivos de exportação para o armazenamento de objetos na nuvem.

Você pode fazer upload dos arquivos de exportação para um bucket de armazenamento existente no Oracle Cloud Infrastructure Object Storage ou um contêiner de armazenamento existente no Oracle Cloud Infrastructure Object Storage Classic. Como alternativa, use o procedimento a seguir para criar um novo bucket de armazenamento e fazer upload dos arquivos de exportação para ele.

Acesse a sua Conta do Oracle Cloud em cloud.oracle.com.
Na lista de navegação esquerda do Oracle Cloud Infrastructure, escolha Armazenamento de Objetos e, em seguida, escolha Armazenamento de Objetos na sublista.
Selecione um compartimento no qual criar o bucket de armazenamento.
Clique em Criar Bucket.
Na caixa de diálogo Criar Bucket, dê um nome ao bucket e clique em Criar Bucket.
Depois que o bucket for criado, clique em seu nome na lista de buckets para exibir a página Detalhes do Bucket.
Na caixa Objetos, clique em Fazer Upload de Objetos.
Na caixa de diálogo Fazer Upload de Objetos, clique no link selecionar arquivos na caixa Escolher Arquivos em seu Computador.
No browser de arquivos, navegue e selecione os arquivos de exportação. Em seguida, clique em Abrir.
Na caixa de diálogo Carregar Objetos, clique em Carregar Objetos para iniciar o upload dos arquivos selecionados.
Depois que os uploads forem concluídos, feche a caixa de diálogo Fazer Upload de Objetos.

Importar Dados Usando o Oracle Data Pump

A Oracle recomenda o uso da versão mais recente do Oracle Data Pump para importar dados de arquivos do Data Pump para seu Autonomous Database, pois eles contêm aprimoramentos e correções para proporcionar uma melhor experiência.

Faça download da versão mais recente do Pacote Oracle Instant Client Basic e do Pacote de Ferramentas (que inclui o Oracle Data Pump) para sua plataforma em Downloads do Oracle Instant Client. Consulte as instruções de instalação na página de download de instalação da plataforma para obter as etapas de instalação necessárias depois de fazer download do Oracle Instant Client.

No Oracle Data Pump versão 18.3 e posterior, o argumento credential autentica o Data Pump para o serviço Cloud Object Storage que você está usando para seus arquivos de origem. O argumento dumpfile corresponde a uma lista delimitada por vírgulas de URLs para seus arquivos do Data Pump.

As versões 12.2.0.1 e anteriores da Importação do Data Pump não têm o parâmetro credential. Se você estiver usando uma versão mais antiga da Importação do Data Pump, defina uma propriedade de credencial padrão para o Autonomous Database e use a palavra-chave default_credential no parâmetro dumpfile.

No Oracle Data Pump, se seus arquivos de origem residirem no Oracle Cloud Infrastructure Object Storage, você poderá usar URIs nativos do Oracle Cloud Infrastructure ou URIs Swift. Consulte Formatos de URI do Cloud Object Storage para obter detalhes sobre esses formatos de URI.

Armazene sua credencial do Cloud Object Storage usando o procedimento DBMS_CLOUD.CREATE_CREDENTIAL.

A Importação do Data Pump suporta credenciais baseadas em Token de Autenticação do Oracle Cloud Infrastructure e credenciais baseadas em Chave de Assinatura do Oracle Cloud Infrastructure.
Exemplo 1: Para criar credenciais do Token de Autenticação do Oracle Cloud Infrastructure:
```
BEGIN
DBMS_CLOUD.CREATE_CREDENTIAL(
  credential_name => 'DEF_CRED_NAME',
  username => 'adb_user@oracle.com',
  password => 'password'
  );
END;
/
```
Exemplo 2: Para criar credenciais baseadas em Chave de Assinatura do Oracle Cloud Infrastructure:
```
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL (
    credential_name => 'DEF_CRED_NAME',
    user_ocid       => ‘ocid1.user.oc1..unique_ID’,
    tenancy_ocid    => ‘ocid1.tenancy.oc1..unique_ID’,
    private_key     => ‘MIIEogIBAAKCAQEAtUnxbmre.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
    fingerprint     => ‘fingerprint value’
  );
END;
/
```
Para obter mais informações sobre os tipos de credencial do Oracle Cloud Infrastructure Cloud Object Storage, consulte Procedimento CREATE_CREDENTIAL.
Se você estiver usando o Oracle Data Pump versão 12.2.0.1 ou anterior, defina a credencial como a credencial padrão para seu Autonomous Database, como o usuário ADMIN. Por exemplo:
```
alter database property set default_credential = 'ADMIN.DEF_CRED_NAME'
```
Execute a Importação do Data Pump com o parâmetro dumpfile definido como a lista de URLs de arquivo no Cloud Object Storage.
- Oracle Data Pump versão 18.3 ou posterior: defina o parâmetro credential para o nome da credencial criada na Etapa 1. Por exemplo:
```
impdp admin/password@ATPC1_high \
  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 \
  transform=segment_attributes:n \
  exclude=cluster, db_link
```
  Neste exemplo, dumpfile corresponde a um URI Swift do Oracle Cloud Infrastructure que especifica todos os arquivos cujo nome corresponde a export<number>.dmp no bucket mybucket na região us-phoenix-1. (idthydc0kinr corresponde ao namespace do armazenamento de objetos no qual o bucket reside.)
- Oracle Data Pump versão 12.2.0.1 ou anterior: inicie o valor do parâmetro dumpfile com a palavra-chave default_credential e dois-pontos. Por exemplo:
```
impdp admin/password@ATPC1_high \
  dumpfile=default_credential:https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/idthydc0kinr/mybucket/export%l.dmp \
  parallel=16 \      
  transform=segment_attributes:n \      
  exclude=cluster, db_link
```
Observações para Importação do Data Pump
- Se durante a exportação com expdp você tiver usado o parâmetro encryption_pwd_prompt=yes, use encryption_pwd_prompt=yes e digite a mesma senha no prompt impdp especificado durante a exportação.
- O parâmetro dumpfile suporta os curingas %L e %l, além dos curingas legados %U e %u. Por exemplo, dumpfile=export%L.dmp.
  
  Use o curinga %L ou %l para exportações do Oracle Database Release 12.2 e posterior. Este curinga expande o nome do arquivo de dump em um inteiro de incremento de largura variável de 3 dígitos para 10 dígitos, começando em 100 e terminando em 2147483646.
  
  Use o curinga legado %U ou %u para exportações do Oracle Database anteriores à Release 12.2. Se você usar essa opção e mais de 99 arquivos de dump forem necessários, especifique vários nomes de arquivos de dump, cada um com o parâmetro %U ou %u.
- Para obter o melhor desempenho de importação, use o serviço de banco de dados high para sua conexão de importação e defina o parâmetro parallel para o número de CPUs que seu banco de dados possui.
- Para obter o formato de URL do arquivo de dump de diferentes serviços do Cloud Object Storage, consulte Formatos de URI do Cloud Object Storage.
- Para executar uma importação completa ou importar objetos pertencentes a outros usuários, você precisa da atribuição DATAPUMP_CLOUD_IMP.
Para obter informações sobre objetos não permitidos no Autonomous Database, consulte Limitações no Uso de Comandos SQL.

Para obter informações detalhadas sobre os parâmetros de importação, consulte Oracle Data Pump Import em Oracle Database 19c Utilities ou Oracle Database 23ai Utilities.

Acessar Arquivos de Log do Data Pump Import

Os arquivos de log das operações de Importação do Data Pump são armazenados no diretório especificado com o parâmetro impdp directory do data pump.

Para acessar o arquivo de log, mova-o para o Cloud Object Storage usando o procedimento DBMS_CLOUD.PUT_OBJECT. Por exemplo, o seguinte bloco PL/SQL move o arquivo import.log para o Cloud Object Storage:

BEGIN
  DBMS_CLOUD.PUT_OBJECT(
    credential_name => 'DEF_CRED_NAME',
    object_uri => 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucketname/o/import.log',
    directory_name  => 'DATA_PUMP_DIR',
    file_name => 'import.log');
END;
/

Neste exemplo, namespace-string corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e bucketname corresponde ao nome do bucket. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.

Para obter mais informações, consulte DBMS_CLOUD para Objetos e Arquivos.

Título e Informações de Copyright

Oracle e/ou suas empresas afiliadas.