用途:该技能用于在 Microsoft Fabric 中通过 sqlcmd 和 az rest 消费(只读查询)SQL 数据库及其 SQL 分析终结点,面向数据探索、分析与排查。
主要能力:支持架构发现(schema、表、列、约束、索引、可编程对象)、跨数据库联接、向量与 AI-RAG 模式、JSON 处理(FOR JSON PATH、OPENJSON)、时态查询(FOR SYSTEM_TIME AS OF)、数据虚拟化(OPENROWSET / 外部表访问 OneLake)、以及安全策略检查。可连接两类终结点:SQL 数据库终结点(OLTP,含向量搜索、存储过程)与 SQL 分析终结点(复制数据、跨库查询、BI)。
使用方式:先用 COMMON-CLI.md 完成工作区与项目发现、认证与连接配置。典型命令:sqlcmd <连接/认证参数> -Q "SELECT TOP 10 * FROM dbo.Orders",或 sqlcmd ... -i my_query.sql 运行查询文件。必须带 -d <DatabaseName>,必须使用 -G 或 --authentication-method(Fabric 不支持 SQL 认证),脚本用 -W,必要时加 SET NOCOUNT ON;。首次会话需运行 check-updates 技能或比对 package.json 版本。
限制:这是只读技能,禁止 INSERT / UPDATE / DELETE / MERGE / TRUNCATE 及任何 DDL,写请求应转给 sqldb-authoring-cli。SQL 分析终结点为只读,不支持 DML,且不传播 RLS/DDM/OLS、向量与 JSON 列、计算列、视图、过程与函数;最多镜像 1000 张表,LOB 超 1 MB 截断,datetime2(7) 在第 7 位精度丢失。跨库三部分命名仅在分析终结点可用。不支持 ODBC sqlcmd、MARS、CREATE LOGIN、EXECUTE AS,全文检索 CONTAINS/FREETEXT 仅预览。部分安装、认证与安装细节需见 COMMON-CLI.md,资料中未完整展开。