Importar Dados com a Versão Mais Recente ou uma Versão Mais Antiga do 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.

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

2. 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 Database Release 12.2 e superior. Este curinga expande o nome do arquivo de dump 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

   • 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 importar objetos de propriedade de 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 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 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 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.

2. 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ê usou 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 de dump 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, 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 importar objetos de propriedade de 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 sobre como usar o Oracle Data Pump Import.

   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 12.2.0.1 e anteriores do cliente do Data Pump definindo o parâmetro default_credential.

1. 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 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, é 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.

2. Defina a credencial como a credencial padrão do 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 em controlador de recursos.

   Observação
   
   O valor DEFAULT_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.

   O valor DEFAULT_CREDENTIAL poderá ser definido como NULL se você estiver usando um URL pré-autenticado.

3. 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 Database Release 12.2 e superior. Este curinga expande o nome do arquivo de dump 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 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

Fornece as etapas para usar um URL pré-autenticado (URL PAR) com a Importação do Oracle Data Pump.

1. Use o Oracle Data Pump expdp e exporte para 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 no 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, 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 Posterior para obter mais informações.