Exportar Dados para um Diretório Usando DBMS_CLOUD.EXPORT_DATA

Use DBMS_CLOUD.EXPORT_DATA para exportar arquivos para um diretório.
O diretório para o qual você exporta arquivos pode estar no sistema de arquivos do Autonomous Database ou em um sistema de arquivos externo anexado. Consulte as seguintes páginas para obter mais informações:

Exportar Dados como CSV para um Diretório

Mostra as etapas para exportar dados de tabelas do Autonomous Database para um diretório como dados CSV especificando uma consulta.

  1. Estabeleça conexão com a instância do Autonomous Database.

    Consulte Conectar-se ao Autonomous Database para obter mais informações.

  2. Criar um diretório.

    Por exemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Criar um Diretório para obter mais informações.
  3. Run DBMS_CLOUD.EXPORT_DATA and specify the format parameter type with the value json to export the results as CSV files to a directory. Do not include the credential parameter when sending output to a directory.
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

    Quando os delimitadores de registro incluírem caracteres de escape, como \r\n ou \t, coloque os delimitadores de registro entre aspas duplas. Por exemplo, para usar o delimitador de registro \r\n, coloque o valor entre aspas duplas:"\r\n".

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        query => 'SELECT * FROM sales',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /

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

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

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

    Para obter informações detalhadas sobre os parâmetros format disponíveis que você pode usar com DBMS_CLOUD.EXPORT_DATA, consulte Opções de Formato do Pacote DBMS_CLOUD para EXPORT_DATA.

    Os parâmetros são:

    • file_uri_list: é uma lista delimitada por vírgulas do(s) arquivo(s) 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 json, xml e csv.

    • query: especifica uma instrução SELECT para que apenas os dados necessários sejam exportados. A consulta determina o conteúdo do(s) arquivo(s) de dump.

    Observação:

    O procedimento DBMS_CLOUD.EXPORT_DATA cria o(s) arquivo(s) de dump especificado(s) no file_uri_list. O procedimento não substitui arquivos. Se existir um arquivo de dump em file_uri_list, DBMS_CLOUD.EXPORT_DATA gerará outro arquivo com um nome exclusivo. O DBMS_CLOUD.EXPORT_DATA não cria diretórios.

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

Observações para exportação com DBMS_CLOUD.EXPORT_DATA:

  • Se necessário, o parâmetro query fornecido poderá ser uma consulta avançada, como uma consulta que inclui junções ou subconsultas.

  • Especifique o parâmetro format com a opção compression para compactar os arquivos de saída.

Exportar Dados como JSON para um Diretório

