SuperAPI AI 工具集

domo-dataset-query

数据与分析

查看项目

更新于 10-16 06:43

技能介绍

用途:在 Domo 应用中使用 @domoinc/query 的 Query API 查询数据集,替代整表拉取。它构建的 URL 可与 domo.get() 及 /data/v1/ 端点配合,聚合与筛选在 Domo 服务端完成,减少传输与客户端处理,并自动遵循仪表板页面级筛选。

安装:yarn add @domoinc/query;或 CDN 引入 https://cdn.jsdelivr.net/npm/@domoinc/query@3.0.0/dist/main.min.js,加载后全局可用 Query。

主要能力:链式 API。select 选择列;where 支持比较(lessThan/greaterThan/equals/between 等)、字符串(contains/notContains)、列表(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 加客户端聚合。

适用场景:Domo 仪表板内嵌应用、销售看板、同比与趋势分析等需要按需聚合查询的场景。