用途:在 Microsoft Fabric 中编写并执行 T-SQL,覆盖表 DDL、DML、数据摄取、事务与架构变更。查询执行统一走 fabric-sqlendpoint-execute_query MCP 工具(签名 workspaceId、itemId、query),不再使用 sqlcmd。
主要能力:Warehouse 支持表 DDL、DML、COPY INTO/OPENROWSET 摄取、事务、时间旅行与快照;视图、函数、存储过程与 CREATE SCHEMA 在 Warehouse 和 Lakehouse/Mirrored DB 的 SQL 端点均可创建。Lakehouse 需传 SQL 分析端点 id 而非 Lakehouse 项 id。
硬性约束:CREATE TABLE 不支持 DEFAULT;主键须用 ALTER TABLE ... ADD CONSTRAINT ... PRIMARY KEY NONCLUSTERED (...) NOT ENFORCED,且主键列须先声明 NOT NULL;DATETIME2 必须写作 DATETIME2(6);不支持 NCHAR、NVARCHAR、TEXT、IMAGE、MONEY、SMALLMONEY、DATETIME;不支持 WITH DISTRIBUTION;约束须 NOT ENFORCED。MERGE 与 ALTER COLUMN 不被语法阻断,但生产变更建议改用 DELETE+INSERT 或 CTAS + sp_rename。
用法要点:每次 api.fabric.microsoft.com 调用(含所有 LRO 轮询、fabric_lro 与重试)都必须带标头 x-ms-fabric-skill: sqldw-authoring-cli(az rest 用 --headers "x-ms-fabric-skill=sqldw-authoring-cli")。每会话首次使用前须运行 check-updates 技能;Copilot CLI 与 VS Code 调用该技能,Claude Code、Cowork、Cursor、Windsurf、Codex 对比本地与远程 package.json 版本,同一会话已检查则跳过。先验证 MCP 工具是否可用,否则需注册 Fabric SQL Endpoint MCP 服务器(全局地址 https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint,项级地址 https://api.fabric.microsoft.com/v1/mcp/dataPlane/workspaces/{workspaceId}/items/{itemId}/sqlEndpoint)。写入前先做架构发现(查 INFORMATION_SCHEMA)。
限制:单次调用为单一批次,不支持 GO 分隔符或 sqlcmd 元命令,仅返回最后一个结果集,任一语句报错则整批失败,建议拆分独立调用;最多返回 10000 行;查询超时 300 秒;每身份限速 20 请求/分钟,超限返回 HTTP 429。上述数值为观测默认值,非正式契约,可能变化。作者权限最低需 Contributor,执行 GRANT 需 Admin。其他收费、价格与更多平台细节暂未提供。