Mostra as etapas para exportar dados de tabelas do Autonomous Database para um diretório como dados JSON especificando uma consulta.

  1. Estabeleça conexão com a instância do Autonomous Database.

    Consulte Conectar-se ao Autonomous Database para obter mais informações.

  2. Criar um diretório.

    Por exemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Criar um Diretório para obter mais informações.
  3. Execute DBMS_CLOUD.EXPORT_DATA e especifique o parâmetro format type com o valor json para exportar os resultados como arquivos JSON para um diretório. Não inclua o parâmetro credential ao enviar a saída para um diretório.
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        format => json_object('type' value 'json'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

    Quando os delimitadores de registro incluírem caracteres de escape, como \r\n ou \t, coloque os delimitadores de registro entre aspas duplas. Por exemplo, para usar o delimitador de registro \r\n, coloque o valor entre aspas duplas:"\r\n".

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        query => 'SELECT * FROM sales',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /

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

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

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

    Para obter informações detalhadas sobre os parâmetros format disponíveis que você pode usar com DBMS_CLOUD.EXPORT_DATA, consulte Opções de Formato do Pacote DBMS_CLOUD para EXPORT_DATA.

    Os parâmetros são:

    • file_uri_list: é uma lista delimitada por vírgulas do(s) arquivo(s) 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 json, xml e csv.

    • query: especifica uma instrução SELECT para que apenas os dados necessários sejam exportados. A consulta determina o conteúdo do(s) arquivo(s) de dump.

    Observação:

    O procedimento DBMS_CLOUD.EXPORT_DATA cria o(s) arquivo(s) de dump especificado(s) no file_uri_list. O procedimento não substitui arquivos. Se existir um arquivo de dump em file_uri_list, DBMS_CLOUD.EXPORT_DATA gerará outro arquivo com um nome exclusivo. O DBMS_CLOUD.EXPORT_DATA não cria diretórios.

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

Observações para exportação com DBMS_CLOUD.EXPORT_DATA:

  • Se necessário, o parâmetro query fornecido poderá ser uma consulta avançada, como uma consulta que inclui junções ou subconsultas.

  • Especifique o parâmetro format com a opção compression para compactar os arquivos de saída.

Exportar Dados como Parquet para um Diretório

Mostra as etapas para exportar dados de tabelas do Autonomous Database para um diretório como dados Parquet especificando uma consulta.

  1. Estabeleça conexão com a instância do Autonomous Database.

    Consulte Conectar-se ao Autonomous Database para obter mais informações.

  2. Criar um diretório.

    Por exemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Criar um Diretório para obter mais informações.
  3. Execute DBMS_CLOUD.EXPORT_DATA e especifique o parâmetro format type com o valor json para exportar os resultados como arquivos Parquet para um diretório. Não inclua o parâmetro credential ao enviar a saída para um diretório.
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.parquet',
        format => JSON_OBJECT('type' value 'parquet'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

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

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.parquet',
        format => JSON_OBJECT('type' value 'parquet'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

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

    Para obter informações detalhadas sobre os parâmetros format disponíveis que você pode usar com DBMS_CLOUD.EXPORT_DATA, consulte Opções de Formato do Pacote DBMS_CLOUD para EXPORT_DATA.

    Os parâmetros são:

    • file_uri_list: é uma lista delimitada por vírgulas do(s) arquivo(s) 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 define opcionalmente 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 apenas os dados necessários sejam exportados. A consulta determina o conteúdo do(s) arquivo(s) de dump.

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

Observações para exportação com DBMS_CLOUD.EXPORT_DATA:

  • Se necessário, o parâmetro query fornecido poderá ser uma consulta avançada, como uma consulta que inclui junções ou subconsultas.

  • Especifique o parâmetro format com a opção compression para compactar os arquivos de saída.

  • Consulte DBMS_CLOUD Mapeamento de Tipo de Dados Oracle para Parquet do Pacote para obter detalhes sobre o mapeamento de Tipo para Parquet Oracle.

    Os seguintes tipos não são suportados ou têm limitações em seu suporte para exportar Parquet com DBMS_CLOUD.EXPORT_DATA:

    Tipo Oracle Notas

    BFILE

    Não suportado

    BLOB

    Não suportado

    DATE

    Suportado com a seguinte limitação: DATE o formato suporta apenas data, mês e ano. Hora, minuto e segundos não são suportados.

    Consulte DBMS_CLOUD Mapeamento de Tipo de Dados Oracle para Parquet do Pacote para obter detalhes sobre limitações de formato NLS para exportar DATE para Parquet.

    INTERVAL DAY TO SECOND

    Suportado e tratado como string internamente

    INTERVAL YEAR TO MONTH

    Suportado e tratado como string internamente

    LONG

    Não suportado

    LONG RAW

    Não suportado

    NUMBER

    Suportado com as seguintes limitações:

    • Pode ter precisão máxima de 38 e escala igual a menos que a precisão.
    • Se nenhuma precisão e escala forem fornecidas para o tipo de coluna NUMBER, por padrão, a precisão de 38 e a escala de 20 serão usadas.
    • A escala negativa não é suportada para tipos NUMBER.

    Object Types

    Não suportado

    TIMESTAMP

    Suportado com as seguintes limitações:

    • Se houver várias colunas com precisão diferente, a precisão mais alta será obtida.
    • TIMESTAMP WITH TIME ZONE O tipo de dados Oracle usará apenas o timestamp.

    Consulte DBMS_CLOUD Mapeamento de Tipo de Dados Oracle para Parquet do Pacote para obter detalhes sobre limitações de formato NLS para exportar TIMESTAMP para Parquet.

Exportar Dados como XML para um Diretório

Mostra as etapas para exportar dados de tabelas do Autonomous Database para o Diretório como dados XML especificando uma consulta.

  1. Estabeleça conexão com a instância do Autonomous Database.

    Consulte Conectar-se ao Autonomous Database para obter mais informações.

  2. Criar um diretório.

    Por exemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Criar um Diretório para obter mais informações.
  3. Execute DBMS_CLOUD.EXPORT_DATA e especifique o parâmetro format type com o valor json para exportar os resultados como arquivos XML para um diretório. Não inclua o parâmetro credential ao enviar a saída para um diretório.
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

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

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.xml',
        format => JSON_OBJECT('type' value 'xml'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

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

    Para obter informações detalhadas sobre os parâmetros format disponíveis que você pode usar com DBMS_CLOUD.EXPORT_DATA, consulte Opções de Formato do Pacote DBMS_CLOUD para EXPORT_DATA.

    Os parâmetros são:

    • file_uri_list: é uma lista delimitada por vírgulas do(s) arquivo(s) 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 json, xml e csv.

    • query: especifica uma instrução SELECT para que apenas os dados necessários sejam exportados. A consulta determina o conteúdo do(s) arquivo(s) de dump.

    Observação:

    O procedimento DBMS_CLOUD.EXPORT_DATA cria o(s) arquivo(s) de dump especificado(s) no file_uri_list. O procedimento não substitui arquivos. Se existir um arquivo de dump em file_uri_list, DBMS_CLOUD.EXPORT_DATA gerará outro arquivo com um nome exclusivo. O DBMS_CLOUD.EXPORT_DATA não cria diretórios.

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

Observações para exportação com DBMS_CLOUD.EXPORT_DATA:

  • Se necessário, o parâmetro query fornecido poderá ser uma consulta avançada, como uma consulta que inclui junções ou subconsultas.

  • Especifique o parâmetro format com a opção compression para compactar os arquivos de saída.