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 →
Alguns dados não vivem no seu banco de dados — taxas de câmbio, status de envio, consultas de geolocalização, detalhes de produtos de terceiros. A abordagem padrão é buscá-los no código da aplicação e, então, guardá-los em cache em uma tabela ou costurá-los com os resultados da consulta na camada da aplicação. A extensão 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:
Execute isso em um loop a partir da sua aplicação até não restarem linhas com 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.
Busque o valor compartilhado uma vez em uma variável e depois use a variável na consulta — não chame 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:
Observe 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 da vsql_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:
Em loops de UPDATE em massa, as linhas que recebem uma resposta NULL ou diferente de 200 mantêm o valor da coluna em NULL, então você pode executar o UPDATE de novo para tentar novamente as linhas que falharam.

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:
Prefira armazenar os resultados a consultar ao vivo — depois que um valor está em uma coluna, as consultas seguintes não tocam a rede.

Solução de Problemas

Próximos Passos

Veja também