Ver categorias

Sincronizar DuckDB com Baserow de acordo com um agendamento

Automação · DuckDB para Baserow

Manter Baserow Em consonância com o seu arquivo DuckDB, 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 na sua tabela Baserow. Combine linhas por uma chave para que as edições sejam aplicadas 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 isso.

Cerca de 15 minutos Não é necessário programar O arquivo permanece onde está. A cada 5 minutos até semanalmente
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 tabela Baserow que armazena as linhas retornadas pela sua consulta DuckDB e é atualizada periodicamente, a cada cinco minutos ou semanalmente, com um registro das alterações a cada execução. Algo assim:

DuckDB holds your data in a file. Your team works in Baserow. The usual bridge is a Zapier or Make scenario, or a CSV someone uploads that breaks quietly and copies one row at a time. Query Streams Automation does it differently: the Agent that already reads your DuckDB file runs your saved SQL on a schedule and writes the whole result into Baserow in one pass, matching rows by a key so the table stays correct rather than growing.

ONDE O ARQUIVO ESTÁ GUARDADOcomputador do escritório, um servidor ou o de casa.Seu arquivo DuckDBsales.duckdb · permanece aquiAgente de fluxos de consultaexecuta a consulta salvade acordo com sua agendaFluxos de consultalink criptografadoApenas linhas · escritas, não lidas por nósONDE SUA EQUIPE TRABALHAqualquer navegadorBaserowsua tabela, atualizada no local
O Agente reside com seus dados e executa a consulta quando o agendamento for definido. O Baserow apenas recebe as linhas. Ninguém precisa clicar em nada.

O que você vai precisar

Uma conta do Query Streams

O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.

DuckDB conectado através do Agente

The Agent installed on the computer that holds your DuckDB file, or on one that reads it from a network share, with the connection added in Data Agents. Not done yet? Conecte-se primeiro ao DuckDBLeva 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 Baserow

Insira o endereço do servidor Baserow (o padrão é api.baserow.io), seu e-mail e sua senha. O Query Streams os armazena criptografados e faz o login para você quando uma sincronização é executada.

Onde o trabalho é realizado? No computador que executa o Agente. Ele executa a consulta conforme o agendamento e grava as linhas no Baserow, 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 DuckDB 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

  1. Salve a consulta que deseja manter sincronizada.

    Aberto Construtor de consultas, escolha sua conexão com o DuckDB (ainda não está conectado? Comece aqui), e escreva a instrução SELECT que retorne exatamente as linhas e colunas desejadas em Baserow. Esta, por exemplo, extrai algumas colunas de um pedidos mesa:

    Exemplo · SQL
    SELECT order_id, customer_name, order_total FROM main.orders ORDER BY order_total DESC LIMIT 100;

    Execute-o e então Salvar Dê a ela um nome que você reconheça, como "Pedidos para Baserow". Mantenha uma coluna que seja única por linha na consulta SELECT, aqui. ID do pedidoEssa é 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.

  2. Abra a Automação e selecione Linha Base.

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

  3. Conectar Baserow

    Sobre Etapa 2 Preencha URL do servidor (Deixe em branco para a nuvem Baserow), seu E-mail e Senha, depois clique Conexão de testeInsira o endereço do servidor Baserow (o padrão é api.baserow.io), seu e-mail e sua senha. O Query Streams os armazena criptografados e faz o login para você quando uma sincronização é executada.

  4. Escolha onde as linhas vão ficar.

    Sobre Etapa 3 escolha o Banco de dados, então o Mesa As linhas devem ser inseridas. Crie a tabela no Baserow primeiro, se desejar uma tabela vazia. Se ela já contiver linhas, uma pré-visualização as exibirá e explicará o que cada modo de sincronização fará com elas. Uma automação por tabela.

  5. 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ápido

    Anexar

    A cada execução, as linhas da consulta são adicionadas ao final da tabela. Nada é atualizado nem excluído, sendo assim, é a opção ideal para armazenar logs, eventos e histórico que você deseja acumular. Não requer 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 · espelhos

    Sincronizaçã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 local e as linhas que não são mais retornadas pela consulta são removidas, incluindo linhas digitadas manualmente na tabela. Portanto, mantenha as linhas digitadas manualmente em outra tabela. 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 tabela 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
    Sobrescrito a partir do DuckDB a cada execução. Se alguém editar uma coluna de sincronização no Baserow, 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 DuckDB 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 Baserow nunca são afetadas por uma sincronização.

    Qual é mais rápido? A opção "Anexar" grava sem ler a tabela primeiro. A opção "Sincronização Completa" lê a tabela, compara cada linha e grava apenas as diferenças, por isso leva mais tempo, mas a tabela sempre corresponde à consulta. Você pode alternar entre as opções posteriormente no painel Editar da automação.

    Para uma tabela em que você possa confiar, clique aqui. Criar todas as colunas como SíncronasEm seguida, clique no ícone da chave. ID do pedido 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.

  6. 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üênciaCorridas
    A cada 5 minutosa cada 5 minutos, o mais rápido permitido
    A cada 15 minutosa cada 15 minutos
    A cada 30 minutosa cada 30 minutos
    A cada horano início de cada hora
    Diariamente às 9htodos 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 personalizadoseus 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 Baserow, 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 a Baserow: as linhas estão lá, abaixo dos cabeçalhos das colunas.

