Ver categorias

Sincronizar DuckDB com Smartsheet de acordo com um agendamento

Automação · DuckDB para Smartsheet

Manter Smartsheet 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 planilha do Smartsheet. 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 esse serviço.

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 planilha do Smartsheet que armazena as linhas retornadas pela sua consulta ao DuckDB e é atualizada periodicamente, a cada cinco minutos ou semanalmente, com um recibo das alterações a cada execução. Assim:

O DuckDB armazena seus dados em um arquivo. Sua equipe trabalha no Smartsheet. A solução usual é usar o Zapier ou o Make, ou um arquivo CSV que alguém carrega e que, inesperadamente, copia uma linha por vez. O Query Streams Automation faz isso de forma diferente: o agente que já lê seu arquivo DuckDB executa o SQL salvo em um cronograma e grava todo o resultado no Smartsheet de uma só vez, combinando as linhas por uma chave para que a planilha permaneça correta em vez de crescer.

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 navegador ou o aplicativo SmartsheetSmartsheetsua planilha, atualizada no local
O Agente fica vinculado aos seus dados e executa a consulta quando agendado. O Smartsheet 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

O agente deve estar instalado no computador que contém o seu arquivo DuckDB, ou em um computador que o lê de um compartilhamento de rede, com a conexão adicionada em Agentes de Dados. Ainda não terminou? 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 Smartsheet

O Smartsheet pede que você permita que o Query Streams leia e grave planilhas. Um token de acesso à API também funciona.

Onde o trabalho é realizado? No computador que executa o Agente. Ele executa a consulta conforme o agendamento e grava as linhas no Smartsheet, portanto, esse computador precisa permanecer ligado. Seu navegador pode ser fechado. O Query Streams em si nunca armazena as linhas.

O arquivo está em outro computador? O agente não precisa ser executado no computador que contém o seu arquivo DuckDB: ele pode ler o arquivo de um compartilhamento de rede. Acessando um arquivo em um compartilhamento de redeA imagem abaixo mostra o que isso exige.

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 no Smartsheet. 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 Smartsheet". 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 escolha o Smartsheet.

    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 Smartsheet 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. Conecte o Smartsheet

    Sobre Etapa 2 clique Conecte-se com o SmartsheetFaça login e permita o acesso. O Smartsheet solicita que você permita que o Query Streams leia e grave planilhas. Um token de acesso à API também funciona. Já se conectou alguma vez? A página oferece opções. Use esta conexão em vez de.

  4. Escolha onde as linhas vão ficar.

    Sobre Etapa 3 escolha o Folha As linhas devem aparecer. Crie a planilha no Smartsheet primeiro, se desejar uma planilha vazia; o assistente lista apenas as planilhas existentes. Uma automação por planilha.

  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 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 · 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 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 planilha. Essa é a opção ideal para estoque, pipelines, dados mestres e dashboards.

    Especificidades do Smartsheet. A coluna principal da planilha é renomeada para a sua coluna chave, e uma coluna mapeada do tipo Data, Caixa de seleção, Lista suspensa ou Contato é alterada para Texto/Número para que os valores da sua consulta sejam compatíveis. As colunas que sua consulta não reconhece permanecem como estão.

    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
    Sobrescrito a partir do DuckDB a cada execução. Se alguém editar uma coluna de sincronização no Smartsheet, 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 Smartsheet 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 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 Smartsheet, 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 Smartsheet: 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 Smartsheet 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 o agendamento em andamento e são exibidos na linha.

Coluna chave ausente

Se alguém renomear ou excluir a coluna principal no Smartsheet, a Sincronização Completa será interrompida antes de gravar qualquer coisa e exibirá uma 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 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.

Acessando um arquivo em um compartilhamento de rede

O Agente abre arquivos como um serviço em segundo plano, não como você, portanto, um arquivo em outro computador requer uma etapa adicional. Qual etapa depende do computador em que o Agente está sendo executado.

Janelas

Digite o caminho da rede, como por exemplo: \\servidor\compartilhamento\pasta, nunca uma letra de unidade mapeada como S:, que o Agente não pode ver. Se o compartilhamento permitir apenas pessoas nomeadas, clique Identidade de serviço (o chip sob o caminho) e armazenar um login para esse servidor: uma conta de domínio da empresa ou uma conta criada no próprio servidor com Domínio deixado em branco. O Agente então se conecta a esse servidor e lê o arquivo lá, e cada conector nesse Agente que lê o mesmo servidor deve usar o mesmo login. Sem um login, ele lê como sua própria conta de serviço, que um domínio corporativo vê como o próprio computador. Passo a passo no Windows

Linux

Os logins de compartilhamento armazenados no Portal não são usados no Linux: primeiro, um administrador monta o compartilhamento no computador do Agente, em uma pasta em /mnt ou /mídia, porque o serviço do Agente não consegue ver /lar ou /executar/usuárioNo conector, mantenha o \\servidor\compartilhamento caminho, que o Agente mapeia para a montagem, ou digite o caminho da montagem, como por exemplo /mnt/fileserver-shared/Contas. Como montar um compartilhamento no Linux

Mac

Os logins de compartilhamento armazenados no Portal não são usados em um Mac: monte o compartilhamento primeiro a partir do Terminal com sudo, em uma pasta sob /Volumes, para que o serviço em segundo plano do Agente possa vê-lo. No conector, mantenha o \\servidor\compartilhamento caminho, que o Agente mapeia para a montagem, ou digite o caminho da montagem, como por exemplo /Volumes/servidor-de-arquivos-compartilhado/Contas. Como montar uma pasta compartilhada no Mac

