概述
指标管理，旨在基于已发布的分析模型，可创建原子指标和衍生指标，创建指标后，可即时、动态查询指标计算结果。
准备工作
1. 确保按照 前置准备完成准备工作。
2. 确保当前用户拥有数据治理 > 语义建模 > 指标管理的只读权限或读写删权限。
说明：
读写删权限：拥有读写删权限的人可以新建指标，以及本项目下所有指标的查看、编辑、发布、下线、删除等操作。
只读权限：拥有只读权限的人可以查看本项目所有指标，可新建指标，但是只能编辑、发布、下线、删除自己是负责人的指标。
新建/编辑指标
原子指标
1. 进入数据治理 > 语义建模 > 指标管理。
2. 单击指标列表上方的“新建指标”按钮。
3. 进入下图所示的指标创建页面。
区域 | 介绍 |
基础信息 | 指标类型：选择“原子指标” 指标英文名：指标唯一标识，需当前项目内唯一，后续指标查询时，使用该字段。 指标别名：需当前项目内唯一 |
计算口径描述 | 业务口径：描述指标业务含义和业务统计口径 技术口径：备用字段，用以记录指标技术口径信息 指标备注：备用字段，用以记录其他指标备注信息，如参考的公司标准、文档等。 |
计算口径配置 | 来源：选择已经发布的模型，以及选择模型中的一个表作为该原子指标聚合逻辑的来源表。注意：来源表中至少定义一个时间维度，否则不可以作为原子指标统计的来源表。 计算逻辑：支持标准模式和自定义模式。 标准模式：支持用户选择上面来源表中的某个字段（也可以选择虚拟字段）以及聚合函数 自定义模式：支持用户通过SQL形式定义该原子指标的聚合逻辑，例如：统计薪资高于5000的员工数,salary为模型中主表中的字段名，自定义SQL为：COUNT_IF(salary > 5000) 半累加指标：是指在部分维度上可以累加，而在另一部分维度上不能累加的指标，打开开关后表示该指标是半累加指标，同时需配置如下属性： 不可累加维度：需指定当前指标在哪个维度不可累加，当前仅支持选择时间维度。比如事实表是每日库存快照，计算月底库存时无法在日期维度上累加。 窗口分组：指标聚合时，会预先将数据按照窗口字段进行分组，在分组后的数据内根据窗口选择进行数据过滤。 窗口取值：可选值为最新值或最旧值。指标聚合时，数据聚合范围内的最大的日期或最小的日期对应的数据聚合结果将作为指标结果，比如月末的库存取值为每月最后一天的库存值。 指标时间标识：需选择一个时间维度作为指标时间标识。它主要解决 “按哪个时间字段统计” 的问题，确保不同场景下时间维度的一致性。例如，“订单金额” 可按 “订单创建时间” 统计（反映下单时间），也可按 “订单支付时间” 统计（反映支付时间），指标时间标识会明确选择其中一个作为基准。 分析维度：当前指标可支持的分析维度，该维度范围是：在该指标选择的来源模型中，以当前指标的来源表为根节点，left Join 2层所包含的表中定义的所有维度。 |
业务信息 | 归属项目：默认为当前项目，暂时不支持修改。 业务负责人：默认为创建人，可修改。 技术负责人：默认为创建人，可修改。 重要等级：表示指标的重要等级，包含核心、重要、一般、临时 资产目录：可将指标挂在资产目录中，方便从业务视角管理归类，也方便指标消费方便快捷查询。 |
4. 第4步：配置完上述指标信息后，可单击“保存&发布”按钮，即可发布指标。此处注意：如果当前项目开启了指标发布审批流程，则需要经过审批后方可发布成功；如果该项目没有开启指标发布审批流，则此处直接发布成功，
后续操作：发布成功后，可以基于该原子指标配置衍生指标，或直接通过指标分析、指标服务查询使用该指标。
衍生指标
衍生指标分类&典型场景：
衍生类型 | 含义 | 典型场景 |
筛选型 | 在原子指标基础上，按特定维度（如时间、地域、用户属性）筛选后得到的指标。 | 指标：线上渠道交易总金额 原子指标：交易总金额， 业务限定：渠道=线上 |
累积计算型 | 对原子/筛选型指标按时间窗口累加、汇总计算得到的指标。 | 指标：近30天线上渠道交易总金额 原子指标：交易总金额， 业务限定：渠道=线上 统计周期：近30天 |
同环比计算型 | 以累计计算型指标为基础，与历史同期（同比）或上一周期（环比）数据对比计算的相对指标。 | 指标：近30天线上渠道交易总金额环比增长率 依赖指标A：近30天线上渠道交易总金额 计算规则： （A-上周期的A）/上周期的A 注意：上周期的A统计结果系统根据已选的A自动统计。 |
混合计算型 | 结合两个及以上指标通过衍生计算规则（如加减乘除等）得到的复合指标。 | 指标：平均交易流水金额 依赖指标：交易总金额、交易数量 计算规则：交易总金额/交易数量 |
转化计算型 | 基于不同环节的原子指标（或筛选型指标），计算流程中 “从 A 到 B” 的转化效率指标。 | 指标：注册-下单转化率 初始事件指标：注册量 转化事件指标：下单量 计算规则：下单量 / 注册量 |
1. 进入数据治理 > 语义建模 > 指标管理。
2. 单击指标列表上方的“新建指标”按钮。
3. 进入下图所示的指标创建页面。
区域 | 介绍 |
基础信息 | 指标类型选择“衍生指标” 其余与原子指标设置逻辑相同 |
计算口径描述 | 与原子指标设置逻辑相同。 |
计算口径配置 | 衍生指标的计算口径配置逻辑与所选衍生类型相关，目前支持筛选型指标、混合计算型指标、累积型计算型指标、同环比计算型指标、转化计算型指标共5种衍生类型。 筛选型指标：用于在原子指标基础上增加业务限定条件的指标配置  衍生类型：选择“筛选型指标” 依赖指标：选择1个原子指标作为依赖指标 业务限定：支持通过SQL配置业务限定，比如渠道=“线上”为业务限定，可写为：Dimension(channel) = 'online' 分析维度：指当前指标的可用分析维度，与依赖的原子指标的可用分析维度相同。 示例：如配置“线上渠道交易总金额”指标，依赖的原子指标为“交易总金额”，业务限定为Dimension(channel) = 'online' 混合计算型指标：用于配置需通过加减乘除等运算，对多个基础指标进行组合计算的场景。  衍生类型：选择“混合计算型指标” 依赖指标：可选择多个指标作为依赖指标 计算逻辑：支持通过运算符对已选依赖指标进行混合运算，如（B-A）/B 分析维度：指当前指标的可用分析维度，来自所依赖的所有指标的可用分析维度的交集。 示例：如果配置平均交易流水金额指标，则依赖指标为“交易总金额”和“交易数量”，计算规则为“交易总金额/交易数量” 累积型计算型指标：需要按时间窗口累加、汇总计算得到的指标，比如近30天线上渠道交易总金额。  衍生类型：选择“累计计算型指标” 依赖指标：可选择1个指标作为依赖指标 统计窗口：可选择近7天、近30天、WTD、MTD、QTD等多种统计窗口。 业务限定：支持通过SQL配置业务限定，比如渠道=“线上”为业务限定，可写为：Dimension(channel) = 'online' 分析维度：指当前指标的可用分析维度，来自所依赖的所有指标的可用分析维度的交集。 示例：如配置“近30天线上渠道交易总金额”指标，依赖的指标为“交易总金额”，业务限定为渠道=“线上”，统计周期为“近30天” 同环比计算型指标：以累计计算型指标为基础，与历史同期（同比）或上一周期（环比）数据对比计算的相对指标。  衍生类型：选择“同环比计算型指标” 依赖指标：可选择1个累积计算型指标作为依赖指标 计算逻辑：可选择“同比增长率”或“环比增长率”，系统会根据依赖指标的统计窗口，自动计算其上周期或去年同周期的指标值，并最终按照计算逻辑指定的“同比增长率”或“环比增长率”输出计算结果。 分析维度：指当前指标的可用分析维度，来自所依赖的所有指标的可用分析维度的交集。 示例：如配置“近30天线上渠道交易总金额环比增长率”指标，依赖指标为A，即“近30天线上渠道交易总金额”，计算规则为“环比增长率”，即“（A-上周期的A）/上周期的A”。注意：“上周期的A”由系统根据已选的依赖指标自动统计。 转化计算型指标：基于不同环节的原子指标（或筛选型指标），计算流程中 “从 A 到 B” 的转化效率指标。  衍生类型：选择“转化计算型指标” 依赖指标：可分别选择1个“初始事件”的统计指标（如注册用户数）和“转化事件”的统计指标（如下单用户数） 计算逻辑：可选择“转化率”或“转化值”，系统会根据依赖指标自动计算从“初始事件”流转的到“转化事件”的转化率或转化值。其中，转化率为“转化事件”指标值/“初始事件”指标值；转化值为在“初始事件”满足的情况下，转化事件统计值。 链接字段：表示“初始事件”流转到“转化事件”的关联字段，如注册-下单转化率统计时，通过用户ID关联，下单用户数统计的用户ID必须是注册用户数中用户ID的子集。 转化窗口：指统计转化率或转化值的统计时间窗口，如3天内转化、第3天转化等模式。时间粒度除了天，还支持月、周、天、小时。时间长度用户可自定义输入整数即可。 分析维度：指当前指标的可用分析维度，来自所依赖的所有指标的可用分析维度的交集。 示例：如配置“注册-下单转化率”指标，初始事件指标为“注册用户数”，转化事件指标为“下单用户数”，计算规则选择转化率，即“下单用户数/ 注册用户数” |
业务信息 | 与原子指标设置逻辑相同。 |
4. 配置完上述指标信息后，可单击“保存&发布”按钮，即可发布指标。此处注意：如果当前项目开启了指标发布审批流程，则需要经过审批后方可发布成功；如果该项目没有开启指标发布审批流，审批流直接发布成功，
后续操作：发布成功后，可以基于该指标继续配置衍生指标，或直接通过指标分析、指标服务查询使用该指标。
说明：
衍生指标中，“累积计算型”、“同环比计算型”和“转化计算型”指标配置时，需先创建时间线表。单击查看什么是时间线表。
指标生命周期管理
指标生命周期状态可按照下面状态图流转：
已发布：新建指标并选择“保存&发布”操作，指标将处于已发布状态；或对已下线的指标重新“发布”或编辑后选择“保存&发布”操作，指标将处于已发布状态；或对处于“已发布”状态的指标进行编辑并选择“保存&发布”操作后，指标也将处于已发布状态。
已下线：对已发布的指标选择“下线”操作后，指标将处于已下线状态。
已删除：已下线的指标可通过“删除“操作直接删除，删除后指标不可见。
下线指标
如果已发布的指标不再使用，可下线指标。
操作步骤：
1. 进入数据治理 > 语义建模 > 指标管理.
2. 单击指标列表操作列中的“下线”按钮.
3. 如果未开启下线审批，则指标可直接下线成功；如果开启了指标下线审批，则会触发审批流程，审批通过后，指标将下线成功，审批通过之前，该指标仍旧处于“已发布”状态，且可正常使用。
说明：
1. 如果下线的指标是其他衍生指标的依赖指标，则不可直接下线该指标，需修改依赖该指标的衍生指标解除依赖关系后，再下线该指标。
2. 开启指标下线审批流：项目管理 > 基本信息配置 > 审批配置Tab > 在"指标"Tab内，打开“下线审批”的开关，即可设置下线指标审批流程。支持设置条件触发审批和多级审批策略。
发布指标
如果已下线的指标需重新启用，可重新发布指标。
操作步骤：
1. 进入数据治理 > 语义建模 > 指标管理。
2. 单击指标列表操作列中的“发布”按钮可发布指标；或单击编辑按钮，修改指标口径后，在编辑页面选择“保存&发布”按钮，可发布指标
3. 如果未开启发布审批，则指标可直接发布成功；如果开启了指标发布审批，则会触发审批流程，审批通过后，指标将发布成功，审批通过之前，该指标仍旧处于“已下线”状态，不可使用。
说明：
1. 如果要发布的指标是衍生指标，且依赖的指标处于“已下线”状态，则不可直接发布该指标，需先发布依赖指标，再发布该指标。
2. 开启指标发布审批流：项目管理 > 基本信息配置 > 审批配置Tab > 在"指标"Tab内，打开“发布审批”的开关，即可设置发布指标审批流程。支持设置条件触发审批和多级审批策略。
删除指标
已下线的指标可通过“删除”操作直接删除，删除后指标不可见且不可恢复。
操作步骤：
1. 进入数据治理->语义建模->指标管理
2. 单击指标列表操作列中的“删除”按钮可删除指标
说明：
如果要删除的指标被其他衍生指标依赖，则不可直接删除该指标，需先解除依赖关系后删除。
转交指标业务/技术负责人
每个指标上有2个负责人角色，一个是业务负责人，负责指标的业务口径确定；另一个是技术负责人，负责指标的技术口径配置。在发生架构调整、人员职责变动时，可通过转交负责人来修改指标的负责人信息。
单个修改
1. 进入数据治理 > 语义建模 > 指标管理
2. 单击指标列表操作列中的“编辑”按钮，可在指标编辑页面修改该指标的业务负责人和技术负责人。
批量修改
1. 进入数据治理 > 语义建模 > 指标管理
2. 勾选需要修改负责人的指标
3. 单击指标列表顶部的“批量修改业务负责人”或“批量修改技术负责人”来分别修改选中指标的业务负责人和技术负责人。
指标发现&使用
指标发现&申请权限
指标创建后，指标消费方可在数据资产模块通过多维筛选条件，发现指标并查看指标口径，在申请指标权限后方可查询指标在多维度组合下的即时计算结果。
1. 进入数据治理 > 数据资产 > 数据发现 > 指标Tab页签
2. 顶部输入关键字或左侧选择指标类型、状态、负责人等其他筛选条件，查询指标
3. 选择目标指标，单击后可进入指标详情页面，查看指标基本信息、业务信息、口径明细以及指标血缘等信息。
4. 在指标详情页面，可单击右上角的“申请调用”按钮，设置申请时长、申请原因后，提交审批，审批通过后，申请人即可获得指标查询权限。此时方可使用“指标分析”（参见“指标分析”章节详细解释）功能和调用“指标服务”（参见“指标服务”章节详细解释）查询指标计算结果。
说明：
配置指标调用审批流：项目管理 > 基本信息配置 > 审批配置Tab > 在"指标"Tab内，打开“服务调用审批”的开关，即可设置指标调用申请审批流程。支持设置条件触发审批和多级审批策略。
指标分析
前置条件：当前用户已经申请了当前指标的查询权限
针对已经发布的指标，可在指标详情页面，指定分析维度、过滤条件等即时查询对应的指标计算结果。支持两种模式：
模式1: 表单模式
如下图所示，在查询模式中选择“表单”，用户可在指标分析页面可视化设置查询指标的时间区间、粒度、分析维度，也可设置每个维度下所需要分析的维度值（比如“用户性别”这个维度，可选择全部维度值（如图所示），或仅选择“男性”或“女性”作为查询过滤条件）。设置完后，单击“查询”按钮，即可在下面表单看到当前指定条件下的指标即时计算结果。支持用户随时按需调整查询条件、多维度灵活组合，并支持预览最终查询SQL。
模式2: SemQL 模式
如下图所示，在查询模式中选择“SemQL”，用户即可在分析页面通过输入SemQL语句，设置查询指标的时间区间、粒度、分析维度、过滤条件、排序等。设置完后，单击“查询”按钮，即可在下面表单看到当前指定条件下的指标即时计算结果。支持用户随时按需调整查询条件、多维度灵活组合，并支持预览最终查询SQL。
#场景1: 查询指标按指定维度输出，其中OrderAmount为指标编码，product_id为维度编码，TimeOutput(day)表示时间序列按天粒度输出，如果需要按月、年则可替换为TimeOutput(month)或TimeOutput(year)。select * from query(metric=[OrderAmount],group_by=[TimeOutput(day)],where=[Dimension(product_id) = 'P9786'],order_by=[TimeOutput(day) desc],limit=10)#场景2: 查看查询语句生成的sql，注意，只需要对所有查询语句后，添加compiler=true，即可获取该查询语句对应的查询sql。select * from query(metric=[OrderAmount],group_by=[TimeOutput(day)],where=[Dimension(product_id) = 'P9786'],order_by=[TimeOutput(day) desc],limit=10,compiler=true)#场景3: 字典维度和时间维度作为where条件查询指标。其中：其中latest30DaysOrderAmount为指标编码，product_type为维度编码，event_date为时间维度编码。select * from query(metric=[latest30DaysOrderAmount],group_by=[TimeOutput(day)],where=[Dimension(product_type) = 'electronic' and(TimeDimension(event_date,day)>='2025-01-01' AND TimeDimension(event_date,day)<='2025-01-31')],order_by=[TimeOutput(day) desc],limit=10)
指标血缘
支持指标全链路血缘可视化查询，具体包含：
1. 上游链路：当前指标关联的上游模型与依赖指标，及创建模型使用的表、表对应的加工任务和上游表（需该加工任务部署于 WeData 平台）。
2. 下游链路：当前指标衍生的各类下游指标。
