Obtenha dados de um DuckDB arquivo em Planilhas Google
Abra seu banco de dados DuckDB no Google Sheets e atualize-o 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 mostrando os resultados em tempo real de uma consulta SQL no seu arquivo DuckDB, com um botão que exibe 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 |
Os bancos de dados DuckDB são arquivos únicos, geralmente com a extensão .duckdb. .duckdbO Google Sheets não consegue abrir esses arquivos, e a solução usual é exportar um CSV e carregá-lo novamente sempre que os dados forem alterados. O Query Streams evita isso: um pequeno programa auxiliar lê o arquivo onde ele já está salvo, e um complemento do Google Sheets solicita as linhas desejadas. Os dois não precisam estar no mesmo computador. O arquivo pode estar no computador do escritório e você pode estar em 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 no computador que contém o arquivo
Um pequeno programa que roda em segundo plano e lê o arquivo quando o Google Sheets solicita. O passo 2 abaixo mostra onde obtê-lo.
Seu arquivo DuckDB
Saiba onde fica, por exemplo. C:\Data\vendas.duckdbSe o arquivo estiver armazenado no OneDrive, Dropbox ou Google Drive, certifique-se de que esteja sincronizado com este computador.
Qual computador receberá o Agente? Aquele onde o arquivo está localizado. O Agente precisa conseguir abrir o arquivo diretamente, então ele é instalado nesse computador, e esse computador precisa permanecer ligado. O Google Sheets pode estar em qualquer lugar.Ele é executado no seu navegador, portanto, nada é instalado no local onde você lê os dados.
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 arquivo DuckDB e a execução de consultas a partir do Google Sheets.
Instale o Agente no computador que contém o arquivo.



Faça login e abra DownloadInstale o Agente para o seu sistema no computador onde o arquivo está localizado. 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. O arquivo permanece na máquina e as linhas são enviadas para onde você estiver, pela internet, se necessário. O único componente 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 arquivo DuckDB.
De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector, escolher DuckDBe preencha:
- Nome da conexão
- Qualquer nome que você reconheça mais tarde, como Banco de Dados de Vendas.
- Caminho do arquivo do banco de dados
- Localização do arquivo DuckDB (.duckdb ou .db) no computador do Agente; use a opção Procurar para selecioná-lo.
Clique em Teste de conexãoQuando lê Conectado, clique SalvarA conexão chega ao seu agente em poucos segundos.
O teste falhou? Em nove de cada dez casos, o caminho contém um erro de digitação ou o arquivo está em um computador diferente do Agente. Abra a pasta, copie o caminho da barra de endereços e cole-o novamente.
-
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 main.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? Em vez disso, crie a consulta no portal Query Streams. Construtor de consultas Exibe suas tabelas e colunas para que você possa apontar e clicar. Nos planos Business, você também pode usar o Nova em linguagem natural ("mostre-me os clientes nos EUA") e ele gera o SQL para você. Salve a consulta e ela estará a um clique de distância no portal e na lista de Consultas Salvas do complemento, a partir do plano Personal Core.
É 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 linhas, não o seu arquivo nem o caminho do arquivo.
Perguntas que as pessoas fazem
O arquivo DuckDB precisa estar no computador em que uso o Planilhas Google?
Não. Apenas o agente precisa estar no mesmo local que o seu arquivo DuckDB. 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 lá.
Meu arquivo de banco de dados é carregado em algum lugar?
Não. O agente lê o arquivo no seu computador e envia apenas as linhas solicitadas pela sua consulta. O arquivo permanece onde está.
O arquivo pode estar no OneDrive, Dropbox ou Google Drive?
Sim, desde que esteja sincronizado com o computador onde o Agente está sendo executado, para que o Agente o veja como um arquivo local comum. Direcione a conexão para a cópia sincronizada.
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 DuckDB
Não é bem a sua configuração?
- Você tem uma pasta com arquivos Parquet em vez de um arquivo de banco de dados DuckDB? A opção "Pasta Parquet" lê todos os arquivos como uma única tabela → Parquet Folder

