用途:@microsoft/fabric-app-data 让 Web 应用在运行时查询 Fabric 语义模型。SDK 提供 FabricClient,负责查询、结果解析、缓存与错误处理;传输与认证交给 IFabricApiProxy 实现,因此不绑定运行环境(浏览器、Node.js、Fabric 扩展均可)。
主要能力:用命名连接配置多个语义模型,每个连接需提供 workspaceId 与 itemId(workspaceId 可为 GUID 或 "me" 表示 My Workspace)。查询方法为 client.semanticModel(alias).query(dax),每条查询必须恰好包含一个 EVALUATE 语句。结果不抛异常,需检查 result.status;成功时返回单表,含 columns(name、dataType)与行优先的 rows。默认启用内存 LRU 缓存(64 条),可用 bypassCache 跳过,或用 clearCache 清除;成功结果与查询错误会缓存,API 与网络错误不缓存。错误分类包括 query、overflow、api、network、unknown。DAX 类型映射为 JS 值,DateTime 返回无时区后缀的 ISO 8601 字符串,整数超出安全范围时报 overflow。
使用方式:从 "@microsoft/fabric-app-data" 导入 FabricClient,传入 proxy 与 semanticModels 配置;类型也从该入口导入。
限制:不要直接构造 SemanticModelClient,不要硬编码端点 URL,不要从内部路径导入;连接 ID 的管理方式由项目自行决定。资料未提供安装命令、收费与平台支持细节。