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 →
O MySQL não tem uma forma de chamar um modelo de IA. Você processa seus dados em SQL, depois os move para o código da aplicação para qualquer etapa de IA, e então traz os resultados de volta. A extensão 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:
Isso funciona, mas são três idas e voltas por linha: SELECT, chamada de IA, UPDATE. Para tabelas grandes, a sobrecarga de coordenação se acumula, e a lógica de enriquecimento fica no código da aplicação em vez de no esquema onde os dados estão.

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.
Execute o UPDATE em um loop a partir da sua aplicação até que não restem mais linhas com NULL.

Usando resultados de prompt em WHERE

Você pode filtrar pela saída da IA, embora isso chame o modelo para cada linha da varredura:
Para desempenho, prefira atualizar uma coluna armazenada e consultá-la em vez de chamar 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 a ai_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 UPDATE em 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_time só limita SELECT e não faz nada aqui — para interromper um UPDATE em execução, use KILL 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 (e ai_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 chamar ai_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. Execute SHOW 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