用途:这是 Domo App Platform 数据访问的高层入口技能,遵循工具包/查询优先原则,用于在应用中读取数据集,并把细粒度的查询工作交给 dataset-query。
主要能力与用法:读取数据集时推荐使用 @domoinc/query。安装命令为 yarn add @domoinc/query,随后通过 new Query().select([...]).groupBy(...).orderBy(...).fetch('alias') 的方式查询,示例包含按 region 分组并对 Sales_Amount 求和、降序排序。SQL 仅作为例外手段:使用 @domoinc/toolkit 的 SqlClient 时需注意它不会自动遵循仪表盘中的页面筛选器。
必要配置与本地开发:每个数据集都必须在 manifest.json 的 datasetsMapping 中声明,包含 alias、dataSetId 与 fields;fields 必须存在(可为 []),否则会导致 manifest 解析错误。本地 API 路由使用 @domoinc/ryuu-proxy,并通过 domo login 完成鉴权。
限制与检查项:默认不使用原始 /data/v1;聚合须使用实际数据集字段名;不使用 .aggregate()。其余细节暂未提供。