Importar Dados com a Versão Mais Recente ou uma Versão Mais Antiga do Oracle Data Pump

As etapas para importar dados para o Autonomous AI Database com o Oracle Data Pump diferem dependendo da versão do Oracle Data Pump.

Importar Dados Usando o Oracle Data Pump Versão 18.3 ou Posterior

A Oracle recomenda o uso da última versão do Oracle Data Pump para importação de dados de arquivos do Data Pump em seu Autonomous AI Database, pois ele contém aprimoramentos e correções para uma experiência melhor.

Faça o download da versão mais recente de Oracle Instant Client, que inclui Oracle Data Pump, para sua plataforma em Downloads de 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.

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

Para carregar um arquivo de dump do Oracle Data Pump no Cloud Object Storage, execute o Oracle Data Pump Import e inclua o parâmetro credential:

Armazene a sua credencial do Cloud Object Storage usando DBMS_CLOUD.CREATE_CREDENTIAL.

Por exemplo, para criar credenciais do Token de Autenticação do Oracle Cloud Infrastructure com o domínio de Identidades padrão:
```
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'DEF_CRED_NAME',
    username => 'adb_user@example.com',
    password => 'password'
  );
END;
/
```
Para o OCI Object Storage, o valor do parâmetro username deve incluir o domínio de Identidades e o nome de usuário do seu perfil. Você pode encontrar o domínio de Identidades associado a um usuário na Console do Oracle Cloud Infrastructure. Por exemplo, com o domínio de Identidades oracleidentitycloudservice, isso seria:
```
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'DEF_CRED_NAME',
    username => 'oracleidentitycloudservice/adb_user@example.com',
    password => 'password'
  );
END;
/
```
Para obter mais informações sobre a autenticação do Token de Autenticação do Oracle Cloud Infrastructure, consulte Procedimento CREATE_CREDENTIAL.

