SuperAPI AI 工具集

fabric-sdk

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:@microsoft/fabric-app-data 让 Web 应用在运行时查询 Fabric 语义模型,构建基于浏览器的数据分析应用。SDK 提供 FabricClient,负责查询、结果解析、缓存和错误处理;传输与认证委托给 IFabricApiProxy 实现,因此不绑定运行环境,可用于浏览器、Node.js 或 Fabric 扩展。

主要能力:通过命名连接配置多个语义模型,每个连接需提供 workspaceId 和 itemId(workspaceId 可为 GUID 或 "me" 表示 My Workspace)。使用 client.semanticModel(alias).query(dax) 执行 DAX 查询,每条查询必须恰好包含一个 EVALUATE 语句。查询不会抛出异常,需检查 result.status;成功时返回单个表,含 columns(name、dataType)和 rows(行优先数组)。结果默认内存缓存(LRU,64 条),成功结果和查询错误会被缓存,API 与网络错误不缓存;可用 bypassCache 跳过缓存,用 clearCache 清除。错误分为 query、overflow、api、network、unknown 五类。数据类型转换为标准 JS 值,DateTime 返回不带时区的 ISO 8601 字符串,整数超出安全范围会返回 overflow 错误。

使用方式:从 "@microsoft/fabric-app-data" 导入 FabricClient,传入 proxy 和 semanticModels 配置即可。类型定义也从该包入口导出。

限制:不要捕获 query() 的异常(它不会抛出);不要硬编码端点 URL;不要直接构造 SemanticModelClient;不要从内部路径导入。资料未提供安装命令、收费或平台支持等更多信息。