Manter Anvil.works Em sintonia com sua conta Stripe, 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 de dados do Anvil.works. Combine linhas por uma chave para que as edições sejam aplicadas corretamente e as linhas que não foram incluídas na consulta 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.
O resultado final será o que você obterá.
Uma tabela de dados do Anvil.works que armazena as linhas retornadas pela sua consulta ao Stripe e é atualizada periodicamente, a cada cinco minutos ou semanalmente, com um recibo das alterações a cada execução. Assim:
O Stripe armazena seus dados por trás de sua API. Sua equipe trabalha no Anvil.works. A solução usual é uma importação manual em seu aplicativo que falha silenciosamente e copia uma linha por vez. O Query Streams Automation faz isso de forma diferente: o agente que já está associado à sua conta do Stripe executa seu SQL salvo em um agendamento e grava todo o resultado no Anvil.works de uma só vez, combinando linhas por uma chave para que a tabela de dados 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.
A conexão Stripe foi feita através do Agente.
O agente está instalado em qualquer computador que esteja sempre ligado, com sua conta Stripe adicionada como uma conexão em Agentes de Dados. Ainda não terminou? Conecte o Stripe primeiroLeva 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 no Anvil.works
Insira o endereço HTTPS do seu aplicativo Anvil e a chave do conector que você definiu no aplicativo com `connector.init_connector("key")` do módulo `querystreams`. O `Query Streams` verifica as respostas do aplicativo e lista suas tabelas de dados.
Onde o trabalho é realizado? No computador que executa o Agente. Ele executa a consulta conforme o agendamento e grava as linhas no Anvil.works, portanto, esse computador precisa permanecer ligado. Seu navegador pode ser fechado. O próprio Query Streams nunca armazena as linhas.
Configure em seis etapas
-
Salve a consulta que deseja manter sincronizada.
Aberto Construtor de consultas, escolha sua conexão Stripe (ainda não está conectado? Comece aqui), e escreva a instrução SELECT que retorne exatamente as linhas e colunas desejadas no Anvil.works. Esta, por exemplo, extrai algumas colunas de um stripe.faturas mesa:
Exemplo · SQLSELECT number, status, amount_due / 100.0 AS amount_due, currency FROM stripe.invoices ORDER BY created DESC LIMIT 100;
Execute-o e então Salvar Dê a ela um nome que você reconheça, como "Pedidos para Anvil.works". Mantenha uma coluna que seja única por linha na consulta SELECT, aqui. númeroEssa é 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 o módulo Automação e selecione Anvil.works.
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 Anvil.works 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-se ao Anvil.works
Sobre Etapa 2 A página orienta você pelo lado do Anvil: adicione o código de dependência do Query Streams ao seu aplicativo em Configurações → Dependências → Terceiros, crie um módulo de servidor com
from querystreams import connectoreconnector.init_connector("sua chave")e clique Gerar chave segura para criar essa chave. Em seguida, insira o seu URL do aplicativo Anvil e o mesmo Chave de autenticação do conector e clique em Conexão de testeSeu aplicativo precisa de Tabelas Aceleradas Ativado (Configurações → Tabelas de Dados); a página verifica isso novamente para você. -
Escolha onde as linhas vão ficar.
Sobre Etapa 3 escolha o Tabela de dados As linhas devem ser inseridas. Crie-a primeiro no seu aplicativo Anvil, caso queira 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.
-
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 tabela de dados. Nada é atualizado nem excluído, sendo assim, é 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 local e as linhas que não são mais retornadas pela consulta são removidas, incluindo linhas digitadas manualmente na tabela de dados. Portanto, mantenha as linhas digitadas manualmente em outra tabela de dados. 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 de dados 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 pelo Stripe a cada execução. Se alguém editar uma coluna de sincronização no Anvil.works, 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 Stripe 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 Anvil.works nunca são afetadas por uma sincronização.
Qual é mais rápido? A opção "Anexar" grava os dados sem lê-los primeiro. Já a opção "Sincronização Completa" lê a tabela, compara cada linha e grava apenas as diferenças, o que leva mais tempo, mas garante que a tabela de dados sempre corresponda à consulta. Você pode alternar entre as opções posteriormente no painel de edição da automação.
Para uma tabela de dados em que você possa confiar, clique Criar todas as colunas como SíncronasEm seguida, clique no ícone da chave. número 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 Anvil.works, 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 arquivo Anvil.works: as linhas estão lá, abaixo dos cabeçalhos das colunas.
É isso. A partir de agora, a tabela de dados 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 Anvil.works 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.
As chaves devem ser únicas.
Antes de cada sincronização completa, o Query Streams verifica se os valores-chave no resultado da sua consulta são únicos e rejeita a execução caso contrário, garantindo que nenhum dado parcialmente gravado seja inserido na sua tabela. Mantenha a coluna-chave intacta no Anvil; colunas que sua consulta desconhece nunca são excluídas durante a 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 tabela de dados 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 Anvil.works?
Não, se as notas estiverem em uma coluna própria. Colunas que existem apenas no Anvil.works 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 Stripe 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 Stripe são armazenados pelo Query Streams?
Não. O Agente executa a consulta no seu lado e envia as linhas diretamente para o Anvil.works 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 no Anvil.works. 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 de dados?
Não, apenas uma automação por tabela de dados. Direcione uma segunda automação para uma tabela de dados 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 Stripe
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

