用途:fabric-app-data CLI 管理 Fabric 数据源连接,把工作区/项目 ID 写入 fabric.yaml,支持 dev、staging、production 等多 profile,并生成 TypeScript 配置供 @microsoft/fabric-app-data 在运行时消费。
主要能力:init 创建 fabric.yaml;add 通过 Fabric 门户 URL 或显式 ID 添加连接;search 按显示名查找语义模型;remove 删除连接;list 列出连接;use 切换活动 profile 并自动重新生成配置;generate 生成 fabric.generated.ts;query(别名 execute、exec)对语义模型执行 DAX 查询。
使用方式: npx fabric-app-data init npx fabric-app-data add sales --from-url "https://app.fabric.microsoft.com/..." npx fabric-app-data generate -o src/fabric.generated.ts 应用侧: import { FabricClient } from "@microsoft/fabric-app-data"; import { fabricConfig } from "./fabric.generated.js"; const client = new FabricClient({ proxy, ...fabricConfig }); 除 init 外,命令会从当前目录向上查找 fabric.yaml;init 始终写入当前目录,应在项目根目录运行。add 支持 -w/-i 短标志,URL 解析支持 semanticmodels、modeling、lakehouses、warehouses,My Workspace 用 me 作为 workspaceId。search 支持 --json、-w、--max-results(默认 10,上限 50)、--type。query 支持 -q/--query、-f/--file、-l/--limit(默认 1000,上限 1000)、-p/--profile。
限制:Catalog Search 为模糊分词匹配,任何查询都会返回排序结果,非空不代表匹配,需人工核对 displayName;有结果退出码 0,无结果 1。query 结果默认截断至 1000 行,截断时 JSON 含 _cliWarning,完整数据仅在运行中的应用可用。fabric.generated.ts 应加入 .gitignore。其余细节暂未提供。