Documentação do Oracle Cloud Infrastructure

Exportar Dados para um Diretório como Arquivos do Oracle Data Pump

Você pode exportar dados para um diretório como arquivos de dump do Oracle Data Pump especificando uma consulta.

Com esse método de exportação, você usa o procedimento DBMS_CLOUD.EXPORT_DATA para especificar uma consulta e selecionar os dados a serem exportados como um arquivo de dump para um diretório.

  1. Conecte-se à sua instância do Autonomous AI Database.
  2. Criar um diretório.

    Por exemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Criar Diretório no Autonomous AI Database para obter mais informações.
  3. Exporte dados do Autonomous AI Database para seu diretório como arquivo(s) de dump do Oracle Data Pump com DBMS_CLOUD.EXPORT_DATA e especifique o parâmetro format type como datapump. Por exemplo:
    BEGIN
 DBMS_CLOUD.EXPORT_DATA(
    file_uri_list => 'export_dir:sales.dmp',
    format => json_object('type' value 'datapump'),
    query => 'SELECT * FROM sales'
 );
END;
/

    Exemplo para exportar dados como vários arquivos do Data Pump para um diretório:

    BEGIN
 DBMS_CLOUD.EXPORT_DATA(
    file_uri_list => 'export_dir:sales1.dmp, export_dir:sales2.dmp',
    format => json_object('type' value 'datapump'),
    query => 'SELECT * FROM sales'
 );
END;
/

    Os parâmetros são:

    • file_uri_list: é uma lista delimitada por vírgulas dos arquivos de exportação. O uso de caracteres curinga e de substituição não é suportado no file_uri_list.

    • format: especifica o parâmetro type necessário. Os valores válidos são datapump, json, xml, csv e parquet e também, opcionalmente, define as opções que você pode especificar para a exportação com o Driver de Acesso ORACLE_DATAPUMP.

    • query: especifica uma instrução SELECT para que somente os dados necessários sejam exportados. A consulta determina o conteúdo dos arquivos de dump.

    Observação

    O procedimento DBMS_CLOUD.EXPORT_DATA cria o(s) arquivo(s) de dump que você especificou no file_uri_list.

    Para obter informações detalhadas sobre os parâmetros, consulte ProcedimentoEXPORT_DATA.

Observações para exportar dados com o DBMS_CLOUD.EXPORT_DATA:

  • O diretório fornecido deve existir e você deve estar conectado como usuário ADMIN ou ter acesso WRITE ao diretório.

  • O procedimento não substitui arquivos. Se existir um arquivo de dump no file_uri_list, o DBMS_CLOUD.EXPORT_DATA reportará um erro como: 

    ORA-31641: unable to create dump file  "/u02/exports/123.dmp"
ORA-27038: created file already exists

  • DBMS_CLOUD.EXPORT_DATA não cria diretórios.

  • O nome do diretório faz distinção entre maiúsculas e minúsculas quando está entre aspas duplas.

  • O número de arquivos de dump que o DBMS_CLOUD.EXPORT_DATA gera é determinado quando o procedimento é executado. O número de arquivos de dump gerados depende do número de nomes de arquivos que você fornece no parâmetro file_uri_list, bem como do número de ECPUs disponíveis para a instância, o nível de serviço e o tamanho dos dados.

    Por exemplo, se você usar uma instância do Autonomous AI Database de 2 ECPUs ou o serviço low, um único arquivo de dump será exportado sem paralelismo, mesmo que você forneça vários nomes de arquivo. Se você usar uma instância do Autonomous AI Database com 8 ECPUs com o serviço medium ou high, os jobs poderão ser executados em paralelo e vários arquivos de dump serão exportados se você fornecer vários nomes de arquivo.

  • O valor do parâmetro query que você fornece pode ser uma consulta avançada, se necessário, como uma consulta que inclui junções ou subconsultas.

  • Os arquivos de dump criados com o DBMS_CLOUD.EXPORT_DATA não podem ser importados usando o Oracle Data Pump impdp. Dependendo do banco de dados, você pode usar estes arquivos da seguinte forma:

    • Em um Autonomous AI Database, você pode usar os arquivos de dump com os procedimentos DBMS_CLOUD que suportam o parâmetro format type com o valor 'datapump'. Você pode importar os arquivos de dump usando DBMS_CLOUD.COPY_DATA ou pode chamar DBMS_CLOUD.CREATE_EXTERNAL_TABLE para criar uma tabela externa.

    • Em qualquer outro Oracle Database, como o Oracle Database 19c on-premises, você pode importar os arquivos de dump criados com o procedimento DBMS_CLOUD.EXPORT_DATA usando o driver de acesso ORACLE_DATAPUMP. Consulte Descarregando e Carregando Dados com o Driver de Acesso ORACLE_DATAPUMP para obter mais informações.