Manter Planilhas Google Em sintonia com seu banco de dados PostgreSQL, de acordo com um cronograma
Escreva o SQL uma única vez. O Query Streams o executa de acordo com sua programação, de cinco minutos a uma vez por semana, e grava as linhas em sua planilha do Google Sheets. Combine linhas por uma chave para que as edições sejam refletidas corretamente e as linhas que não foram processadas sejam removidas, ou simplesmente anexe-as. Sem Zapier, sem scripts, sem exportações. Leva cerca de quinze minutos na primeira vez, e o plano gratuito cobre esse serviço.
O resultado final será o que você obterá.
Uma planilha do Google Sheets que armazena as linhas retornadas pela sua consulta PostgreSQL e é atualizada periodicamente, a cada cinco minutos ou semanalmente, com um recibo das alterações realizadas a cada execução. Algo assim:
O PostgreSQL armazena seus dados em um servidor gerenciado por você ou sua equipe. Sua equipe trabalha no Google Sheets. A solução usual é usar um script do Apps Script ou um zap do Zapier que é executado silenciosamente e copia uma linha por vez. O Query Streams Automation faz isso de forma diferente: o agente, que já está conectado ao seu banco de dados PostgreSQL, executa o SQL salvo de acordo com uma programação e grava todo o resultado no Google Sheets de uma só vez, combinando as linhas por uma chave para que a planilha permaneça correta em vez de crescer.
O que você vai precisar
Uma conta do Query Streams
O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.
PostgreSQL conectado através do Agente
O agente foi instalado no mesmo diretório do seu banco de dados PostgreSQL, com a conexão adicionada em Agentes de Dados. Ainda não terminou? Conecte-se ao PostgreSQL primeiro.Leva cerca de dez minutos.
Uma consulta salva
A lista SELECT que você deseja manter sincronizada, salva em Construtor de consultasO passo 1 abaixo mostra um exemplo. Se você quiser que as linhas alteradas sejam atualizadas no mesmo local, inclua uma coluna que seja exclusiva para cada linha, como um ID.
Seu login do Google Sheets
O Google pede que você permita que o Query Streams veja e edite apenas as planilhas que você selecionar. Ele não poderá ver mais nada no seu Drive.
Onde o trabalho é realizado? No computador que executa o Agente. Ele executa a consulta conforme o agendamento e grava as linhas no Google Sheets, portanto, esse computador precisa permanecer ligado. Seu navegador pode ser fechado. O Query Streams em si nunca armazena as linhas.
Configure em seis etapas
-
Salve a consulta que deseja manter sincronizada.
Aberto Construtor de consultasSelecione sua conexão PostgreSQL (ainda não está conectado? Comece aqui), e escreva a instrução SELECT que retorne exatamente as linhas e colunas desejadas no Google Sheets. Esta, por exemplo, extrai algumas colunas de uma clientes mesa:
Exemplo · SQLSELECT customer_id, name, city FROM public.customers ORDER BY name LIMIT 100;
Execute-o e então Salvar Dê a ela um nome que você reconheça, como "Pedidos do Google Sheets". Mantenha uma coluna que seja única por linha na consulta SELECT, aqui. ID do clienteEssa é a chave que o Full Sync usa para atualizar linhas diretamente. Edite e salve a consulta novamente mais tarde, e a automação detectará a alteração na próxima execução.
-
Abra a seção Automação e escolha Planilhas Google.
No portal, abra Automação (menu superior) Fluxos → Agendados → Automação) e clique Nova automaçãoO mago tem cinco passos curtos. Etapa 1 clique no Planilhas Google cartão.
Prefere ver “Antes de Começar”? O assistente só abre quando um agente está online com uma conexão e existe pelo menos uma consulta salva. A página lista qual dos três itens está faltando e fornece um link para ele.
-
Conecte o Google Sheets
Sobre Etapa 2 clique Conecte-se com o Google SheetsUma janela do Google será aberta; faça login e permita o acesso. O Google solicitará que você permita que o Query Streams veja e edite apenas as planilhas que você selecionar. Ele não poderá ver mais nada no seu Drive. Já se conectou alguma vez? A página oferece Use esta conexão em vez de.
-
Escolha onde as linhas vão ficar.
Sobre Etapa 3 escolha o Planilha: clique Selecione no Google Drive e selecione-o no seletor de arquivos do Google ou digite um nome em Criar nova planilha e clique em CriarEm seguida, escolha o Folha (a aba). Uma automação por aba; uma aba que já esteja sendo usada por outra automação é exibida como ocupada.
-
Selecione a consulta e decida como as linhas serão exibidas.
Sobre Etapa 4 abra o Consulta salva Liste e escolha a consulta da etapa 1. O Query Streams a executa uma vez para ler as colunas, informa quantas linhas foram retornadas e mostra duas opções:
Anexar · rápidoAnexar
A cada execução, as linhas da consulta são adicionadas ao final da planilha. Nada é atualizado nem excluído, sendo a opção ideal para armazenar logs, eventos e histórico que você deseja acumular. Não é necessária nenhuma coluna chave. Uma linha que retorna sem alterações não é adicionada novamente; uma linha cujos valores foram alterados é adicionada abaixo como uma nova linha, e a linha antiga permanece.
Sincronização completa · espelhosSincronização total
As linhas são correspondidas por um chave coluna como um ID de pedido. Novas linhas são adicionadas, as linhas alteradas são atualizadas no mesmo local e as linhas que não são mais retornadas pela consulta são removidas, incluindo linhas digitadas manualmente na planilha. Portanto, mantenha as linhas digitadas manualmente em outra aba. Essa é a opção ideal para estoque, pipelines, dados mestres e dashboards.
A sincronização completa é configurada por coluna, o que a torna útil em uma planilha compartilhada:
- Chave
- A coluna que identifica uma linha, por exemplo ID do pedidoO resultado da consulta precisa ser único; o Query Streams verifica isso para você e rejeita duplicatas.
- Sincronização
- Os dados são sobrescritos a partir do PostgreSQL a cada execução. Se alguém editar uma coluna de sincronização no Google Sheets, a próxima execução restaurará o valor original.
- Preservar
- Escrita quando a linha chega pela primeira vez e nunca comparada novamente, portanto, uma alteração nela no PostgreSQL não aciona uma atualização. Para notas, responsáveis e datas de acompanhamento digitadas manualmente pela sua equipe, use uma coluna que não esteja na consulta: colunas que existem apenas no Google Sheets nunca são afetadas por uma sincronização.
Qual é mais rápido? A opção "Anexar" grava os dados sem ler a planilha primeiro. A opção "Sincronização Completa" lê a planilha, compara cada linha e grava apenas as diferenças, por isso leva mais tempo, mas a planilha sempre corresponde à consulta. Você pode alternar entre as opções posteriormente no painel Editar da automação.
Para uma planilha em que você pode confiar, clique aqui. Criar todas as colunas como SíncronasEm seguida, clique no ícone da chave. ID do cliente para torná-lo o ChaveO Query Streams examina todo o resultado para confirmar se a chave é única e avisa caso contrário. Mantenha as anotações da sua equipe em colunas que não fazem parte da consulta; essas nunca são alteradas. Para um registro que só deve crescer, clique em Criar todas as colunas como Preservar Em vez disso, ignore a tecla. Clique. Continuar.
-
Defina o cronograma, dê um nome a ele, crie-o.
Sobre Etapa 5 escolher Executar de acordo com um cronograma e escolha um Freqüência:
Freqüência Corridas A cada 5 minutos a cada 5 minutos, o mais rápido permitido A cada 15 minutos a cada 15 minutos A cada 30 minutos a cada 30 minutos A cada hora no início de cada hora Diariamente às 9h todos os dias às 9:00, o padrão Diariamente às 6h da manhã todos os dias às 6:00 De segunda a sexta, às 9h. De segunda a sexta-feira, às 9h. Semanalmente (segunda-feira, 9h) todas as segundas-feiras às 9:00 Horário personalizado seus próprios minutos, horas, dias da semana ou dia do mês Os tempos seguem o Fuso horário Você escolhe, que começa como o do seu navegador. Você também pode escolher Somente manual e pressione Executar Você pode agendar a execução quando quiser; um agendamento pode ser adicionado posteriormente no painel Editar da automação. As execuções agendadas ocorrem no Agente, portanto, continuam mesmo com o navegador fechado. Se o computador que executa o Agente estiver desligado quando uma execução estiver agendada, a execução perdida ocorrerá uma única vez, logo após o Agente ser reiniciado.
Dê uma olhada. Nome da integração, como “Pedidos para o Google Sheets, diariamente”, verifique o Pronto para criar Resumo e clique Criar AutomaçãoDe volta à página de Automação, pressione Executar Faça a primeira sincronização agora, em vez de esperar pelo agendamento. Abra o Google Sheets: as linhas estão lá, abaixo dos cabeçalhos das colunas.
É isso. A partir de agora, a planilha se mantém atualizada automaticamente. Nada sai da sua rede, exceto as linhas retornadas pela consulta, e ninguém precisa se lembrar de executar nada.
O que você vê depois
O Página de Automação Lista todas as automações com seu status, origem, destino, chave, agendamento, última sincronização e número de linhas. Abra uma para a Execuções Aba: cada execução com seu gatilho (manual ou agendado), duração e linhas criadas, atualizadas, excluídas e inalteradas. Desempenho A aba mostra os dados processados e a taxa de sucesso ao longo de 7 a 90 dias.
Você será avisado quando isso parar.
Toda organização tem uma Problemas de sincronização Regra de alerta desde o primeiro dia: uma notificação no aplicativo e um e-mail quando uma sincronização falha, e mais um quando ela é recuperada. Uma mensagem por incidente, nunca uma por nova tentativa. Desative ou altere os canais em Fluxos → Alertas e Relatórios.
Ele para sozinho quando deveria.
Se o Google Sheets parar de aceitar a conexão ou o conector de dados for excluído, a automação será pausada e informará o motivo. Reconecte ou selecione uma nova fonte e clique em "Retomar". Outros erros manterão a programação em andamento e serão exibidos na linha.
Coluna chave ausente
Se alguém renomear ou excluir a coluna principal no Google Sheets, a Sincronização Completa será interrompida antes de gravar qualquer coisa e exibirá uma mensagem de erro. Opções de correçãoRecoloque o cabeçalho e execute novamente, ou comece do zero. Suas outras colunas nunca são excluídas por uma sincronização.
O que os planos permitem
A automação está presente em todos os planos, inclusive no gratuito, sem limite para a quantidade de automações que você pode criar. O que cada plano limita é o número de linhas que uma consulta pode retornar por execução:
| Plano | Linhas por execução |
|---|---|
| Gratuito | 125 |
| Núcleo Pessoal | 500 |
| Personal Plus | 1,000 |
| Núcleo de negócios | 2,500 |
| Negócios Plus | 5,000 |
| Business Max | 10,000 |
| Núcleo Empresarial | 25,000 |
| Enterprise Plus | 100,000 |
| Empresa Max | 250,000 |
Se uma consulta retornar mais resultados, a execução é suspensa em vez de interrompida, e a automação informa qual plano é mais adequado ou sugere a adição de um filtro, como um intervalo de datas. Cada execução bem-sucedida também é contabilizada no seu limite do Data Realm, o mesmo conjunto de dados usado pelas suas consultas do Excel e do Planilhas Google. Consulte a página de preços. pelas verbas.
Boas próximas jogadas
- Adicionar um filtro para a consulta, como os últimos 90 dias, para que a planilha permaneça pequena e rápida e se ajuste ao limite de linhas do seu plano.
- Mantenha as anotações digitadas à mão em colunas separadas., fora da consulta, para que sobrevivam a cada sincronização.
- Agrupe suas automações No painel Editar, depois de ter alguns, a página Automação filtra por grupo.
Perguntas que as pessoas fazem
A sincronização irá sobrescrever as anotações que minha equipe adiciona no Google Sheets?
Não, se as anotações estiverem em uma coluna própria. Colunas que existem apenas no Planilhas Google e não na sua consulta nunca são alteradas; portanto, adicione uma coluna "Anotações" ou "Proprietário" ao lado das colunas sincronizadas e digite nelas. Colunas marcadas Sincronização são restaurados para o valor do PostgreSQL a cada execução; Preservar As colunas são preenchidas quando uma linha chega pela primeira vez e não são comparadas posteriormente.
Meus dados do PostgreSQL são armazenados pelo Query Streams?
Não. O Agente executa a consulta no seu lado e envia as linhas diretamente para o Google Sheets por meio de um link criptografado. O Query Streams mantém a configuração, o agendamento e a contagem de linhas por execução, não as linhas em si.
Meu computador precisa ficar ligado o tempo todo?
O processo é realizado pelo Agente, pois é ele que executa a consulta e grava os dados no Google Sheets. Seu próprio laptop e navegador podem ser fechados. Se esse computador estiver desligado quando uma execução estiver agendada, a execução perdida ocorrerá apenas uma vez, logo após o Agente ser reiniciado.
Posso alterar a consulta mais tarde?
Sim. Edite e salve no Construtor de Consultas e a próxima execução usará a nova versão automaticamente. Se você adicionar ou remover colunas, abra o painel Editar da automação para mapeá-las.
É possível que duas automações escrevam na mesma aba?
Não, apenas uma automação por guia. Direcione uma segunda automação para uma guia diferente ou amplie a consulta da primeira.
O plano gratuito realmente cobre isso?
Sim. O plano gratuito é permanente, não um período de teste com prazo de validade. A automação está incluída em todos os planos; o que varia de plano para plano é a quantidade de linhas que uma consulta pode retornar por execução. Veja exatamente o que o plano gratuito inclui. página de preços.
Guias relacionados
Todos os guias para PostgreSQL
Não é bem a sua configuração?
- Seu banco de dados está hospedado no Supabase, Neon, Amazon RDS ou Azure? Selecione o cartão do provedor correspondente, cole a string de conexão e preencha os campos; o processo a partir daí é o mesmo → Supabase, Neon, Amazon RDS, Azure Postgres
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
- Test connection cannot reach the database server? Open the database's port in Windows Defender Firewall on the computer it runs on → Open a firewall port on Windows
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

