VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
vsql_http 扩展让您可以直接在查询中拉取这些数据,或者用一条 UPDATE 把它存入某一列。
设置
模式 1:把丰富后的数据存入列
最常见的用法:用从外部 API 获取的数据回填一列。运行一条逐行调用 API 的 UPDATE,存储结果,然后查询存储的列。 这个示例为每个订单获取物流状态:shipping_status IS NULL 的行。分批处理,以免超出 API 的速率限制。
回填之后,查询读取的是存储的列——每次查询不再调用 API:
模式 2:在查询中实时查找
对于变化太快而无法缓存的数据——汇率、实时定价——您可以在 SELECT 中内联调用 API。结果中的每一行都会触发一次请求,所以请保持结果集较小。http_get()。
模式 3:有条件的丰富
用 WHERE 在调用 API 之前先过滤,只为真正需要的行获取数据:url_encode()——在把用户数据嵌入 URL 之前,务必先编码。
处理 API 错误
所有vsql_http 函数在连接失败时返回 NULL,并附带一条携带 curl 错误消息的警告。在使用内容之前先检查状态码:
性能考量
每次 HTTP 调用都是同步的,并会阻塞查询。 一批 50 行、每行访问一个 200ms 的 API,至少需要 10 秒。max_execution_time 只限制 SELECT 语句——在这里不起作用。要限制这条 UPDATE 的运行时长,请事先用 SELECT CONNECTION_ID() 获取它的连接 ID,如果运行时间过长,就从另一个会话运行 KILL QUERY <id>:
故障排除
后续步骤
- 从 SQL 发起 HTTP 请求——完整的函数参考和响应解析
- 从触发器发送 webhook——向外推送变更,而不是向内拉取数据
另请参阅
- 从 SQL 发起 HTTP 请求——用于 API 调用的 HTTP 函数
- MySQL 中的 JSON——解析 API 返回的 JSON 响应
- 把表作为 REST API 提供服务——通过 HTTP 发布您自己的表