VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
vsql_ai do VillageSQL adiciona ai_prompt() — uma função que chama um modelo de IA diretamente de uma consulta, para que enriquecimento, classificação e geração aconteçam onde os dados já estão.
O Problema: Troca de Contexto Entre SQL e IA
Um padrão típico sem o VillageSQL:Com o VillageSQL: ai_prompt() em SQL
ai_prompt(provider, model, api_key, prompt) faz uma chamada à API e retorna a resposta como uma string. Use-a em qualquer lugar onde uma função escalar funcione.
Atualizando linhas em massa
O uso mais comum: preencher uma coluna de enriquecimento nas linhas existentes.Usando resultados de prompt em WHERE
Você pode filtrar pela saída da IA, embora isso chame o modelo para cada linha da varredura:ai_prompt() em uma cláusula WHERE.
Construindo prompts a partir de várias colunas
Concatene colunas no prompt para dar ao modelo o contexto completo:Desempenho e Limites de Taxa
Cada chamada aai_prompt() é uma requisição HTTPS independente. Para operações em massa:
- Use LIMIT no UPDATE — as chamadas de IA levam de 5 a 30 segundos cada, então um
UPDATEem lote sobre 100 linhas leva minutos; processe em lotes de 50 a 100 linhas para ficar dentro dos limites de taxa do provedor.max_execution_timesó limitaSELECTe não faz nada aqui — para interromper umUPDATEem execução, useKILL QUERY <connection_id>a partir de outra sessão. - Armazene os resultados — Nunca chame
ai_prompt()em um SELECT sem armazenar o resultado. SELECTs repetidos executam a chamada à API novamente a cada vez.
Escolhendo um Modelo
Para tarefas de classificação e rotulagem, use o modelo mais rápido e barato que dê uma precisão aceitável. Reserve os modelos mais capazes para tarefas em que a qualidade da saída importa mais do que a vazão.
Para configuração e opções de provedor, consulte Conectando o MySQL a APIs de IA.
Perguntas Frequentes
Posso usar ai_prompt() em uma expressão DEFAULT?
Não — funções não determinísticas (eai_prompt() é uma delas) não podem ser usadas em expressões DEFAULT nem em colunas geradas no MySQL.
Posso usar ai_prompt() em uma stored procedure?
Sim. Stored procedures, triggers e funções podem todos chamarai_prompt(), sujeitos às mesmas restrições de timeout. Tenha cuidado com triggers — uma chamada de IA a cada INSERT deixará cada escrita lenta.
Como controlo o formato da resposta?
Pelo prompt. “Reply with one word: positive, negative, or neutral” produz uma saída previsível para classificação. “Return valid JSON with keys: category, confidence” produz uma saída estruturada. O modelo segue instruções de forma confiável quando elas são específicas.ai_prompt() tenta novamente em caso de falha?
Não. Se a chamada à API falhar, ela retorna NULL. ExecuteSHOW WARNINGS para ver o motivo — a vsql_ai gera um Warning 3200 com o motivo real da falha — antes de implementar uma lógica de repetição no loop de lote da sua aplicação.
Solução de Problemas
Veja também
- Conectando o MySQL a APIs de IA — instalando e configurando a extensão vsql_ai primeiro
- Resumo com IA no MySQL — resumindo textos longos com ai_prompt()
- Classificando Texto no MySQL com IA — rotulando linhas por categoria usando ai_prompt()
- Análise de Sentimento em Dados do MySQL — pontuando texto por tom e sentimento