Obtenha dados de BigQuery em Planilhas Google
Importe linhas em tempo real do seu banco de dados BigQuery para o Google Sheets e atualize-as quando quiser. Sem uploads de CSV, sem Apps Script, sem copiar e colar. Leva cerca de dez minutos na primeira vez, e o plano gratuito cobre isso.
O resultado final será o que você obterá.
Uma planilha do Google que exibe os resultados em tempo real de uma consulta SQL no seu data warehouse do BigQuery, com um botão que busca as linhas mais recentes sempre que os dados são alterados. Assim:
| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | ID do cliente | primeiro nome | sobrenome | país | total |
| 2 | 1042 | Maria | Álvarez | EUA | 1,284.50 |
| 3 | 1043 | Daniel | Okafor | EUA | 612.00 |
| 4 | 1047 | Priya | Nair | EUA | 2,090.75 |
| 5 | 1051 | Thomas | Berg | EUA | 338.20 |
| 6 | 1056 | Lúcia | Ferreira | EUA | 1,455.00 |
| 7 | 1060 | Kenji | Sato | EUA | 874.10 |
| 8 |
Diretamente do BigQueryO Google BigQuery armazena seus dados em sua própria nuvem. Importá-los para o Google Sheets geralmente significa exportar arquivos CSV que ficam desatualizados assim que são recebidos, ou usar scripts que ninguém quer manter. O Query Streams evita isso: um pequeno programa auxiliar chamado Agente executa a consulta onde seus dados estão armazenados, e um complemento do Google Sheets solicita a ele as linhas desejadas. Somente os resultados são transmitidos por meio de uma conexão criptografada, e o Google Sheets pode ser acessado de qualquer lugar: qualquer navegador, em qualquer dispositivo.
O que você vai precisar
Uma conta do Query Streams
O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.
O Agente em qualquer computador sempre ligado
Um pequeno programa que roda em segundo plano e acessa o BigQuery quando o Google Sheets solicita. Ele só precisa de acesso à internet.
Suas credenciais do BigQuery
Os detalhes da conta ou do projeto e um login que permita a leitura dos dados. Seu administrador pode fornecer um login somente para leitura.
Qual computador receberá o Agente? Qualquer máquina que esteja sempre ligada e que já consiga acessar seu data warehouse do BigQuery. O Google Sheets pode estar em qualquer lugar.Ele é executado no seu navegador.
Conecte-o em cinco etapas
-
Crie sua conta
Vá para my.querystreams.com e inscreva-se. Escolha o Gratuito É um plano real, não uma versão de teste, e abrange a conexão do seu data warehouse BigQuery e a execução de consultas a partir do Google Sheets.
Instale o Agente em qualquer computador que esteja sempre ligado.



