VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
vsql_http do VillageSQL permite que você traga esses dados diretamente de uma consulta ou os armazene em uma coluna com um único UPDATE.
Configuração
Padrão 1: Armazene o Enriquecimento em uma Coluna
O uso mais comum: preencher uma coluna com dados buscados de uma API externa. Execute um UPDATE que chama a API por linha, armazene o resultado e depois consulte a coluna armazenada. Este exemplo busca o status de envio de cada pedido:shipping_status IS NULL. Processe em lotes para ficar dentro dos limites de taxa da API.
Depois do preenchimento, as consultas usam a coluna armazenada — nenhuma chamada de API por consulta:
Padrão 2: Consulta ao Vivo em uma Query
Para dados que mudam rápido demais para serem guardados em cache — taxas de câmbio, preços em tempo real — você pode chamar a API inline no SELECT. Cada linha do resultado dispara uma requisição, então mantenha o conjunto de resultados pequeno.http_get() dentro da expressão do SELECT, a menos que cada linha realmente precise de uma chamada de API diferente.
Padrão 3: Enriquecimento Condicional
Busque somente para as linhas que realmente precisam, usando WHERE para filtrar antes de chamar a API:url_encode() envolvendo o endereço — sempre codifique dados do usuário antes de embuti-los em uma URL.
Tratando Erros da API
Todas as funções davsql_http retornam NULL em falha de conexão, com um aviso carregando a mensagem de erro do curl. Verifique o código de status antes de usar o conteúdo:
Considerações de Desempenho
Cada chamada HTTP é síncrona e bloqueia a consulta. Um lote de 50 linhas, cada uma chamando uma API de 200ms, leva no mínimo 10 segundos.max_execution_time só limita instruções SELECT — não tem efeito aqui. Para limitar quanto tempo este UPDATE pode rodar, obtenha o ID da conexão com SELECT CONNECTION_ID() antes e execute KILL QUERY <id> de outra sessão se ele demorar demais:
Solução de Problemas
Próximos Passos
- Fazendo requisições HTTP a partir do SQL — referência completa das funções e análise de respostas
- Enviando webhooks a partir de triggers — enviar mudanças para fora em vez de trazer dados para dentro
Veja também
- Fazendo Requisições HTTP a partir do SQL — as funções HTTP usadas para as chamadas de API
- JSON no MySQL — analisando as respostas JSON retornadas pelas APIs
- Servindo Tabelas como uma API REST — publicando as suas próprias tabelas por HTTP