Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Manter sistemas externos sincronizados com o seu banco de dados geralmente significa polling — o serviço externo consulta periodicamente a sua API em busca de mudanças, ou o código da sua aplicação publica eventos após cada gravação. Com a extensão vsql_http do VillageSQL, os triggers podem enviar requisições HTTP diretamente, para que os sistemas externos sejam notificados no momento em que uma linha muda, sem necessidade de publicação de eventos na camada de aplicação.

Configuração

Trigger de Webhook Básico

Um trigger AFTER INSERT que faz POST de um payload para um endpoint de webhook:
O resultado é atribuído a @ignored — o trigger não usa a resposta, mas a atribuição suprime o warning de “resultado não utilizado”. NULL significa que a conexão falhou; o trigger é concluído de qualquer forma e o INSERT é efetuado.

Controlando Timeouts

Por padrão, vsql_http usa um timeout de 30 segundos. Um endpoint de webhook lento ou indisponível bloqueia a gravação por todo esse tempo. Use http_request() com um JSON de opções para definir um prazo mais curto:
Um timeout de 3 segundos limita por quanto tempo um atraso do webhook pode segurar uma gravação. A requisição é concluída ou desiste — o INSERT não é revertido.

Triggers de UPDATE e DELETE

O mesmo padrão funciona para atualizações e exclusões. Use OLD para incluir os valores anteriores:
A guarda IF NEW.status != OLD.status evita disparar o webhook em instruções UPDATE que não mudam o status — mantendo o volume de webhooks proporcional às mudanças significativas.

Autenticação

Passe chaves de API ou tokens bearer no argumento headers_json de http_request():
Armazene os segredos em uma tabela de configuração e recupere-os em uma variável no momento do trigger, em vez de fixá-los no corpo do trigger.

Ressalvas Importantes

Triggers são síncronos. A chamada HTTP bloqueia até ser concluída ou atingir o timeout. Um endpoint de webhook lento ou fora do ar vai segurar cada gravação nessa tabela. Sempre defina um timeout curto (2–5 segundos) e projete o endpoint para responder imediatamente (enfileire o trabalho, não o processe inline). As falhas são silenciosas por padrão. Se a chamada HTTP retorna NULL (falha de conexão), o trigger não gera um erro e a gravação é bem-sucedida — um warning carrega a mensagem de erro do curl, mas nada no trigger o inspeciona. Uma resposta não-2xx também retorna silenciosamente — http_post() retorna JSON independentemente do código de status, e o trigger não o inspeciona. Se a entrega confiável importa, use o padrão de outbox transacional em vez disso: grave os eventos em uma tabela outbox na mesma transação e depois entregue-os com um processo separado. Triggers disparam uma vez por linha. FOR EACH ROW significa que um UPDATE orders SET status = 'shipped' em massa atinge 1000 linhas e envia 1000 chamadas de webhook. Isso pode sobrecarregar o endpoint e esgotar os limites de conexão. Para operações em massa, suprima o trigger ou use o padrão de outbox. Sem lógica de retentativa. Uma requisição que falhou permanece com falha. Construa o tratamento de retentativa e de dead-letter no sistema receptor ou no processo de outbox, não no trigger.

Solução de Problemas

Próximos Passos

Veja também