数据指标管理方案（2026）

点击「表注册」，字段说明：

• 表名称：下拉单选。由产研提供标准 CH 实例，业务将自定义指标写入标准 CH 表中后，从下拉中选择对应表名（无需手工输入，避免拼写错误）。
• 表中文名：自定义，名称唯一。
• 适用业务：下拉多选，取轻舟业务列表。
• 表描述：需详细说明表用途。
• 负责人：默认展示创建人（不可删除），仅可在此基础上追加。
• 字段说明（自动读取）：选择表名称后，系统自动读取该表在数据库侧的字段名、字段类型、字段注释，并把字段注释自动带入「字段中文名 / 字段描述」；字段序号按表字段真实顺序递增展示，自动带入后内容仍可二次编辑修改；若数据源表无注释或读取失败，对应字段中文名/描述保持为空，退化为手工填写，不阻断表注册流程；后续表字段发生变化，可点击「刷新」实时重新读取。

• 点击表名或「查看」，基本信息、字段说明同表注册逻辑（只读）；结果表新增「来源」字段（表注册 / sql计算 / 表关联计算，见 3.6）。
• 关联指标：展示当前表在指标字典中被引用的指标列表，含指标名、指标编码、指标状态、指标层级、指标维度、创建人——业务在查看一张表时能立刻知道"这张表已经产出了哪些指标"，避免重复建设。

3.4.1 输入 SQL

• 提供 code 风格 SQL 编辑器（等宽字体，可多行），提供「解析 SQL」按钮触发字段解析。

3.4.2 字段说明（解析规则）

点击「解析 SQL」后，系统按顶层逗号拆分 SELECT 子句（括号内的逗号不拆；忽略 *）逐列解析，生成「字段说明」表格：序号 / 字段名 / 字段类型 / 字段属性 / 字段中文名 / 字段描述。解析结果均可在表格中手工编辑修正。各列解析规则如下：

3.5.1 选择主表

• 主表下拉来源为数据字典中的全部表；选项同时展示中文名 + 英文名；选定后展示主表信息提示（中文名、英文名、字段数、数据源）。

3.5.2 关联表

• 可「+ 添加关联表」，支持多张，每张记为「关联表 #N」；配置项：关联表（排除主表，展示中英文）、JOIN 类型（LEFT / INNER）、关联条件（主表字段 = 关联表 #N 字段）、所需字段（多选并入结果表）。
• 表属性限制：「关联表」仅能选择表属性为「维度表」的表（直接复用 3.1 数据字典的「表属性」字段），指标表 / 日志表等不可作为关联表被选择；主表本身不受此限制，可为任意表属性。
• 数据源限制：关联表需与主表同数据源，不支持跨数据源关联——ClickHouse 表仅可关联 ClickHouse 表，MySQL 表仅可关联 MySQL 表；两条限制同时生效。若切换主表导致数据源变化，已配置的跨源关联表将被自动清空并提示重新选择。

3.5.3 字段说明（可编辑）

• 列结构为序号 / 字段名 / 字段类型 / 字段属性 / 字段中文名 / 字段描述 / 来源（比 SQL 计算多一列「来源」，标注主表（中文名） 或 关联表 #N（中文名））；结果字段 = 主表全部字段 + 各关联表所勾选字段（按字段名去重）。

3.5.4 生成与校验

校验：至少存在一条完整的关联配置（选定关联表且关联条件两侧字段均已选）→ 再校验结果表英文名、中文名非空；基本信息与 SQL 计算一致（见 3.4.3）。

• 生成后结果表出现在数据字典列表顶部，与手工注册的表在列表展示上完全一致。
• 「查看」结果表时，详情「基础信息」展示 来源 字段（纯文本：表注册 / sql计算 / 表关联计算）；通过表计算注册的表，其"生产任务链接"字段展示为空。
• 点击「编辑」按「来源」自动分流到对应的注册页或计算页，且编辑时锁定创建方式，不允许切换（如原为 SQL 计算，编辑时「表计算」弹窗只显示 SQL 计算面板，分段控件隐藏）。

基本信息

• 指标名称 / 指标编码：自定义，均不可重复。
• 指标层级：下拉单选，原子指标 / 复合指标。
• 指标维度：下拉多选，取「维度配置」中已配置的维度（详见第 5 章）；原子指标仅可选择已绑定该维度所在表的维度，复合指标仅可选择已关联该维度的指标。

原子指标 · 数据源

• 表名称：下拉单选，取数据字典中已完成接入的数表。
• 字段名称：下拉单选，选项为所选表的字段名。
• 计算逻辑：下拉单选「页面配置 / SQL 配置」——页面配置由业务在下拉中选择聚合方式（sum/count/avg/max/min）；SQL 配置支持直接写 SQL 定义计算逻辑（鼠标 hover 展示支持的聚合函数），并提供「SQL 校验」按钮校验语法。

复合指标 · 数据源

• 数据源直接从「指标字典已上线的全部原子指标」中选择，支持跨表指标复合（不限制来源于同一张表）。
• 可点击「+」增加原子指标行，构成多指标复合。
• 当前注册指标的维度仅能取所选原子指标维度的交集（若复合范围发生变化，交集缩小导致已选维度不再合法时，需清空已选维度让业务重新选择）。
• 计算逻辑：支持按指标编码写算式，运算符 + - * / ( )。

指标定义

