Exportar Dados como CSV para o Cloud Object Storage

Mostra as etapas para exportar dados de tabelas do Autonomous Database para o Cloud Object Storage como dados CSV especificando uma consulta.

Esse método de exportação suporta todos os Armazenamentos de Objetos na Nuvem suportados pelo Autonomous Database e você pode usar um controlador de recursos do Oracle Cloud Infrastructure para acessar o Armazenamento de Objetos do Oracle Cloud Infrastructure, ARNs (Amazon Resource Names) para acessar o AWS Simple Storage Service (S3), um controlador de serviços do Azure para acessar o armazenamento BLOB do Azure ou o Azure Data Lake Storage ou uma conta de serviço do Google para acessar os recursos do Google Cloud Platform (GCP).

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

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

  2. Armazene a credencial do Cloud Object Storage usando DBMS_CLOUD.CREATE_CREDENTIAL.

    Por exemplo:

    BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'DEF_CRED_NAME',
        username => 'user1@example.com',
        password => 'password'
      );
    END;
    /

    Os valores fornecidos para username e password dependem do serviço de Cloud Object Storage que você está usando.

    A criação de uma credencial para acessar o Oracle Cloud Infrastructure Object Store não será necessária se você ativar as credenciais do controlador de recursos. Para obter mais informações, consulte Usar o Controlador de Recursos para Acessar Recursos do Oracle Cloud Infrastructure.

  3. Execute DBMS_CLOUD.EXPORT_DATA e especifique o parâmetro format type com o valor csv para exportar os resultados como arquivos CSV no Cloud Object Storage.
    Para gerar os arquivos de saída CSV, há duas opções para o parâmetro file_uri_list:
    • Defina o valor file_uri_list com o URL de um bucket existente no Cloud Object Storage.

    • Defina o valor file_uri_list com o URL de um bucket existente no Cloud Object Storage e inclua um prefixo de nome de arquivo a ser usado ao gerar os nomes dos arquivos CSV exportados.

    Se você não incluir o prefixo de nome de arquivo no file_uri_list, o DBMS_CLOUD.EXPORT_DATA fornecerá um. Consulte Nomenclatura de Arquivo para Saída de Texto (CSV, JSON, Parquet ou XML) para obter detalhes.

    O seguinte exemplo mostra DBMS_CLOUD.EXPORT_DATA com um prefixo de nome de arquivo especificado em file_uri_list:

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        credential_name => 'DEF_CRED_NAME',
        file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
        query           => 'SELECT * FROM DEPT',
        format          => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip'));
    END;
    /

    Neste exemplo, namespace-string corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e bucketname corresponde ao nome do bucket. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.

    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.

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

  • O parâmetro query fornecido poderá 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.

  • Especifique o parâmetro format com a opção encryption para criptografar dados durante a exportação. Consulte Criptografar Dados ao Exportar para o Serviço Object Storage para obter mais informações.

  • Quando você não precisar mais dos arquivos exportados, use o procedimento DBMS_CLOUD.DELETE_OBJECT ou os comandos nativos do Cloud Object Storage para excluir os arquivos.