Ver categorias

Como conectar o DuckDB ao Google Sheets - Transmita dados do banco de dados analítico ao vivo

4 minutos de leitura

Conectar o DuckDB ao Google Sheets

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.

Cerca de 10 minutos Não é necessário programar O arquivo permanece onde está. Qualquer navegador, qualquer dispositivo
Teve alguma dúvida? É só perguntar. Aberto Suporte Em Fluxos de Consulta (menu no canto superior direito → Suporte) e envie-nos uma mensagem. Pessoas reais leem as mensagens, e "Não sei o que esta tela está pedindo" é uma pergunta perfeitamente válida.

O resultado final será o que você obterá.

Logotipo do DuckDBUma 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:

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.

ONDE O ARQUIVO ESTÁ GUARDADOcomputador do escritório, um servidor ou o de casa.Seu arquivo DuckDBsales.duckdb · permanece aquiAgente de fluxos de consultainstalado ao lado do arquivoFluxos de consultalink criptografadopela internet · apenas resultadosONDE QUER QUE VOCÊ ESTEJAQualquer navegador: laptop, tablet, celular, ChromebookPlanilhas GoogleAs fileiras chegam em uma folha.
O agente fica vinculado ao arquivo. Sua planilha fica armazenada na nuvem do Google. Abra-a em qualquer lugar e as linhas aparecerão para você.

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

  1. 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.

  2. 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.

    Guias completos, se você quiser: Janelas, Mac, Linux.

  3. 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.

  4. 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.

  5. 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 · SQL
    SELECT 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.

Ainda com dificuldades? Aberto Suporte Em Fluxos de Consulta, informe-nos em qual etapa você está e o que você vê. Nós o conectaremos.
O Query Streams também conecta os mesmos dados aExcelClaude, Cursor e ChatGPTuma API RESTe mais

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
Atualizado em 30 de setembro de 2026

Desenvolvido por BetterDocs