Se o teste não conseguir acessar a pasta compartilhada, procure por estas palavras no resultado: inalcançável Significa que o computador do agente não recebeu resposta do servidor. No Linux ou no Mac, não montado Significa que o compartilhamento ainda precisa ser montado, e essa mensagem inclui o comando de montagem exato para o seu servidor.

Arquivo DuckDB em um compartilhamento? O DuckDB permite apenas um programa escrevendo por vez, portanto o Agente não pode abrir um arquivo que outro programa já tenha aberto para escrita; em um \\servidor\compartilhamento o caminho que o teste indica está aberto para escrita por outro programaFeche a conexão ali ou aponte o conector para um arquivo que ninguém esteja gravando. Cada consulta lê o arquivo pela rede, portanto, um arquivo grande responde mais lentamente do que responderia a partir de um disco local.

O teste falhou em uma ação compartilhada?

Cada execução acessa o arquivo da mesma forma que o teste de conexão. Se as execuções começarem a falhar após alguma alteração no servidor de arquivos, como uma nova senha, por exemplo, abra o conector em Agentes de dados e clique em Teste de conexãoO resultado do teste e a linha abaixo do caminho do arquivo indicam o problema:

MensagemCausaConsertar
Arquivo de banco de dados DuckDB não encontrado: seguido por um \\servidor\compartilhamento O caminho que você sabe ser o certoComo nenhum login é armazenado, o Agente tentou acessar o compartilhamento com sua própria conta e não conseguiu visualizar o arquivo: o compartilhamento rejeitou a conta ou o servidor não respondeu. No primeiro caso, a linha abaixo do caminho diz Acesso negado à conta de serviço do agente..Clique em Identidade de serviço No caminho especificado, armazene um login que possa ler o compartilhamento. Se a linha no caminho não indicar "acesso negado", verifique se o computador do Agente consegue abrir o compartilhamento.
Compartilhamento \\servidor: acesso negado — adicione credenciais para este servidorUm login foi armazenado, mas essa conta não tem permissão para acessar o compartilhamento, ou outro login no mesmo servidor está bloqueando o acesso; a mensagem anterior a esta linha indica qual dos dois casos ocorre.Peça ao administrador do servidor para conceder acesso de leitura a essa conta ou armazene uma conta que já possua esse acesso. Para um login que atrapalhe o processo, veja as duas linhas abaixo referentes a um login por servidor.
Compartilhamento \\servidor: as credenciais foram recusadas — verifique o nome de usuário e a senha.O servidor rejeitou o login salvo: erro de digitação, domínio incorreto ou senha alterada desde que foi salva, o que também interrompe execuções que funcionavam anteriormente.Clique no ícone abaixo do caminho e digite a senha novamente; para uma conta criada no próprio servidor, deixe Domínio Em branco. Após uma tentativa de login recusada, o Agente aguarda um minuto antes de tentar novamente, para que a conta não seja bloqueada; ao salvar uma senha correta, a tentativa é feita imediatamente.
Compartilhamento \\servidor: servidor inacessível a partir da máquina do agenteO computador do agente não recebeu resposta do servidor: nome do servidor incorreto, servidor desligado ou firewall bloqueando o compartilhamento de arquivos.No computador do agente, abra o mesmo. \\servidor\compartilhamento O caminho no Explorador de Arquivos. Se isso também falhar, é um problema de rede de quem administra a rede.
Outro conector neste agente já se conecta ao servidor como…O Windows permite que um computador faça login em um servidor com uma conta por vez, e outro conector neste Agente usa um login diferente para esse servidor.Armazene o mesmo login que o outro conector usa ou altere-o em cada conector que lê esse servidor.
O Windows já possui um login estabelecido para \\servidor para …Algum dispositivo no computador do Agente, além do próprio Agente, já está conectado a esse servidor com uma conta diferente, e o Agente nunca fecha uma sessão que não tenha sido iniciada por ele.Siga as instruções do restante da mensagem: use a mesma conta neste conector ou feche o outro login no computador do agente. Se a mensagem indicar que o compartilhamento já está legível por meio desse login, escolha a opção correta. Use a identidade do serviço na caixa de login.
Esta versão do agente não consegue iniciar sessão em \\servidor com as credenciais armazenadas.O agente é uma versão antiga que não pode usar logins armazenados.Atualize o agente e teste novamente.
\\server\share não está montado neste agente Linux. (ou Agente macOS)O agente é executado em Linux ou Mac e o compartilhamento ainda não foi montado em seu computador; os logins armazenados no Portal não são usados lá.Monte-o com o comando fornecido na mensagem e teste novamente. Passo a passo: no Linux · em um Mac.
… está aberto para escrita por outro programaO DuckDB permite apenas uma pessoa escrevendo por vez, enquanto outro programa mantém o arquivo aberto para escrita.Feche o arquivo nesse programa ou aponte o conector para um arquivo no qual ninguém esteja escrevendo.

Perguntas que as pessoas fazem

A sincronização irá sobrescrever as notas que minha equipe adiciona no Smartsheet?

Não, se as anotações estiverem em uma coluna própria. Colunas que existem apenas no Smartsheet 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 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 Smartsheet 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 Smartsheet. 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 planilha?

Não, apenas uma automação por planilha. Direcione uma segunda automação para uma planilha 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éreaBaserowSeaTableAnvil.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

Problemas com a configuração?

  • O agente diz que o arquivo ou pasta não existe ou que o acesso foi negado? Unidades mapeadas, compartilhamentos de rede, OneDrive e pastas pessoais do Linux precisam de uma correção → De onde o Agente pode ler arquivos
  • O agente está offline ou as opções Testar conexão e Navegar estão desativadas? Verifique se o agente está online → O agente está online?
Atualizado em novembro 9, 2026

Desenvolvido por BetterDocs