Por exemplo, para criar credenciais baseadas na Chave de Assinatura do 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;
/
```
Para obter mais informações sobre as credenciais baseadas na Chave de Assinatura do Oracle Cloud Infrastructure, consulte Procedimento CREATE_CREDENTIAL.

Tipos de credencial suportados:
- 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.
  
  Para obter mais informações sobre os tipos de credenciais do Oracle Cloud Infrastructure Cloud Object Storage, consulte Procedimento CREATE_CREDENTIAL.
- O Data Pump suporta o uso de um URL pré-autenticado do Oracle Cloud Infrastructure Object Storage para o parâmetro dumpfile. Quando você usa um URL pré-autenticado, é necessário fornecer o parâmetro credential e o valor credential pode ser NULL. Consulte Usando Solicitações Pré-Autenticadas para obter mais informações.
- O Data Pump suporta o uso de uma credencial de controlador de recursos com impdp. Consulte Importar Dados Usando o Oracle Data Pump Versão 18.3 ou Posterior com o Controlador de Recursos do OCI para obter mais informações.
Execute a Importação de Data Pump com o parâmetro dumpfile definido como a lista de URLs de arquivo no Cloud Object Storage e o parâmetro credencial definido como o nome da credencial criada na etapa anterior.

Por exemplo:
```
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
```
Observações para parâmetros do Data Pump:
- Se durante a exportação com expdp você usou o parâmetro encryption_pwd_prompt=yes, use encryption_pwd_prompt=yes e digite a mesma senha no prompt impdp que você especificou durante a exportação.
- O parâmetro dumpfile suporta os caracteres curinga %L e %l, além dos caracteres curinga %U e %u legados. Por exemplo, dumpfile=export%L.dmp. Use o caractere curinga %L ou %l para exportações do Oracle AI Database Release 12.2 e superior. Este curinga expande o nome do arquivo dumpfile em um inteiro de incremento de largura variável de 3 dígitos a 10 dígitos, começando em 100 e terminando em 2147483646. Use o caractere curinga legado %U ou %u para exportações do Oracle AI Database antes da Versão 12.2. Se você utilizar esta opção e forem necessários mais de 99 arquivos de dump, deverá especificar vários nomes de arquivos de dump, cada um com o parâmetro %U ou %u.
- Se seu bucket e seus dados não residirem em um realm comercial (OC1), no qual os Pontos Finais Dedicados do OCI não são suportados, use o seguinte formato de URI para dumpfile:
```
https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname/o/filename
```
- O parâmetro credential não pode ser um controlador de serviços do Azure, um Amazon Resource Name (ARN) ou uma conta de serviço do Google. Consulte Configurar Políticas e Atribuições para Acessar Recursos para obter mais informações sobre autenticação baseada em controlador de recursos.
- Quando você especifica o valor dumpfile como um URL pré-autenticado, o parâmetro credential é necessário e o valor pode ser NULL.
Consulte Usar a Importação do Oracle Data Pump com um URL Pré-autenticado para obter detalhes sobre as etapas necessárias para usar um URL pré-autenticado.

Para dumpfile, este exemplo usa o formato de URI recomendado usando Pontos Finais Dedicados do OCI para realm comercial (OC1). O namespace-string é o namespace do Oracle Cloud Infrastructure Object Storage e bucketname é o nome do bucket. Consulte Pontos Finais Dedicados do Serviço Object Storage, Regiões e Domínios de Disponibilidade e Noções Básicas de Namespaces do Serviço Object Storage para obter mais informações.

Para obter o formato do URL de arquivo para diferentes serviços do Cloud Object Storage, consulte Formatos do URI DBMS_CLOUD.

Neste exemplo, os seguintes itens foram excluídos durante a Importação do Data Pump:
- Clusters
- Tipos de Índice
- Links do banco de dados
Para executar uma importação completa ou para 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 AI Database, consulte Comandos SQL.

Consulte Observações para Importação com o Oracle Data Pump para obter observações adicionais sobre como usar o Oracle Data Pump Import.

Consulte Importação e Compactação de Tabelas do Oracle Data Pump para obter detalhes sobre a compactação de tabelas usando a importação do Oracle Data Pump no Autonomous AI Database.

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

Importar Dados Usando o Oracle Data Pump Versão 18.3 ou Posterior com o Controlador de Recursos do OCI

O Oracle Data Pump suporta a importação de arquivos do data pump para o seu Autonomous AI Database usando um controlador de recursos do Oracle Cloud Infrastructure como objeto de credencial.

Se você usar o Oracle Data Pump expdp para exportar diretamente para o Object Store, deverá usar a mesma credencial usada para exportar quando importar com impdp. Nesse caso, a importação do Oracle Data Pump não suporta as credenciais do controlador de recursos do Oracle Cloud Infrastructure. Há suporte para outros métodos de upload para usar impdp usando credenciais do controlador de recursos. Por exemplo, se você fizer upload de arquivos do Oracle Data Pump no Object Store usando DBMS_CLOUD.PUT_OBJECT, poderá importar os arquivos usando o Oracle Data Pump impdp usando credenciais do controlador de recursos. Da mesma forma, quando você usa a Console do Oracle Cloud Infrastructure para fazer upload de arquivos do data pump para o Object Store, pode usar credenciais do controlador de recursos para importar para uma instância do Autonomous AI Database com o Oracle Data Pump impdp.

Configure os grupos dinâmicos e as políticas e permita que o controlador de recursos do Oracle Cloud Infrastructure acesse o local do Object Store no qual residem os arquivos do data pump que você deseja importar.

Consulte Usar o Controlador de Recursos para Acessar Recursos da Oracle Cloud Infrastructure para obter mais informações.
Execute a Importação de Data Pump com o parâmetro dumpfile definido como a lista de URLs de arquivo no Cloud Object Storage e o parâmetro credential definido como OCI$RESOURCE_PRINCIPAL.

Por exemplo:
```
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
```
Observações para parâmetros do Data Pump:
- Se durante a exportação com expdp você tiver usado o parâmetro encryption_pwd_prompt=yes, use também encryption_pwd_prompt=yes e insira a mesma senha no prompt impdp especificado durante a exportação.
- O parâmetro dumpfile suporta os caracteres curinga %L e %l, além dos caracteres curinga %U e %u legados. Por exemplo, dumpfile=export%L.dmp. Use o caractere curinga %L ou %l para exportações do Oracle Database Release 12.2 e superior. Este curinga expande o nome do arquivo dumpfile em um inteiro de incremento de largura variável de 3 dígitos a 10 dígitos, começando em 100 e terminando em 2147483646.
  
  Use o caractere curinga legado %U ou %u para exportações do Oracle AI Database antes da Versão 12.2. Se você utilizar esta opção e forem necessários mais de 99 arquivos de dump, deverá especificar vários nomes de arquivos de dump, cada um com o parâmetro %U ou %u.
- Se seu bucket e seus dados não residirem em um realm comercial (OC1), no qual os Pontos Finais Dedicados do OCI não são suportados, use o seguinte formato de URI para dumpfile:
```
https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname/o/filename
```
- Quando você especifica o valor dumpfile como um URL pré-autenticado, o parâmetro credential é necessário e o valor pode ser NULL.
  
  Consulte Usar a Importação do Oracle Data Pump com um URL Pré-autenticado para obter detalhes sobre as etapas necessárias para usar um URL pré-autenticado.

Para dumpfile, este exemplo usa o formato de URI recomendado usando Pontos Finais Dedicados do OCI para realm comercial (OC1). O namespace-string é o namespace do Oracle Cloud Infrastructure Object Storage e bucketname é o nome do bucket. Consulte Pontos Finais Dedicados do Serviço Object Storage, Regiões e Domínios de Disponibilidade e Noções Básicas de Namespaces do Serviço Object Storage para obter mais informações.

Para obter o formato do URL de arquivo para diferentes serviços do Cloud Object Storage, consulte Formatos do URI DBMS_CLOUD.

Neste exemplo, os seguintes itens foram excluídos durante a Importação do Data Pump:

Clusters
Tipos de Índice
Links do banco de dados

Para executar uma importação completa ou para 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 AI Database, consulte Comandos SQL.

Consulte Observações para Importação com o Oracle Data Pump para obter observações adicionais sobre como usar o Oracle Data Pump Import.

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

Importar Dados Usando o Oracle Data Pump Versão 12.2 e Anterior

Você pode importar dados dos arquivos do Data Pump para o Autonomous AI Database usando as versões 12.2.0.1 e anteriores do cliente do Data Pump definindo o parâmetro default_credential.

As versões de Importação 12.2.0.1 e anteriores 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, será necessário definir uma propriedade da credencial padrão para o Autonomous AI Database e usar a palavra-chave default_credential no parâmetro dumpfile.

No Oracle Data Pump, se seus arquivos de origem residirem na Oracle Cloud Infrastructure Object Storage, você poderá usar os URIs nativos da Oracle Cloud Infrastructure, ou URIs Swift. Consulte DBMS_CLOUD URI Formats para obter detalhes sobre esses formatos de URI de arquivo.

Importar com Versões Mais Antigas do Oracle Data Pump e Definindo default_credential

Armazene a sua credencial do Cloud Object Storage usando DBMS_CLOUD.CREATE_CREDENTIAL.

Por exemplo, 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@example.com',
    password => 'password'
  );
END;
/
```
Para obter mais informações sobre a autenticação do Token de Autenticação do Oracle Cloud Infrastructure, consulte Procedimento CREATE_CREDENTIAL.

