跳转到主要内容

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

All examples on this page work on VillageSQL. Install Now →
有些数据不在您的数据库里——汇率、物流状态、地理定位查询、第三方产品详情。标准做法是在应用代码中获取它,然后要么缓存到一张表里,要么在应用层把它与查询结果拼接起来。VillageSQL 的 vsql_http 扩展让您可以直接在查询中拉取这些数据,或者用一条 UPDATE 把它存入某一列。

设置

模式 1:把丰富后的数据存入列

最常见的用法:用从外部 API 获取的数据回填一列。运行一条逐行调用 API 的 UPDATE,存储结果,然后查询存储的列。 这个示例为每个订单获取物流状态:
在您的应用中循环运行这条语句,直到不再有 shipping_status IS NULL 的行。分批处理,以免超出 API 的速率限制。 回填之后,查询读取的是存储的列——每次查询不再调用 API:

模式 2:在查询中实时查找

对于变化太快而无法缓存的数据——汇率、实时定价——您可以在 SELECT 中内联调用 API。结果中的每一行都会触发一次请求,所以请保持结果集较小。
把共享的值一次性获取到变量中,然后在查询里使用该变量——除非每一行确实需要不同的 API 调用,否则不要在 SELECT 表达式中调用 http_get()。

模式 3:有条件的丰富

用 WHERE 在调用 API 之前先过滤,只为真正需要的行获取数据:
注意包裹着地址的 url_encode()——在把用户数据嵌入 URL 之前,务必先编码。

处理 API 错误

所有 vsql_http 函数在连接失败时返回 NULL,并附带一条携带 curl 错误消息的警告。在使用内容之前先检查状态码:
对于批量 UPDATE 循环,得到 NULL 或非 200 响应的行,其列值保持为 NULL,因此您可以重新运行 UPDATE 来重试失败的行。

性能考量

每次 HTTP 调用都是同步的,并会阻塞查询。 一批 50 行、每行访问一个 200ms 的 API,至少需要 10 秒。max_execution_time 只限制 SELECT 语句——在这里不起作用。要限制这条 UPDATE 的运行时长,请事先用 SELECT CONNECTION_ID() 获取它的连接 ID,如果运行时间过长,就从另一个会话运行 KILL QUERY <id>:
优先存储结果而不是实时查询——一旦值进入了列,后续查询就不会再触及网络。

故障排除

后续步骤

另请参阅