SuperAPI AI 工具集

carto-query-datawarehouse

数据与分析

查看项目

更新于 10-15 17:31

技能介绍

用途:对 CARTO 已注册的任意连接执行 SQL(空间或普通),并提供方言差异、性能默认值与执行模型方面的指引。

主要能力与执行方式:分为两种执行面(MCP 与 CLI 一致)。返回行的 SELECT 走同步路径,存在 1 分钟超时;DDL/DML 及长时间查询走异步路径,无超时且不返回行。MCP 侧提供 execute_query 与 execute_async_query(提交/查状态/取消),在令牌认证会话下也可用;CLI 侧对应 carto sql query 与 carto sql job,适用于未挂载服务器或脚本/CI 场景。

必要用法示例: carto sql query <connection> "SELECT * FROM dataset.table LIMIT 10" carto sql job <connection> "CREATE TABLE my_ds.out AS SELECT ..." carto sql query <connection> --file query.sql echo "SELECT 1" | carto sql query <connection> --cache 仅用于确定性小查询(一年缓存)。carto activity query 基于本地 DuckDB 查询活动数据,仅 CLI。

适用场景:计数/探索性 SELECT、构建转换、调试慢或失败的 SQL、制图前物化中间表、临时空间连接、缓冲区或 H3 聚合。

限制与常备规则:必须指定连接名,且连接名来自连接清单而非仓库项目 ID;可能超过 60 秒的查询优先走异步;不要盲目 SELECT *(空间表可达上亿行,需投影列并加 LIMIT);跨方言函数命名不同,需按方言参考取规范写法。其余内容按资料未提供。