Por exemplo, para criar credenciais baseadas na Chave de Assinatura do 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;
/
```
Para obter mais informações sobre as credenciais baseadas na Chave de Assinatura do Oracle Cloud Infrastructure, consulte Procedimento CREATE_CREDENTIAL.

Tipos de credencial suportados:
- 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.
  
  Para obter mais informações sobre os tipos de credenciais do Oracle Cloud Infrastructure Cloud Object Storage, consulte Procedimento CREATE_CREDENTIAL.
- O Data Pump suporta o uso de um URL pré-autenticado do Oracle Cloud Infrastructure Object Storage para o dumpfile. Quando você usa um URL pré-autenticado, é necessário definir DEFAULT_CREDENTIAL e o valor DEFAULT_CREDENTIAL pode ser NULL. Consulte Usando Solicitações Pré-Autenticadas para obter mais informações.
- O Data Pump suporta o uso de uma credencial de controlador de recursos com impdp.
Defina a credencial como a credencial padrão para seu Autonomous AI Database, como o usuário ADMIN. Por exemplo:
```
ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'
```
O DEFAULT_CREDENTIAL pode ser um Controlador de Recursos do OCI. Por exemplo:
```
ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'OCI$RESOURCE_PRINCIPAL'
```
Consulte Configurar Políticas e Atribuições para Acessar Recursos para obter mais informações sobre autenticação baseada em controlador de recursos.

Observação

Observação: O valor DEFAULT_CREDENTIAL não pode ser um controlador de serviços do Azure, um Nome de Recurso do Amazon (ARN) ou uma conta de serviço do Google.

O valor DEFAULT_CREDENTIAL poderá ser definido como NULL se você estiver usando um URL pré-autenticado.
Execute a Importação de Data Pump com o parâmetro dumpfile definido como a lista de URLs de arquivo em seu Cloud Object Storage e defina a palavra-chave default_credential. Por exemplo:
```
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
```
Observações para os parâmetros do Data Pump:
- Se durante a exportação com expdp você usou o parâmetro encryption_pwd_prompt=yes, use encryption_pwd_prompt=yes e digite a mesma senha no prompt impdp que você especificou durante a exportação.
- O parâmetro dumpfile suporta os caracteres curinga %L e %l, além dos caracteres curinga %U e %u legados. Por exemplo, dumpfile=export%L.dmp. Use o caractere curinga %L ou %l para exportações do Oracle AI Database Release 12.2 e superior. Este curinga expande o nome do arquivo dumpfile em um inteiro de incremento de largura variável de 3 dígitos a 10 dígitos, começando em 100 e terminando em 2147483646.
  
  Use o caractere curinga %U ou %u legado para exportações do Oracle Database antes da Release 12.2. Se você utilizar esta opção e forem necessários mais de 99 arquivos de dump, deverá especificar vários nomes de arquivos de dump, cada um com o parâmetro %U ou %u.
- Se seu bucket e seus dados não residirem em um realm comercial (OC1), no qual os Pontos Finais Dedicados do OCI não são suportados, use o seguinte formato de URI para dumpfile:
```
https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname/o/filename
```
- Quando você especifica o valor dumpfile como um URL pré-autenticado, a definição do parâmetro default_credential é necessária e o valor pode ser NULL.
  
  Consulte Usar a Importação do Oracle Data Pump com um URL Pré-autenticado para obter detalhes sobre as etapas necessárias para usar um URL pré-autenticado.

Para obter o formato do URL de arquivo para diferentes serviços do Cloud Object Storage, consulte Formatos do URI DBMS_CLOUD.

Neste exemplo, os seguintes itens foram excluídos durante a Importação do Data Pump:

Clusters
Tipos de Índice
Links do banco de dados

Observação

Observação: 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 AI Database, consulte Comandos SQL.

Consulte Observações para Importação com o Oracle Data Pump para obter observações adicionais sobre como usar o Oracle Data Pump Import.

Consulte Importação e Compactação de Tabelas do Oracle Data Pump para obter detalhes sobre a compactação de tabelas usando a importação do Oracle Data Pump no Autonomous AI Database.