用途:在 PBIR 报表中创建与维护 Deneb 视觉对象,使用 Vega/Vega-Lite 规范实现原生视觉对象无法覆盖的图表与交互。
主要能力:首选 Vega-Lite,除非需要信号、事件流、自定义投影、force/voronoi 布局等 Vega 专属功能;支持 SVG(默认)与 canvas 渲染;单数据集角色(所有字段进入一个 Values 区);默认行上限 10,000;捆绑运行时 Vega 6.2.0 / Vega-Lite 6.4.1(自 Deneb 1.8,使用 v6.json schema)。visualType 为 deneb7E15AEF80B9E4D4F8E12924291ECE89A。
使用方式:一切报表改动使用 pbir,仅用 PBIR 元数据做诊断,绝不直接编辑 report.json。新增视觉对象示例:pbir add visual deneb7E15AEF80B9E4D4F8E12924291ECE89A “Report.Report/Page.Page” --name RevenueByCategoryDeneb;绑定字段:pbir visuals bind … --add “dataset:Sales.Category” --type Column;注入规范:pbir visuals deneb … --spec-file chart.vl.json --provider vegaLite;校验:pbir validate “Report.Report” --all。新建视觉对象需检查 publicCustomVisuals 并通过 pbir set --json 更新完整列表,保留已有 id。规范中字段名须与绑定的 nativeQueryRef 一致。
限制与注意:AppSource 认证禁止加载外部 URL 数据;转义规则随上下文变化(独立规范用双引号,PBIR visual.json 内用双写单引号);1.9 起移除了 identity 与 key,改用 row;性能上应先在 DAX 聚合,其次考虑 canvas,最后才提高 dataLimit.override。何时选用 Deneb:需要交叉筛选、提示、悬停等交互及自定义图表类型时。简单内联图形可用 SVG 度量,统计类可视化可用 Python/R。