VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
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 triggerAFTER INSERT que faz POST de um payload para um endpoint de webhook:
@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:
Triggers de UPDATE e DELETE
O mesmo padrão funciona para atualizações e exclusões. UseOLD para incluir os valores anteriores:
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 argumentoheaders_json de http_request():
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
- Fazendo requisições HTTP a partir do SQL — referência completa das funções, incluindo a análise de respostas
- Enriquecendo linhas com dados de API — traga dados externos para as suas tabelas
- Triggers no MySQL — padrões gerais de triggers e a semântica de BEFORE vs AFTER
Veja também
- Fazendo Requisições HTTP a partir do SQL — as funções do vsql_http usadas em triggers de webhook
- Triggers do MySQL — a mecânica de triggers que dispara os webhooks
- Assinaturas HMAC no MySQL — assinando payloads de webhook para verificação pelo destinatário