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.

1. Armazene 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 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 credencial 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 do controlador de recursos com impdp. Consulte Importar Dados Usando o Oracle Data Pump Versão 18.3 ou Mais Recente com o Controlador de Recursos do OCI para obter mais informações.

2. Execute a Importação do 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ê tiver usado o parâmetro encryption_pwd_prompt=yes, use encryption_pwd_prompt=yes e insira 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.

   • Se seu bucket e seus dados não residirem em um realm comercial (OC1), no qual não há suporte para Pontos Finais Dedicados do OCI, 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 ARN (Amazon Resource Name) 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 no controlador de recursos.

   • Quando você especifica o valor dumpfile como um URL pré-autenticado, o parâmetro credential é obrigató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 o realm comercial (OC1). O namespace-string corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e o bucketname corresponde ao 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 de URL do arquivo de dump de diferentes serviços do Cloud Object Storage, consulte DBMS_CLOUD Formatos de URI.

   Neste exemplo, os seguintes itens são 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 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 Comandos SQL.

   Consulte Observações para Importação com o Oracle Data Pump para obter observações adicionais para usar a Importação do Oracle Data Pump.

   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 Database.

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

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

1. Configure os grupos dinâmicos e as políticas e ative o controlador de recursos do Oracle Cloud Infrastructure para acessar o local do Armazenamento de Objetos no qual residem os arquivos do data pump que você deseja importar.

   Consulte Usar o Controlador de Recursos para Acessar os Recursos do Oracle Cloud Infrastructure para obter mais informações.

2. Execute a Importação do 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 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 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.

   • Se seu bucket e seus dados não residirem em um realm comercial (OC1), no qual não há suporte para Pontos Finais Dedicados do OCI, 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 é obrigató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 o realm comercial (OC1). O namespace-string corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e o bucketname corresponde ao 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 de URL do arquivo de dump de diferentes serviços do Cloud Object Storage, consulte DBMS_CLOUD Formatos de URI.

   Neste exemplo, os seguintes itens são 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 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 Comandos SQL.

   Consulte Observações para Importação com o Oracle Data Pump para obter observações adicionais para usar a Importação do Oracle Data Pump.

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

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

1. Armazene 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 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 credencial 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, a definição de DEFAULT_CREDENTIAL é obrigatória 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 do controlador de recursos com impdp.

2. 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'

   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 no controlador de recursos.

   Observação
   
   O valor DEFAULT_CREDENTIAL não pode ser um controlador de serviços do Azure, um ARN (Amazon Resource Name) 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.

3. Execute a Importação do Data Pump com o parâmetro dumpfile definido como a lista de URLs de arquivo no 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ê tiver usado o parâmetro encryption_pwd_prompt=yes, use encryption_pwd_prompt=yes e insira 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.

   • Se seu bucket e seus dados não residirem em um realm comercial (OC1), no qual não há suporte para Pontos Finais Dedicados do OCI, 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, é necessário definir o parâmetro default_credential 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 o realm comercial (OC1). O namespace-string corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e o bucketname corresponde ao 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 de URL do arquivo de dump de diferentes serviços do Cloud Object Storage, consulte DBMS_CLOUD Formatos de URI.

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

   • Clusters

   • Tipos de Índice

   • Links do banco de dados

Fornece as etapas para usar um URL pré-autenticado (URL PAR) com o Oracle Data Pump Import.

1. Use o Oracle Data Pump expdp e exporte para o armazenamento local.

   Consulte Exportar o Oracle Database Existente para um Arquivo de Banco de Dados Local (Exportar sem Parâmetro de Credencial) para obter mais informações.

2. Faça upload do(s) arquivo(s) de dump para o Oracle Cloud Infrastructure Object Storage.

   Por exemplo, use DBMS_CLOUD.PUT_OBJECT para fazer upload dos arquivos de dump.

3. Crie um URL pré-autenticado no Oracle Cloud Infrastructure Object Storage, seja no bucket do armazenamento de objetos se houver vários arquivos de dump ou no arquivo de dump, se houver apenas um arquivo.

   Consulte Solicitações Pré-Autenticadas do Serviço Object Storage para obter mais informações.

4. Importe o(s) arquivo(s) de dump com o valor do parâmetro dumpfile definido para o URL pré-autenticado.

   Consulte Importar Dados Usando o Oracle Data Pump Versão 18.3 ou Mais Recente para obter mais informações.