Exportar os resultados da consulta para um arquivo

Este documento descreve como salvar resultados de consulta como um arquivo, como CSV ou JSON.

Fazer o download de resultados de consulta para um arquivo local

Não é possível fazer o download dos resultados da consulta para um arquivo local usando a ferramenta de linha de comando bq ou a API.

Para fazer o download dos resultados da consulta como um arquivo CSV ou JSON delimitado por linhas novas, use o console :Google Cloud

  1. No console do Google Cloud , abra a página do BigQuery.

    Acessar o BigQuery

  2. Clique em Consulta SQL.

  3. Insira uma consulta GoogleSQL válida na área de texto do Editor de consultas.

  4. Opcional: para alterar o local de processamento, clique em Mais e selecione Configurações de consulta. Em Local dos dados, escolha o local dos dados.

  5. Clique em Executar.

  6. Quando os resultados forem retornados, clique em Salvar resultados e selecione o formato ou local em que quer salvá-los.

    O arquivo é salvo no local de download padrão do navegador.

Salvar os resultados da consulta no Google Drive

Não é possível salvar os resultados da consulta no Google Drive usando a ferramenta de linha de comando bq ou a API.

Talvez você veja um erro ao tentar salvar os resultados do BigQuery no Google Drive. Esse erro ocorre porque a API SDK do Drive não pode acessar o Google Workspace. Para resolver o problema, ative sua conta de usuário para acessar o Google Drive com a API do SDK do Drive.

Para salvar os resultados da consulta no Google Drive, use o Google Cloud console:

  1. No console do Google Cloud , abra a página do BigQuery.

    Acessar o BigQuery

  2. Clique em Consulta SQL.

  3. Insira uma consulta GoogleSQL válida na área de texto do Editor de consultas.

  4. Clique em Executar.

  5. Quando os resultados forem retornados, clique em Salvar resultados.

  6. Em Google Drive, selecione CSV ou JSON. Não é possível selecionar o local ao salvar os resultados no Google Drive. Eles sempre são salvos na raiz "Meu Drive".

  7. Pode levar alguns minutos para os resultados serem salvos no Google Drive. Depois que os resultados forem salvos, você vai receber uma mensagem de caixa de diálogo que inclui o nome do arquivo: bq-results-[TIMESTAMP]-[RANDOM_CHARACTERS].[CSV or JSON].

    captura de tela do botão de salvar resultados

  8. Na mensagem de diálogo, clique em Abrir para abrir o arquivo ou navegue até o Google Drive e clique em Meu Drive.

Salvar resultados da consulta no Planilhas Google

Não é possível salvar resultados de consulta no Planilhas Google usando a ferramenta de linha de comando bq ou a API.

Você pode ver um erro ao tentar abrir os resultados do BigQuery no Planilhas Google. Esse erro ocorre porque a API SDK do Drive não pode acessar o Google Workspace. Para resolver o problema, você precisa ativar sua conta de usuário para acessar o Planilhas Google com a API do SDK do Drive.

Para salvar os resultados da consulta no Planilhas Google, use o Google Cloud console:

  1. No console do Google Cloud , abra a página do BigQuery.

    Acessar o BigQuery

  2. Clique em Consulta SQL.

  3. Insira uma consulta GoogleSQL válida na área de texto do Editor de consultas.

  4. Opcional: para alterar o local de processamento, clique em Mais e selecione Configurações de consulta. Em Local dos dados, escolha o local dos dados.

  5. Clique em Executar.

  6. Quando os resultados forem retornados, clique em Salvar resultados e selecione Planilhas Google.

  7. Se necessário, siga as instruções para fazer login na conta de usuário e clique em Permitir para que o BigQuery possa gravar os dados na pasta MY Drive do Google Drive.

    Depois de seguir as instruções, você vai receber um e-mail confirmando que as ferramentas do cliente do BigQuery foram conectadas à sua conta de usuário. O e-mail contém informações sobre as permissões que você concedeu, além das etapas para remover essas permissões.

  8. Depois que os resultados forem salvos, será exibida uma mensagem semelhante a esta abaixo dos resultados da consulta no console Google Cloud : Saved to Sheets as "results-20190225-103531. Open. Clique no link da mensagem para ver os resultados no Planilhas Google ou navegue até a pasta My Drive e abra o arquivo manualmente.

    Quando você salva os resultados da consulta no Planilhas Google, o nome do arquivo começa com results-[DATE], em que [DATE] é a data de hoje no formato YYYYMMDD.

Resolver problemas ao salvar resultados no Planilhas Google

Ao salvar dados do BigQuery no Planilhas Google, talvez você perceba que algumas células das páginas estão em branco. Isso acontece quando os dados que você está gravando na célula excedem o limite de 50.000 caracteres do Planilhas Google. Para resolver isso, use uma função de string na consulta GoogleSQL para dividir a coluna com os dados longos em duas ou mais colunas e salve o resultado em planilhas novamente.

Salvar resultados da consulta no Cloud Storage

Para exportar os resultados da consulta para o Cloud Storage no console Google Cloud , siga estas etapas:

  1. Abra a página do BigQuery no console do Google Cloud .

    Acessar a página do BigQuery

  2. Clique em Consulta SQL.

  3. Insira uma consulta GoogleSQL válida na área de texto do Editor de consultas.

  4. Clique em Executar.

  5. Quando os resultados forem retornados, clique em Salvar resultados > Cloud Storage.

  6. Na caixa de diálogo Exportar para o Google Cloud Storage:

    • Em Local do GCS, procure o bucket, a pasta ou o arquivo em que você quer exportar os dados.
    • Em Formato de exportação, escolha o formato dos dados exportados: CSV, JSON (delimitado por nova linha), Avro ou Parquet.
    • Para Compactação, selecione um formato de compactação ou None para não fazer compactação.

  7. Clique em Salvar para exportar os resultados da consulta.

Para verificar o andamento do job, abra o painel Histórico de jobs e procure o job do tipo EXTRACT.

A seguir