用途：在 Domo 应用中进行数据集查询时，应优先使用 @domoinc/query 的 Query API。它能自动适配嵌入仪表盘的页面级筛选，只按所需聚合层级获取数据，聚合与筛选在 Domo 服务端完成，从而减少数据传输与客户端处理，适合大数据集场景。该库提供链式 API，构造出的 URL 可与 domo.get() 及 /data/v1/ 端点配合使用。
安装：npm/yarn 方式执行 yarn add @domoinc/query；也可通过 CDN 引入 https://cdn.jsdelivr.net/npm/@domoinc/query@3.0.0/dist/main.min.js，加载后 Query 全局可用。基本用法为 new Query().select([...]).fetch('数据集名')。
主要能力：select 选择列；where 支持比较（greaterThan、lessThan、between 等）、字符串（contains）与列表（in、notIn）筛选，多个条件为 AND；groupBy 可按多列分组并指定聚合函数 count、sum、avg、min、max、unique；orderBy、limit、offset 用于排序与分页；日期方面支持 dateGrain（day、week、month、quarter、year）、periodToDate（YTD/MTD/QTD）、previousPeriod（同比上期）与 rollingPeriod（滚动窗口）；另有 useFiscalCalendar、useBeastModes 等选项。
限制与注意：聚合对象的键必须使用数据集真实字段名，不能用自定义别名，否则会出现 [object Object] 错误；如需重命名应在 fetch 后处理。文档明确提示 .aggregate() 实际不可用，会报 DA0057 错误，应改用 groupBy 加分组列，或 select 后在客户端聚合。