É isso. A partir de agora, a tabela 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 Baserow parar de aceitar a conexão ou o conector de dados for excluído, a automação pausa e informa o motivo. Reconecte ou selecione uma nova fonte e clique em "Retomar". Outros erros mantêm a programação em andamento e são exibidos na linha.

Coluna chave ausente

Se alguém renomear ou excluir a coluna chave em Baserow, a Sincronização Completa será interrompida antes de gravar qualquer coisa e exibirá a seguinte mensagem: Opções de correçãoRestaure a coluna com o nome exato e execute novamente. Suas outras colunas nunca são excluídas pela 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:

PlanoLinhas por execução
Gratuito125
Núcleo Pessoal500
Personal Plus1,000
Núcleo de negócios2,500
Negócios Plus5,000
Business Max10,000
Núcleo Empresarial25,000
Enterprise Plus100,000
Empresa Max250,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 tabela 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.

Janelas

Type the network path, like \\servidor\compartilhamento\pasta, never a mapped drive letter such as S:, which the Agent cannot see. If the share only lets in named people, click Service identity (the chip under the path) and store a login for that server: a company domain account, or an account made on the server itself with Domain left blank. The Agent then signs in to that server and reads the file there, and every connector on that Agent that reads the same server must use the same login. Without a login, it reads as its own service account, which a company domain sees as the computer itself. Step by step on Windows

Linux

Share logins stored in the Portal are not used on Linux: an administrator mounts the share on the Agent’s computer first, in a folder under /mnt ou /mídia, because the Agent’s service cannot see /home ou /run/user. In the connector, keep the \\servidor\compartilhamento path, which the Agent maps onto the mount, or type the mount path instead, such as /mnt/fileserver-shared/Accounts. How to mount a share on Linux

Mac

Share logins stored in the Portal are not used on a Mac: mount the share first from Terminal with sudo, in a folder under /Volumes, so the Agent’s background service can see it. In the connector, keep the \\servidor\compartilhamento path, which the Agent maps onto the mount, or type the mount path instead, such as /Volumes/fileserver-shared/Accounts. How to mount a share on a Mac

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.

DuckDB file on a share? DuckDB allows one writer at a time, so the Agent cannot open a file that another program has open for writing; on a \\servidor\compartilhamento path the test says it is open for writing by another program. Close it there, or point the connector at a file nobody is writing to. Every query reads the file across the network, so a large file answers more slowly than it would from a local disk.

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:

MensagemCausaConsertar
DuckDB database file not found: followed by a \\servidor\compartilhamento path you know is rightNo 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 serverA 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 passwordThe 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 machineThe 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 open for writing by another programDuckDB allows one writer at a time, and another program has the file open for writing.Close the file in that program, or point the connector at a file nobody is writing to.

Perguntas que as pessoas fazem

A sincronização irá sobrescrever as anotações que minha equipe adiciona no Baserow?

Não, se as notas estiverem em sua própria coluna. Colunas que existem apenas na linha base e não na sua consulta nunca são alteradas; portanto, adicione uma coluna "Notas" ou "Proprietário" ao lado das colunas sincronizadas e digite o conteúdo lá. Colunas marcadas Sincronização são restaurados ao valor do DuckDB 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 DuckDB são armazenados pelo Query Streams?

Não. O Agente executa a consulta no seu lado e envia as linhas diretamente para o Baserow 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?

Quem executa o Agente é quem realiza a execução, pois é o Agente que executa a consulta e grava os dados no Baserow. 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 gravem na mesma tabela?

Não, apenas uma automação por tabela. Direcione uma segunda automação para uma tabela diferente ou amplie a consulta subjacente à 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.

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.
A mesma consulta salva também pode ser mantida em sincronia comPlanilhas GoogleMesa aéreaSmartsheetSeaTableAnvil.workse 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

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?
Atualizado em outubro 12, 2026

Desenvolvido por BetterDocs