指标契约
名称、计算方式、数据粒度、时间规则、来源映射和允许使用的维度由共享模型管理。
Composable AnalyticsComposable Analytics。
Composable Analytics。
视图随问题变化，指标定义保持一致。
为眼前的问题快速生成分析视图，同时保持指标口径一致。在 Datus Studio 中连接数据，将经审核的业务上下文引入项目，再让 Agent 创建、修改并发布报告或大盘。配置 DOSI 后，还可以使用可执行的语义定义。
Northstar · Premier 分析界面示意
共享指标
customer_margin经审核的定义 · DOSI生成的 HTML 视图
Premier 客户概览客户贡献利润$13,821.893 位 Premier 客户
核心思路
一套业务定义，适配多种分析视图。
Composable Analytics 将指标的业务含义与展示它的页面分开。同一套经审核的定义可以用于固定大盘、探索式 HTML 视图或报告。Agent 可按问题调整布局、筛选项和图表，指标口径仍可追溯和审核。
经审核的指标
01实时大盘
02专题分析
03HTML 报告
分析视图
卡片、图表、表格、筛选项和视觉重点可以随着分析过程变化。
看看实际效果
提出需求，再逐步调整视图。
切换两个 Northstar Premier 分析界面示意。呈现方式发生变化，已记录的客户贡献利润数据保持一致。
始终使用同一定义: customer_margin · 经审核的 DOSI 指标
向 Datus Agent 提出需求
“按客户展示 Premier 客户贡献利润，并显示总利润与已交付订单数。”
客户贡献利润$13,821.893 位客户 · 21 笔已交付订单
| 客户 | 贡献利润 | 已交付订单 | 退货率 |
|---|---|---|---|
| Maya Chen | $7,325.24 | 8 | 12.5% |
| Daniel Brooks | $3,308.16 | 7 | 0% |
| Sofia Rivera | $3,188.49 | 6 | 16.7% |
Datus 的工作方式
从一个问题，生成团队可使用的分析视图。
在 Datus Studio 项目中，Agent 可以从现有指标、提供的 SQL 或两者结合开始，生成报告或大盘。你可以通过追问修改其中的模块，审核后再发布。
现有指标或 SQLDatus Agent已发布的视图
确定数据契约
如果已有适用的指标及维度，优先复用。也可以从临时 SQL 开始，但新的计算方式需要单独审核。
生成页面
让 Datus Agent 生成指标卡、筛选项、图表和表格，并为已配置的数据源保存 HTML 大盘与查询模板。
审核、修改、发布
核对指标定义或 SQL、筛选含义、时间范围、标签和结果。按需修改单个模块，再按相应权限发布审核后的产物。
选择合适的产物
不同受众，需要不同形式的分析结果。
生成的页面可以是临时工作视图，也可以成为长期维护的产物。分享前，要确认它如何获取数据，以及由谁审核。
为当前问题生成视图
创建聚焦问题的 HTML 大盘，按新的维度追查，并随着调查继续调整页面。了解AI/BI 分析方案。
为重复检查保留实时视图
发布带筛选项并连接数据源的大盘。有权限的读者更改筛选条件时，Studio Viewer 会通过 Datus 后端重新查询。发布前应检查数据访问权限和行级策略。了解Agent 生成大盘的实践。
用固定结果制作报告
将经审核的 HTML 报告发布为稳定、只读的 Viewer 页面，供汇报或后续追问。打开报告快照不会重新执行查询。了解共享语义定义如何服务于报告。
与现有技术栈配合
从团队正在使用的工具出发选型。
Composable Analytics 不只是选择一种大盘形式。先看你的数仓、团队已经信任的 BI 页面，以及能长期维护的语义定义方式。
数据源
分别核对数据源及语义执行路径；不同连接器和功能的支持范围并不相同。
现有 BI
保留已有大盘，再评估共享定义如何传递到各工具。以下只是现有 BI 的例子，不代表直接集成承诺。
正在评估的语义方案
比较指标定义存放在哪里、哪些工具可以使用，以及修改如何审核。
选型前需要回答的问题
指标定义存在哪里？
团队能否一次审核计算方法、粒度、关联关系和来源映射，再将定义复用于不同视图？
哪些现有工具可以继续使用？
逐项验证数仓连接方式、BI 接入路径，以及哪些已有大盘应该保留。
读者调整筛选项时会发生什么？
分清实时大盘和固定报告，并测试查询路径、访问权限与行级策略。
视图如何修改或迁移？
核查 Agent 能否只修改某个模块，同时保持指标定义一致，并检查生成的 SQL 或来源依据。
从 Datus Studio 开始
从连接数据到发布分析视图。
在 Studio 工作区中连接数据源。若已有经审核的指标，可将其引入项目，再让 Agent 创建报告或大盘。检查生成的内容后，发布给需要使用的人。
- 01 / 连接
将受支持的数据源关联到项目。
- 02 / 定义
从 Semantic Hub 引入已验证或已认证的指标；临时视图则需审核所用 SQL。
- 03 / 生成
让报告或大盘 Agent 生成页面，再按问题修改。
- 04 / 发布
打开已发布的 Viewer，测试筛选效果，再按权限分享。
Datus StudioStudio 工作流示意
Datus StudioNorthstar / Premier 分析
经审核的指标customer_margin
Premier 客户大盘待审核
customer_margin$13,821.89
Viewer · 权限控制发布大盘
常见问题
关于 Composable Analytics 的常见问题
什么是 Composable Analytics？
Composable Analytics 使用可复用的数据访问、指标定义、查询契约和展示组件构建分析视图。大盘或报告可以改变布局，同时避免在每个页面重复编写业务计算。
生成 HTML 大盘一定要先有 DOSI 指标吗？
不需要。Datus Agent 可以从现有指标、提供的 SQL 或两者结合开始。若已配置适用且经审核的语义指标，应优先复用；临时 SQL 图表仍需要核查计算方式和数据来源。
可以只修改一个图表或筛选项吗？
可以。文档中的大盘 Agent 支持单独修改筛选项、指标卡、图表和表格等模块。每次修改后仍应核对查询和页面布局。
生成的大盘可以发布并分享吗？
在 Datus Studio 中，审核后的大盘可以发布到 Viewer。实时筛选通过配置好的 Datus 后端为有权限的读者执行查询；分享还受发布访问权限和数据策略约束。本地生成的 HTML 文件并不自带在线运行环境。
可以继续使用哪些数仓和 BI 工具？
从团队已经使用的数据源和 BI 页面出发。Datus Agent 适配器、DOSI 执行连接器、语义模型导出和 BI 接入各有不同的支持范围。制定迁移计划前，应核对具体集成路径并测试权限。
如何比较 Datus 与 Cube、MetricFlow 或数仓原生语义视图？
比较模型格式、支持的数据源、指标审核流程、查询依据、BI 接入方式，以及大盘由谁运行和分享。Datus 将 Agent 生成视图与可复用上下文结合；配置后，DOSI 执行兼容的 Apache Ossie 模型。请根据自己的技术栈验证各项能力。
这会替代现有的 BI 工具吗？
两者可以并行。固定大盘适合周期性监控；当问题不断变化时，可以生成针对当前问题的视图。也可以在确认指标定义、权限和运行方式后，逐步迁移选定的报告。