Manter Planilhas Google Em consonância com seu arquivo SQLite, 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 SQLite e é atualizada periodicamente, a cada cinco minutos ou semanalmente, com um recibo das alterações realizadas a cada execução. Algo assim:
SQLite holds your data in a file. Your team works in Google Sheets. The usual bridge is an Apps Script or a Zapier zap that breaks quietly and copies one row at a time. Query Streams Automation does it differently: the Agent that already reads your SQLite file runs your saved SQL on a schedule and writes the whole result into Google Sheets in one pass, matching rows by a key so the sheet stays correct rather than growing.
O que você vai precisar
Uma conta do Query Streams
O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.
SQLite conectado através do Agente
The Agent installed on the computer that holds your SQLite file, or on one that reads it from a network share, with the connection added in Data Agents. Not done yet? Conecte o SQLite 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.
File on another computer? The Agent does not have to run on the computer that holds your SQLite file: it can read the file from a network share. Reaching a file on a network share, below, shows what that takes.
Configure em seis etapas
-
Salve a consulta que deseja manter sincronizada.
Aberto Construtor de consultasSelecione sua conexão SQLite (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 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 SQLite 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 SQLite 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.
Reaching a file on a network share
The Agent opens files as a background service, not as you, so a file on another computer needs one extra step. Which step depends on the computer the Agent runs on.
If the test cannot get to the share, look for these words in its result: unreachable means the Agent’s computer got no answer from the server. On Linux or a Mac, not mounted means the share still has to be mounted, and that message includes the exact mount command for your server.
SQLite file on a share? Deixar Read-Only (Immutable) ticked, as it is by default; reads then take a point-in-time view of the file without locks. SQLite cannot use its WAL mode over a network, so with that box unticked a WAL-mode database on a \\servidor\compartilhamento path is refused, and the test says it is a WAL-mode SQLite database.
Test failed on a share?
Every run reaches the file the same way the connection test does. If runs start failing after something changed on the file server, a new password for example, open the connector in Agentes de dados e clique em Teste de conexão. The test result, and the line under the file path, name the problem:
| Mensagem | Causa | Consertar |
|---|---|---|
| SQLite database file not found: followed by a \\servidor\compartilhamento path you know is right | No login is stored, so the Agent tried the share as its own account and could not see the file: the share turned that account away, or the server did not answer. In the first case the line under the path says Access denied for the agent’s service account. | Clique em Service identity under the path and store a login that can read the share. If the line under the path does not say access denied, check that the Agent’s computer can open the share at all. |
| Share \\server: access denied — add credentials for this server | A login is stored, but that account has no permission on the share, or another sign-in to the same server is in the way; the message before this line says which. | Ask whoever runs the server to give that account read access, or store an account that has it. For a sign-in in the way, see the two rows on one login per server below. |
| Share \\server: the credentials were refused — check the username and password | The server turned the stored login down: a typo, the wrong domain, or a password changed since it was saved, which also stops runs that used to work. | Click the chip under the path and type the password again; for an account made on the server itself, leave Domain blank. After a refused login the Agent waits a minute before it tries that same one again, so the account is not locked out; saving a corrected password tries straight away. |
| Share \\server: server unreachable from the agent machine | The Agent’s computer got no answer from the server: a wrong server name, the server is off, or a firewall blocks file sharing. | On the Agent’s computer, open the same \\servidor\compartilhamento path in File Explorer. If that fails too, it is a network problem for whoever runs the network. |
| Another connector on this agent already signs in to \\server as … | Windows lets one computer sign in to a server as one account at a time, and another connector on this Agent uses a different login for that server. | Store the same login the other connector uses, or change it on every connector that reads that server. |
| Windows already holds a sign-in to \\server for … | Something on the Agent’s computer other than the Agent is already signed in to that server as a different account, and the Agent never closes a sign-in it did not make. | Do what the rest of the message says: use that same account on this connector, or close the other sign-in on the Agent’s computer. If it says the share is already readable through that sign-in, choose Use service identity in the login box instead. |
| This agent build cannot sign in to \\server with stored credentials. | The Agent is an older version that cannot use stored logins. | Update the Agent, then test again. |
| \\server\share is not mounted on this Linux agent (ou macOS agent) | The Agent runs on Linux or a Mac and the share has not been mounted on its computer yet; logins stored in the Portal are not used there. | Mount it with the command the message gives you, then test again. Step by step: no Linux · on a Mac. |
| … is a WAL-mode SQLite database | The database uses SQLite’s WAL mode, which cannot work over a network share, and Read-Only (Immutable) is unticked on the connector. | Tick Read-Only (Immutable) on the connector and test again. |
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 ao valor do SQLite 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 SQLite 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 SQLite
Não é bem a sua configuração?
- Você tem uma pasta com vários arquivos SQLite em vez de um único arquivo? O SQLite Folder mescla tabelas com o mesmo nome em uma única tabela e marca cada linha com o arquivo de origem → SQLite Folder
Setup trouble?
- Agent says the file or folder does not exist, or access is denied? Mapped drives, network shares, OneDrive and Linux home folders each need one fix → Where the Agent can read files from
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