• 时间粒度（最小）：天 / 小时，决定指标支持按天/小时/维度计算展示。
• 适用业务：下拉多选（全业务、轻舟业务列表）。
• 指标负责人：默认取创建人（不可删除），可追加。
• 展示类型：整数 / 小数 / 百分数 / 时间，用于平台展示与推送时的格式化；整数、小数、时间类型的平均值需后端计算得出，百分数类型的平均值由数据服务直接返回（分子分母之和后计算，避免简单算术平均导致的口径错误）。

指标口径字段拆分

原「指标口径」拆分为两个更明确的字段：

指标类型

新增「指标类型」用于确定指标的计算方式，尤其是二次聚合（求平均值等）时的正确算法：

不可累加性配置

可累加性配置粒度为「指标 × 维度大类」，同一指标在不同维度大类上可分别设置是否可累加：

• 配置粒度到维度大类（如"人审业务维度""自然时间维度"），同一大类下所有层级（业务/板块/批次，或年/月/周/日）共享同一可累加属性，无需逐层配置。
• 查询汇总时，标记"可累加"的维度执行求和聚合；标记"不可累加"的维度不做跨成员求和（按最新快照或指定方式处理）。
• 历史指标兼容：历史「是否可累加型指标」= 是 → 迁移后全部维度默认"可累加"；= 否 → 全部维度默认"不可累加"。

指标单位

新增「指标单位」字段（必填，可选"无单位"），与展示类型联动——切换展示类型后单位下拉仅展示对应分组，禁止非法组合（如"整数+ %"）：

可编辑范围

• 编辑页新增「指标变更原因」输入框，必填；每次编辑均需填写，已变更指标「查看」时展示完整变更记录（时间、变更人、字段、变更前 → 变更后）。
• 已上线指标编辑后点击「确认」，弹出变更影响确认弹窗（见右侧演示），列出受影响的指标：编辑指标本身 + 引用它的复合指标 + 引用这些复合指标的复合指标……（递归影响链），并提醒会影响关联的指标告警、报表展示。
• 不触发审批：当前版本指标编辑不改变指标定义本身的合法性，已上线指标编辑不触发审批与灰度；已下线指标编辑同样不触发审批。

指标版本

• 主列表新增「最后编辑时间」（yyyy-mm-dd hh:mm:ss），取指标编辑确认完成的时间。
• 数据服务侧同步存储「指标版本」（毫秒时间戳）与「指标状态」，供下游按版本追溯。

指标删除

需同时满足以下两个条件才可删除：

1. 指标状态 = 已下线；
2. 操作人 = 指标负责人。

完成指标配置后，可对已配置指标进行预览，验证结果是否符合预期，无需等待正式上线后才发现口径问题：

• 预览维度：先单选维度（取该指标注册时选择的指标维度），再单选该维度下的具体层级进行预览——例如"轻舟业务"维度可选层级 BG / 产品 / 业务 / 子类 / 板块 / 批次，"人审业务"维度可选层级 人审业务 / 板块 / 批次；维度与层级结构定义详见第 5 章「维度配置」（同一维度不同层级本质是该维度在不同粒度下的展开，切换维度后层级候选联动刷新）。
• 预览时间：支持按时间范围聚合预览，与指标的「时间粒度」无强制关联，可独立选择时间范围。
• 点击「计算」后，展示该指标在所选维度层级、时间范围下的结果，取前 10 条以表格形式展示。
• 指标保存时即触发合法性校验，让业务在配置阶段就能发现问题，无需等到发起上线审批才被打回。

• 指标注册完成后默认状态「已下线」，点击「上线」需经交付组确认后上线，自动接入平台告警处理工具、运营监控看板、自定义报表。
• 审批接入 MyOA 审批流，审批节点：交付组确认指标合理性（是否需要该指标、业务范围、名称是否重复等）。
• 审批逻辑：交付组任意一人审批通过即可。
• 复合指标上线校验：复合指标上线时，需校验其引用的全部原子指标均已处于"已上线"状态，否则阻断上线并提示——这条规则同时应用于手工注册与批量导入两条路径（详见 4.7 指标批量导入）。
• 操作权限：仅指标创建人/ 负责人包含操作者本人时，才可发起上线/下线审批。

基础信息

• 维度名称：输入框，≤10 字符。
• 维度编码：输入框，业务自定义。
• 维度标签：下拉，必选，取标签配置维护的标签列表。
• 维度负责人：下拉，必选。
• 维度说明：输入框，≤100 字符。
• 是否配置维度：下拉「是 / 否」，默认「否」：
  • 选择「否」：该维度不关联任何表/字段，仅作为一个简单枚举值维度使用，需额外选择数据类型（下拉，如 String / Int64 等）描述其取值类型。
  • 选择「是」：展开下方「维度配置」区块，通过字段 / SQL / 手动三种方式之一定义维度的取值来源与层级结构，数据类型由配置方式自动决定，无需再单独指定。

维度配置（仅"是否配置维度=是"时展开）

请输入维度ID与维度名称的映射关系，ID与名称之间通过英文逗号分隔，
如有多级维度映射关系，请在同一行内用英文逗号依次列出，顺序与维度配置顺序保持一致，
如有多条数据请换行输入，并在首行保留字段名称
e.g.
业务id, 业务名称, 板块id, 板块名称
500001,业务一,70001,板块一
500002,业务二,70002,板块二
500003,业务三,70003,板块三

「维度配置」区块右上角可展开「维度预览」，配置完成前默认"暂无预览效果"；配置完成后按已定义的层级分别展示前 3 条预览数据，每级可另行「设置属性字段」补充非维度 ID/名称的其他展示列。