跳转到主要内容

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
MySQL 没有调用 AI 模型的方法。您在 SQL 中处理数据,然后把数据移到应用程序代码中完成 AI 步骤,再把结果带回来。VillageSQL 的 vsql_ai 扩展添加了 ai_prompt()——一个直接从查询中调用 AI 模型的函数,这样数据丰富、分类和生成都可以在数据所在的地方完成。

问题:在 SQL 和 AI 之间切换上下文

不使用 VillageSQL 时的典型模式:
这样可行,但每行需要三次往返:SELECT、AI 调用、UPDATE。对于大表,协调开销会不断累积,而且丰富数据的逻辑位于应用程序代码中,而不是数据所在的模式中。

使用 VillageSQL:SQL 中的 ai_prompt()

ai_prompt(provider, model, api_key, prompt) 发起一次 API 调用,并以字符串形式返回响应。凡是标量函数可用的地方都可以使用它。

批量更新行

最常见的用法:在现有行上回填一个丰富数据列。
在应用程序中循环运行这条 UPDATE,直到不再有 NULL 行为止。

在 WHERE 中使用提示结果

您可以按 AI 输出进行过滤,不过这会对扫描中的每一行都调用模型:
出于性能考虑,优先更新一个存储列并查询该列,而不是在 WHERE 子句中调用 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。

故障排除

另请参阅