VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
vsql_ai 扩展添加了 ai_prompt()——一个直接从查询中调用 AI 模型的函数,这样数据丰富、分类和生成都可以在数据所在的地方完成。
问题:在 SQL 和 AI 之间切换上下文
不使用 VillageSQL 时的典型模式:使用 VillageSQL:SQL 中的 ai_prompt()
ai_prompt(provider, model, api_key, prompt) 发起一次 API 调用,并以字符串形式返回响应。凡是标量函数可用的地方都可以使用它。
批量更新行
最常见的用法:在现有行上回填一个丰富数据列。在 WHERE 中使用提示结果
您可以按 AI 输出进行过滤,不过这会对扫描中的每一行都调用模型:ai_prompt()。
用多个列构建提示
将多个列拼接到提示中,为模型提供完整的上下文:性能和速率限制
每次ai_prompt() 调用都是一个独立的 HTTPS 请求。对于批量操作:
- 在 UPDATE 中使用 LIMIT——每次 AI 调用需要 5–30 秒,因此一条覆盖 100 行的批量
UPDATE需要数分钟;请按每批 50–100 行处理,以保持在提供商的速率限制之内。max_execution_time只限制SELECT,在这里不起作用——要限制正在运行的UPDATE,请从另一个会话使用KILL QUERY <connection_id>。 - 存储结果——切勿在 SELECT 中调用
ai_prompt()而不存储结果。重复的 SELECT 每次都会重新发起 API 调用。
选择模型
对于分类和打标任务,请使用能给出可接受准确度的最快/最便宜的模型。将能力更强的模型留给输出质量比吞吐量更重要的任务。
有关安装设置和提供商配置,请参阅 将 MySQL 连接到 AI API。
常见问题
我可以在 DEFAULT 表达式中使用 ai_prompt() 吗?
不可以——在 MySQL 中,非确定性函数(ai_prompt() 就是其中之一)不能用于 DEFAULT 表达式或生成列。
我可以在存储过程中使用 ai_prompt() 吗?
可以。存储过程、触发器和函数都可以调用ai_prompt(),并受同样的超时约束。使用触发器时请谨慎——在每次 INSERT 上调用 AI 会让每次写入都变慢。
如何控制响应格式?
通过提示来控制。“Reply with one word: positive, negative, or neutral” 可以为分类任务获得可预测的输出。“Return valid JSON with keys: category, confidence” 可以获得结构化输出。只要指令具体明确,模型就能可靠地遵循。ai_prompt() 在失败时会重试吗?
不会。如果 API 调用失败,它返回 NULL。在应用程序的批处理循环中实现重试逻辑之前,请运行SHOW WARNINGS 查看原因——vsql_ai 会抛出带有真实失败原因的 Warning 3200。
故障排除
另请参阅
- 将 MySQL 连接到 AI API——先安装并配置 vsql_ai 扩展
- MySQL 中的 AI 摘要——使用 ai_prompt() 总结长文本
- 使用 AI 在 MySQL 中分类文本——使用 ai_prompt() 按类别为行打标
- 对 MySQL 数据进行情感分析——为文本的语气和情感打分