SuperAPI AI 工具集

sqldw-cli

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:面向 Microsoft Fabric 中 Warehouse、Lakehouse SQL 分析终结点与镜像数据库,统一处理 T-SQL 编写与摄取、只读查询以及仓库性能诊断,并按请求意图分派到三种模式。

主要能力与模式:authoring 用于变更仓库状态,如表 DDL、DML、摄取、事务、过程、模式演进、时间旅行;典型触发包括 COPY INTO、OPENROWSET、INSERT/UPDATE/DELETE、MERGE、CTAS、sp_rename 等。consumption 用于读取数据或元数据,如 SELECT、行数统计、过滤、聚合、模式与对象发现、CSV 导出。operations 通过 queryinsights 和受支持的诊断定位性能、失败、容量消耗、SQL 池使用或健康问题,包含慢查询摘要、失败分析、池压力、资源消耗、Lakehouse 健康、Capacity Metrics CU 关联及自定义 SQL 池推荐等子参考。

使用方式:必须先选定唯一模式,并作为首个工具调用完整读取 references/<mode>.md,不能仅凭分派说明行动。通过列目录并用 JMESPath 过滤来解析 workspace 与 item id,不得猜测 GUID。所有 T-SQL 经 fabric-sqlendpoint-execute_query(workspaceId, itemId, query) MCP 工具执行;itemId 为 GUID,Warehouse 或镜像数据库用 item id,Lakehouse 用 properties.sqlEndpointProperties.id。每次调用一个 T-SQL 批次,无 GO 与 sqlcmd 元命令,仅返回最后一个结果集。结果上限 10000 行、超时 300 秒、每分钟 20 次请求;正好 10000 行表示被截断。所有 api.fabric.microsoft.com 调用须携带 x-ms-fabric-skill: sqldw-cli 头,包括 LRO 轮询与重试;az rest 用于控制面发现,并需传 --resource。

限制:authoring 之外为只读;operations 只允许对 Lakehouse SQL 分析终结点执行 sys.sp_get_table_health_metrics,不得执行 ALTER/CREATE/DROP。诊断数字必须现场执行并以来源视图或过程标注,不得复用或编造。若工具不可用,仅可走模式参考中记录的 Legacy CLI Fallback;Capacity Metrics 关联流程若 SQL Endpoint MCP 不可用则报告该阶段阻塞。首次回复应说明所选模式。