Exporte os resultados da consulta para um ficheiro

Este documento descreve como guardar os resultados da consulta como um ficheiro, como CSV ou JSON.

Transfira os resultados da consulta para um ficheiro local

A transferência de resultados de consultas para um ficheiro local não é suportada pela ferramenta de linha de comandos bq nem pela API.

Para transferir os resultados da consulta como um ficheiro CSV ou JSON delimitado por nova linha, use a Trusted Cloud consola:

  1. Na Trusted Cloud consola, abra a página do BigQuery.

    Aceda ao BigQuery

  2. Clique em Consulta SQL.

  3. Introduza uma consulta GoogleSQL válida na área de texto do editor de consultas.

  4. Opcional: para alterar a localização de processamento, clique em Mais e selecione Definições de consulta. Para Localização de dados, escolha a localização dos seus dados.

  5. Clique em Executar.

  6. Quando os resultados forem devolvidos, clique em Guardar resultados e selecione o formato ou a localização onde quer guardar os resultados.

    O ficheiro é transferido para a localização de transferência predefinida do navegador.

Guarde os resultados das consultas no Google Drive

A poupança de resultados de consultas no Google Drive não é suportada pela ferramenta de linha de comandos bq nem pela API.

Pode receber um erro quando tenta guardar os resultados do BigQuery no Google Drive. Este erro deve-se ao facto de a API Drive SDK não conseguir aceder ao Google Workspace. Para resolver o problema, tem de ativar a sua conta de utilizador para aceder ao Google Drive com a API do SDK do Drive.

Para guardar os resultados da consulta no Google Drive, use a Trusted Cloud consola:

  1. Na Trusted Cloud consola, abra a página do BigQuery.

    Aceda ao BigQuery

  2. Clique em Consulta SQL.

  3. Introduza uma consulta GoogleSQL válida na área de texto do editor de consultas.

  4. Clique em Executar.

  5. Quando os resultados forem devolvidos, clique em Guardar resultados.

  6. Em Google Drive, selecione CSV ou JSON. Quando guarda os resultados no Google Drive, não pode escolher a localização. Os resultados são sempre guardados na localização raiz "O meu disco".

  7. Pode demorar alguns minutos a guardar os resultados no Google Drive. Quando os resultados são guardados, recebe uma mensagem de diálogo que inclui o nome do ficheiro — bq-results-[TIMESTAMP]-[RANDOM_CHARACTERS].[CSV or JSON].

  8. Na mensagem de diálogo, clique em Abrir para abrir o ficheiro ou navegue para o Google Drive e clique em O meu disco.

Guarde os resultados da consulta no Google Sheets

A ferramenta de linhas de comando bq ou a API não suportam a gravação dos resultados da consulta no Google Sheets.

Pode receber um erro quando tenta abrir os resultados do BigQuery a partir do Google Sheets. Este erro deve-se ao facto de a API Drive SDK não conseguir aceder ao Google Workspace. Para resolver o problema, tem de ativar a sua conta de utilizador para aceder ao Google Sheets com a API do SDK do Drive.

Para guardar os resultados da consulta no Google Sheets, use a Trusted Cloud consola:

  1. Na Trusted Cloud consola, abra a página do BigQuery.

    Aceda ao BigQuery

  2. Clique em Consulta SQL.

  3. Introduza uma consulta GoogleSQL válida na área de texto do editor de consultas.

  4. Opcional: para alterar a localização de processamento, clique em Mais e selecione Definições de consulta. Para Localização de dados, escolha a localização dos seus dados.

  5. Clique em Executar.

  6. Quando os resultados forem devolvidos, clique em Guardar resultados e selecione Google Sheets.

  7. Se necessário, siga as instruções para iniciar sessão na sua conta de utilizador e clique em Permitir para conceder ao BigQuery autorização para escrever os dados na sua pasta do Google Drive MY Drive.

    Depois de seguir as instruções, deve receber um email a confirmar que as ferramentas de cliente do BigQuery foram associadas à sua conta de utilizador. O email contém informações sobre as autorizações que concedeu, juntamente com os passos para remover as autorizações.

  8. Quando os resultados são guardados, é apresentada uma mensagem semelhante à seguinte abaixo dos resultados da consulta na consola Trusted Cloud : Saved to Sheets as "results-20190225-103531. Open. Clique no link na mensagem para ver os resultados no Google Sheets ou navegue para a pasta My Drive e abra o ficheiro manualmente.

    Quando guarda os resultados da consulta no Google Sheets, o nome do ficheiro começa com results-[DATE], em que [DATE] é a data de hoje no formato YYYYMMDD.

Resolva problemas relacionados com a ação de guardar resultados no Google Sheets

Quando guarda dados do BigQuery no Google Sheets, pode verificar que algumas células nas folhas estão em branco. Isto acontece quando os dados que está a escrever na célula excedem o limite de 50 000 carateres do Google Sheets. Para resolver este problema, use uma função de string na consulta GoogleSQL para dividir a coluna com os dados longos em duas ou mais colunas e, em seguida, guarde novamente o resultado nas folhas.

Guarde os resultados da consulta no Cloud Storage

Pode exportar os resultados da consulta para o Cloud Storage na Trusted Cloud consola com os seguintes passos:

  1. Abra a página do BigQuery na Trusted Cloud consola.

    Aceda à página do BigQuery

  2. Clique em Consulta SQL.

  3. Introduza uma consulta GoogleSQL válida na área de texto do editor de consultas.

  4. Clique em Executar.

  5. Quando os resultados forem devolvidos, clique em Guardar resultados > Armazenamento na nuvem.

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

    • Para Localização do GCS, procure o contentor, a pasta ou o ficheiro onde quer exportar os dados.
    • Para Formato de exportação, escolha o formato dos dados exportados: CSV, JSON (delimitado por nova linha), Avro ou Parquet.
    • Em Compressão, selecione um formato de compressão ou selecione None para não comprimir.

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

Para verificar o progresso da tarefa, expanda o painel Histórico de tarefas e procure a tarefa do tipo EXTRACT.

O que se segue?