Faça login e abra DownloadInstale o Agente em qualquer computador ou servidor que esteja sempre ligado e com acesso à internet. Leva apenas um minuto e, a partir daí, ele inicia automaticamente.
Por que um programa pequeno em vez de um driver? O Agente é um único instalador para Windows, Mac ou Linux (cerca de 85 MB no Windows, um pouco mais de 100 MB no Mac e Linux) que funciona silenciosamente em segundo plano. Ele estabelece uma única conexão de saída criptografada com o Query Streams, da mesma forma que um navegador, portanto, você não precisa abrir nenhuma porta de firewall nem configurar uma VPN. Suas chaves permanecem nessa máquina e as linhas são enviadas para onde você estiver, pela internet, se necessário. A única coisa do seu lado é o complemento.
A página de download mostra Sua chave de acessoCole o código no Agente quando solicitado e aguarde até que o crachá exiba a mensagem. Conectado a fluxos de consultaEssa é a única coisa que você faz no próprio Agente.
-
Aponte para o seu data warehouse do BigQuery.
De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector, escolher Google BigQuerye preencha os detalhes que você coletou anteriormente:
- Nome da conexão
- Qualquer nome que você reconheça mais tarde, como Banco de Dados de Vendas.
- ID do projeto GCP
- O ID do seu projeto do Google Cloud, exibido na parte superior do console do Google Cloud, como por exemplo, my-project-123.
- Método de autenticação
- A forma como o agente faz login no Google; a opção padrão, Chave JSON da conta de serviço, é a mais simples.
- Chave JSON da conta de serviço
- Cole o conteúdo do arquivo de chave que você baixou para uma conta de serviço do Google que possa ler o BigQuery.
Clique em Teste de conexãoQuando lê Conectado, clique SalvarA conexão chega ao seu agente em poucos segundos.
O teste falhou? Geralmente, o problema é um login expirado ou uma permissão ausente. Faça login diretamente no BigQuery com a mesma conta e verifique se ela consegue visualizar os dados.
-
See your data in Query Builder Opcional
You can look at your BigQuery warehouse before Google Sheets is involved at all. Open Construtor de consultas in the portal and pick the connection you just made. The Esquema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click Executar and the rows appear under Resultados. Query Builder is on every plan, Free included.
On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.
-
Adicionar fluxos de consulta ao Google Sheets
Abra qualquer planilha do Google e acesse Extensões → Complementos → Obter complementos, procurar Fluxos de consultae clique InstalarOu instale-o diretamente de Consultar fluxos no Google Workspace MarketplaceO Google pedirá que você permita o complemento; isso é normal.
Depois disso, estará presente em todas as Planilhas Google que você abrir: um ícone do Query Streams no painel lateral à direita, também listado em ExtensõesNão há necessidade de fazer login separadamente. O sistema reconhece a conta do Google que você já utiliza, portanto, o e-mail precisa ser o mesmo cadastrado na sua conta do Query Streams.
-
Puxe sua primeira mesa.
Clique no ícone "Consultar Fluxos" no painel lateral à direita da planilha (ou encontre-o em "Acessar Fluxos"). Extensões). Escolher Fluxo de consulta e selecione a conexão que você acabou de fazer.
Digite a consulta que deseja executar. Esta consulta extrai algumas colunas de uma tabela. pedidos mesa:
Exemplo · SQLSELECT order_id, customer_name, order_total FROM `my-project-123.analytics.orders` ORDER BY order_total DESC LIMIT 100;
Sob Folha de Destino Selecione a aba onde as linhas devem ser exibidas e clique em Executar consultaAs linhas aparecem nessa aba em um ou dois segundos. Clique em "Executar consulta" novamente sempre que os dados forem alterados e a aba será atualizada automaticamente.
Não conhece SQL? Build it in Construtor de consultas first and paste it here, or pick it from Saved Queries if you saved it.
É isso. Seus dados estão na planilha e permanecem atualizados com um clique. Nada saiu da sua rede, exceto as linhas que você solicitou.
Boas próximas jogadas
- Salvar consulta no portal, para que você possa executá-lo novamente com um clique, a partir do Google Sheets ou do Excel.
- Adicionar um filtro como um intervalo de datas, para que a mesma consulta possa responder "este mês" sem precisar editar.
- Compartilhe os resultados Com um colega. Eles veem as fileiras, não suas credenciais.
Perguntas que as pessoas fazem
O meu data warehouse do BigQuery precisa estar no mesmo computador em que uso o Planilhas Google?
Não. Apenas o agente precisa estar no mesmo local que o seu data warehouse do BigQuery. O Google Sheets funciona no seu navegador em qualquer dispositivo. Abra o complemento com a mesma conta do Google e suas conexões estarão prontas.
Meus dados são copiados para o Query Streams?
Não. O agente executa a consulta no local onde seus dados estão armazenados e envia apenas as linhas retornadas. Nada é sincronizado ou armazenado nesse meio tempo.
O plano gratuito realmente cobre isso?
Sim. A versão gratuita é um plano permanente, não um período de teste com prazo de validade. Veja exatamente o que está incluído no plano. página de preços.
A planilha atualiza sozinha?
Clique em Executar Consulta novamente sempre que desejar as linhas mais recentes. Para uma planilha que seja atualizada automaticamente, sem que ninguém precise fazer nada, configure uma Automação no portal do Query Streams (Streams → Automação). Ela está disponível em todos os planos.
Guias relacionados
Todos os guias para BigQuery
Setup trouble?
- Want the Agent to sign in with a login that can only read? Create a read-only database user, with copy-paste SQL for each database → Create a read-only database user
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

