用途:在 Microsoft Fabric 中对数据仓库(Warehouse)、Lakehouse SQL 端点、镜像数据库执行 T-SQL 查询,主要用于只读数据消费与探索。查询执行统一走 MCP 工具 fabric-sqlendpoint-execute_query(签名:workspaceId, itemId, query),不使用 sqlcmd;az CLI 仅用于身份认证(az login)与 Fabric REST 工作区/项目发现,jq 解析 JSON。
主要能力:支持 Warehouse 读写(DML),Lakehouse SQL 端点和镜像数据库只读;可查询 INFORMATION_SCHEMA、sys 目录视图进行模式与对象发现、行数统计、安全与统计信息探索;支持视图、TVF、标量 UDF、存储过程等读侧对象;支持跨库查询(同工作区三段命名);可施加 RLS、CLS、DDM 等安全机制;提供查询标签、DMV 与 queryinsights.* 监控诊断。
使用方式:先用 az rest 列出工作区与项目获取 workspaceId、itemId(Lakehouse 需取 properties.sqlEndpointProperties.id,而非 Lakehouse 项目 id),再调用 MCP 工具。每次 api.fabric.microsoft.com 调用须带 x-ms-fabric-skill: sqldw-consumption-cli 标头(含 LRO 轮询与重试);每会话首次使用需先执行 check-updates。多语句须无 GO 分隔符,只返回最后一个结果集。
限制:单次最多返回 10,000 行,超过会被截断,建议配合 TOP/WHERE/聚合;查询超时 300 秒;限速 20 次/分钟/身份,超限返回 HTTP 429,需退避重试,上述为观察到的默认值,服务可能变更。不支持 GO 分隔符、sqlcmd 元命令与 MARS。Lakehouse 与镜像数据库不支持 DML。使用前需确认 fabric-sqlendpoint-execute_query 工具可用,否则需注册 MCP 服务器(全局地址 https://api.fabric.microsoft.com/v1/mcp/dataPlane/sqlEndpoint)。原文未提供具体收费与定价信息。