SuperAPI AI 工具集

query-design

数据与分析

查看项目

更新于 10-16 06:47

技能介绍

用途:该技能处理数据与展示的分离。核心原则是 DAX 负责计算和获取数据,TypeScript 负责为展示塑形,VegaVisual 与 DataGrid 负责渲染。

主要能力与职责划分:语义度量(SUM、DISTINCTCOUNT 等)、筛选器与切片器、分组粒度(SUMMARIZECOLUMNS)、时间智能(YTD、YoY)、TopN 与载荷削减、确定性排序(ORDER BY,用于调试而非展示排序)由 DAX 承担;合并多个结果集、可从明细行推导的总计(SUM、COUNT、MIN、MAX)、填充维度缺口、重塑(透视/反透视)、面向用户的排序由 TypeScript 承担;列显示名由工厂文件的 columnMetadata 管理,数字/日期格式化由 columnMetadata.format 或 Vega-Lite spec 管理,装饰性标签与图标由 DataGrid cellRenderer 或 Vega-Lite condition 负责,轴标题、图例、颜色编码由 Vega-Lite spec 负责。

必要规则:必须在 DAX 中聚合到可视化的粒度,不得拉取更细粒度行再在 TypeScript 汇总;每个 .dax 文件一个粒度(一个 EVALUATE),不同粒度需分文件并分别调用 useSemanticModelQuery;ORDER BY 用于稳定可 diff 的结果而非展示排序;相关分粒度查询需使用相同筛选器与度量;能从已取回明细行安全汇总的总计用 TypeScript,否则(DISTINCTCOUNT、比率、AVERAGEX、复杂度量)另发独立 DAX 汇总查询。

建议与避免:优先用 SUMMARIZECOLUMNS 做分组聚合;用 DAX 原生列名并通过 columnMetadata.displayName 映射;返回原始类型值,格式化交给 columnMetadata.format 或 Vega-Lite,避免使用 FORMAT();避免仅为重命名而用 SELECTCOLUMNS,避免用 UNION 混合不同粒度,避免在 DAX 中把 BLANK 转成 0、"" 或 "N/A",避免 CONCATENATEX、UNICHAR、emoji 前缀等装饰性文本。

适用场景:为可视化构建 DAX 查询、处理多粒度数据(如柱状图加总计参考线)、决定用户筛选器是客户端过滤还是推入 DAX 重新查询、选择格式字符串、以及格式化如何流入 Vega-Lite 轴。与 schema-discovery、dax-authoring、visuals 等技能配合使用。

限制:资料未提供具体安装命令、收费、价格或平台支持信息,暂未提供。