用途:该技能专门管理 Fabric SQL 数据库项(OLTP、SQL Server 引擎),涵盖 T-SQL 架构编写、只读查询与 OLTP 性能诊断。它按模式分派,本身不含具体操作步骤。
主要能力与模式:分为三类。authoring 模式处理架构与数据变更,包括表、约束、索引、向量列、存储过程、dacpac 部署及 INSERT/UPDATE/DELETE/MERGE,仅在请求要求新建数据库时创建 SQL 数据库项。consumption 模式通过 sqlcmd 执行只读 T-SQL,包括 SELECT、目录探查、向量相似度搜索与时态查询。operations 模式诊断 OLTP 性能,涉及 Query Store、阻塞会话、计划回归与等待统计。
使用方式:操作前须先选择匹配的模式,然后用文件读取工具完整读取对应的 references/<mode>.md,再执行命令。工作区与项 ID 必须通过列表加 JMESPath 过滤解析,不得猜测 GUID。每次调用 api.fabric.microsoft.com 都必须携带请求头 x-ms-fabric-skill: sqldb-cli(az rest 中为 --headers "x-ms-fabric-skill=sqldb-cli"),包括所有 LRO 轮询、fabric_lro 与重试。authoring 的终态写入必须通过 sqlcmd -Q/-i 实际执行 DDL 或 DML;仅展示语句不改变任何数据。consumption 严格只读。operations 的读取本身不写入,唯一例外是间歇性阻塞调查可创建 Extended Events 会话,最终须删除。
适用场景:Fabric SQL 数据库的架构变更、只读查询、性能诊断;不适用于 Warehouse、Lakehouse SQL 端点或镜像数据库(应使用 sqldw-cli),也不适用于 notebook 单元格(应使用 spark-cli)。
限制:不得从 consumption 或 operations 模式变更架构或数据;模式边界须显式声明切换;模式不明确时应提出一个简短澄清问题而非猜测。其他定价、平台支持等细节资料暂未提供。