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 AI Database ou em um sistema de arquivos externo anexado. Consulte as seguintes páginas para mais informações:

• Criar e Gerenciar Diretórios

• Anexar o Armazenamento de Arquivos de Rede ao Autonomous AI Database

• Anexar Armazenamento de Arquivos Externo ao Autonomous AI Database

Exportar Dados como CSV para um Diretório

Mostra as etapas para exportar dados da tabela do Autonomous AI Database para um diretório como dados CSV especificando uma consulta.

1. Conecte-se à sua instância do Autonomous AI Database.

   Consulte Estabelecer Conexão com o Autonomous AI 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 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 CSV 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;
    /
   

   Quando os delimitadores de registro incluem 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 de Pacote DBMS_CLOUD para EXPORT_DATA.

   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 json, xml e csv.

   • 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 especificado(s) no file_uri_list. O procedimento não substitui arquivos. Se existir um arquivo de dump no file_uri_list, o DBMS_CLOUD.EXPORT_DATA gerará outro arquivo com um nome exclusivo. 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:

• O parâmetro query fornecido pode ser uma consulta avançada, se necessário, 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 da tabela do Autonomous AI Database para um diretório como dados JSON especificando uma consulta.

1. Conecte-se à sua instância do Autonomous AI Database.

   Consulte Estabelecer Conexão com o Autonomous AI 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 mais informações.

3. Execute o 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 incluem 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 de Pacote DBMS_CLOUD para EXPORT_DATA.

   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 json, xml e csv.

   • 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 especificado(s) no file_uri_list. O procedimento não substitui arquivos. Se existir um arquivo de dump no file_uri_list, o DBMS_CLOUD.EXPORT_DATA gerará outro arquivo com um nome exclusivo. 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:

• O parâmetro query que você fornece pode ser uma consulta avançada, se necessário, 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 da tabela do Autonomous AI Database para um diretório como dados do Parquet especificando uma consulta.

1. Conecte-se à sua instância do Autonomous AI Database.

   Consulte Estabelecer Conexão com o Autonomous AI 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 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 de Pacote DBMS_CLOUD para EXPORT_DATA.

   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.

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

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

• O parâmetro query que você fornece pode ser uma consulta avançada, se necessário, 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 Mapeamento de Tipo de Dados Oracle para Parquet do Pacote DBMS_CLOUD para obter detalhes sobre o mapeamento de Tipo Oracle para Tipo Parquet.

  Os seguintes tipos não são suportados ou têm limitações no 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: o formato DATE suporta apenas data, mês e ano. Não há suporte para hora, minuto e segundos. Consulte DBMS_CLOUD Package Oracle Data Type to Parquet Mapping para obter detalhes sobre as 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 menor que a precisão. - Se nenhuma precisão e escala forem fornecidas para o tipo de coluna NUMBER, por padrão é usada precisão de 38 e escala de 20. - 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, será feita a maior precisão. - TIMESTAMP WITH TIME ZONE O tipo de dados Oracle usará apenas o timestamp. Consulte Tipo de Dados Oracle do Pacote DBMS_CLOUD para Mapeamento de Parquet para obter detalhes sobre as limitações de formato NLS para exportar TIMESTAMP para Parquet.

Exportar Dados como XML para um Diretório

Mostra as etapas para exportar dados da tabela do Autonomous AI Database para o Diretório como dados XML especificando uma consulta.

1. Conecte-se à sua instância do Autonomous AI Database.

   Consulte Estabelecer Conexão com o Autonomous AI 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 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 de Pacote DBMS_CLOUD para EXPORT_DATA.

   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 json, xml e csv.

   • 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 especificado(s) no file_uri_list. O procedimento não substitui arquivos. Se existir um arquivo de dump no file_uri_list, o DBMS_CLOUD.EXPORT_DATA gerará outro arquivo com um nome exclusivo. 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:

• O parâmetro query que você fornece pode ser uma consulta avançada, se necessário, 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.

Conteúdo Relacionado

• Procedimento EXPORT_DATA

• Opções do Formato de Pacote DBMS_CLOUD para EXPORT_DATA