指标管理
概述
观远指标中心支持通过列表和指标图浏览指标，并提供图表分析、查询加速、血缘分析、批量导入导出、上下线、版本及权限管理等能力。
查看指标
进入指标主题后，即可查看当前主题下的所有指标，点击右上角「新建指标」，选择指标类型即可创建指标。创建指标的流程详见 创建原子指标、创建复合指标 和 创建衍生指标。
列表模式
列表模式集中展示当前主题下的指标。可查看指标名称、类型、业务路径、最近修改时间、引用数和访问数等信息，并对指标进行编辑或其他管理操作。
指标状态与草稿标记
列表中的「在线/未上线」状态表示已发布版本当前是否在线；指标名称旁的「草稿」标记表示该指标存在已保存但尚未发布的内容。两种标记相互独立。
| 列表显示 | 说明 |
|---|---|
| 在线 | 指标当前存在生效的在线版本，可以被其他功能使用。 |
| 未上线 | 指标曾经上线，但当前已被下线，不能继续被其他功能使用。 |
| 在线 + 草稿 | 已发布版本仍然在线，同时存在尚未发布的修改。其他功能继续使用已发布版本。 |
| 未上线 + 草稿 | 指标当前没有在线版本，并且存在已保存但尚未发布的内容。首次新建指标时点击「保存为草稿」，或者将指标下线后再次编辑并保存为草稿，均会显示该组合状态。 |
指标的上下线规则和版本管理方式，详见 指标上下线及版本管理。
自定义列表展示
如需为指标添加自定义业务属性，或设置属性是否必填、是否展示在列表及是否支持筛选，可前往「管理中心 > 企业配置 > 指标属性管理」进行配置，详见 指标属性管理。
指标图
指标图以图形方式展示指标数值和数据分布，帮助用户快速了解指标表现。
指标详情
在指标详情页，可查看指标图表、定义、血缘和版本等信息，其中原子指标还可查看或配置查询加速计划。根据当前用户的权限，还可编辑、复制、移动、上下线、删除指标，以及管理指标权限和责任人。
指标详情页主要包含以下功能：
| 功能区域 | 说明 |
|---|---|
| 基本信息 | 查看指标名称、类型、状态、权限、访问数和引用数等信息。其中，创建人是创建该指标的用户；责任人是指标业务口径的解释对象，对口径的合理性和准确性负责。创建人和责任人可以不是同一人。 |
| 图表 | 查看和分析指标数据，支持配置图表类型、维度、筛选及排序等，详见 图表分析。 |
| 定义 | 查看指标的计算口径、适用维度、业务口径和管理属性等信息。不同类型指标展示的定义内容有所不同。 |
| 血缘 | 查看指标关联的上下游资源及字段血缘，详见 血缘。 |
| 版本 | 查看当前版本和历史版本，进行指标版本管理，详见 版本。 |
| 查询加速 | 查看或配置原子指标的加速计划，提升指标查询效率，详见 查询加速。 |
| 编辑 | 修改指标的定义和属性。 |
| 更多操作 | 支持复制、创建指标、移动、关联和删除等操作。上下线和历史版本操作详见 指标上下线及版本管理；权限操作详见 指标权限管理。 |
图表分析
在指标详情页点击「图表」，可查看指标当前数值，并通过不同图表和分析条件查看指标在各维度下的表现。
| 操作 | 说明 |
|---|---|
| 查询语句 | 查看当前图表配置对应的查询语句。 |
| 重置 | 清除当前调整，恢复默认图表配置。 |
| 保存为默认图表 | 将当前图表类型和分析条件保存为该指标的默认图表。 |
| 创建指标分析卡片 | 基于当前指标创建指标分析卡片，用于后续分析和仪表板展示，详见 指标分析。 |
查询加速
原子指标通常基于明细数据集计算。当明细数据量较大时，每次查询都直接扫描和聚合明细数据，可能需要较长时间。
查询加速支持为原子指标关联预先准备的汇总数据集或降维数据集，作为加速计划的数据来源。查询时，系统优先使用符合当前分析条件的加速数据集；如果没有匹配的加速计划，则仍使用原指标的数据集。该功能通过减少参与计算的数据量缩短查询时间，不改变指标的业务口径和查询结果。
适用范围与权限
- 查询加速仅支持原子指标，复合指标和衍生指标不支持配置加速计划。
- 查看查询加速计划时，用户需为指标所在主题的所有者或使用者，拥有该指标的所有者或使用者权限，并拥有指标中心「查看」权限。
- 配置查询加速计划时，用户需为指标所在主题的所有者或使用者，拥有该指标的所有者权限，并拥有指标中心「编辑」权限。完整权限规则详见 权限管理。
配置前准备
使用前，需要根据原指标的数据和计算口径，提前准备汇总数据集或降维数据集。加速计划中的来源字段、聚合方式、维度和筛选范围应与原指标口径保持一致，避免加速查询结果与原指标结果不一致。
新建加速计划
指标所有者可以按照以下步骤新建加速计划：
- 进入原子指标详情页，在「查询加速」页签下点击「新建加速计划」。
- 在「新建加速计划」对话框中完成以下配置。
| 配置项 | 是否必填 | 说明 |
|---|---|---|
| 数据集 | 是 | 选择加速计划使用的数据集，通常为基于原指标明细数据加工的汇总数据集或降维数据集。 |
| 来源字段 | 是 | 选择用于计算指标值的字段，其业务含义应与原指标的来源字段一致。 |
| 聚合方式 | 是 | 设置来源字段的聚合方式，支持 sum 和 count。配置应与原指标的聚合逻辑一致。 |
| 适用维度 | 是 | 选择该计划支持的分析维度。 只有查询使用的维度均包含在其中时，该计划才可用于查询。 |
| 时间维度 | 否 | 指定用于时间分析的字段。 需先将时间字段添加至「适用维度」，才能在此选择。 |
| 筛选 | 否 | 限定使用加速数据集计算指标时的数据范围。支持使用「且」或「或」组合多个条件，条件应与原指标的业务口径一致。 该配置不会修改加速数据集本身，也不同于用户查询指标时临时添加的筛选条件。 示例：原指标仅统计「渠道类型 = 直营」的库存市值，而加速数据集中还包含其他渠道的数据。此时，在加速计划中设置「渠道类型 = 直营」。使用该计划查询时，系统会先筛选直营渠道的数据，再计算库存市值。 |
- 点击「确定」，完成加速计划创建。
加速计划匹配规则
可以为一个原子指标配置多个加速计划，并在计划列表中调整查询顺序。查询指标时，系统先根据本次查询使用的维度、时间维度和筛选字段匹配可用的加速计划，再从中选择查询顺序最靠前的计划。如果没有符合条件的加速计划，则使用原指标的数据集查询。
示例
「库存市值」基于 库存表_日_SKC_store 数据集创建。图中为该指标配置了 4 个加速计划，原指标数据集标记为「默认」：
| 查询顺序 | 数据集 | 代表性维度 |
|---|---|---|
| 1 | 门店库存表_库存市值_款色编码 | SKC、商品品牌名称、门店名称、统计日期等 |
| 2 | 门店库存表_库存市值_产品季 | 产品季节、商品品牌名称、统计年份、统计月份、统计季度等 |
| 3 | 门店库存表_库存市值_产品线 | 产品线、批次、产品季节编码、商品品牌名称、统计日期等 |
| 4 | 门店库存表_库存市值_新老品 | 新老品、性别、产品经理一级、产品季节、门店名称等 |
| 5（默认） | 库存表_日_SKC_store | 包含渠道类型、一级代理商、国家、门店名称、商品品牌名称、SKC 等更完整的维度 |
不同查询场景会使用以下数据集：
| 查询场景 | 使用的数据集 | 原因 |
|---|---|---|
| 按 SKC 和门店名称查看库存市值 | 门店库存表_库存市值_款色编码 | 该数据集包含本次查询所需维度，且查询顺序最靠前。 |
| 按产品季节和商品品牌名称查看库存市值 | 门店库存表_库存市值_产品季 | 顺序为 1 的计划不包含产品季节，顺序为 2 的计划可以满足查询。 |
| 按产品线和批次查看库存市值 | 门店库存表_库存市值_产品线 | 前两个计划不同时包含产品线和批次，顺序为 3 的计划可以满足查询。 |
| 按性别和新老品查看库存市值 | 门店库存表_库存市值_新老品 | 前三个计划不包含本次查询所需的全部维度，顺序为 4 的计划可以满足查询。 |
| 按渠道类型查看库存市值 | 库存表_日_SKC_store | 4 个加速计划均不包含渠道类型，系统回退使用标记为「默认」的数据集。 |
查看血缘
资源血缘
指标资源血缘与数据集、卡片、页面的资源血缘打通，使用一套资源血缘系统。在指标详情页点击「血缘 > 资源血缘」，可查看指标上下游资源依赖关系。
-
指标作为大类细分为原子指标、衍生指标、复合指标，不同类型指标在血缘图中以不同图标标识。
-
点击血缘图中任意资源，右侧展示该资源详情。
字段血缘
指标字段血缘与数据集 BI 资源的字段血缘打通，使用一套字段血缘系统。在指标详情页点击「血缘 > 字段血缘」，在「字段列表」页签勾选需要分析血缘的字段，即可显示该指标上游数据集字段血缘，帮助用户追溯指标计算所依赖的具体数据字段，便于进行数据治理和影响分析。
- 仅分析对象为数据集、普通卡片、原子指标时，上游可直接指向数据集字段，且仅展示指标定义中应用的字段。
- 复合指标和衍生指标不支持字段血缘。
批量管理指标
在指标列表中勾选一个或多个指标后，页面下方会显示当前可执行的批量操作。具体操作如下：
| 批量操作 | 说明 |
|---|---|
| 批量授权 | 为选中的指标统一配置所有者或使用者，详见 批量授权。 |
| 批量移动 | 将选中的指标移动至指定文件夹，详见 批量移动。 |
| 批量删除 | 删除选中的指标，详见 批量删除。 |
| 批量导出 | 将选中的原子指标导出为 Excel 文件，详见 原子指标批量导出。 |
| 批量下线 | 将选中的在线指标下线，详见 批量下线。 |
批量授权
在指标列表中勾选需要授权的指标，点击页面下方的「批量授权」，统一配置指标的所有者或使用者。详细操作和权限生效规则，详见 指标批量授权。
批量移动
在指标列表中勾选需要移动的指标，点击页面下方的「批量移动」，按照页面提示选择目标文件夹并确认。
原子指标批量导出
在指标列表中勾选需要导出的指标。当已选指标中包含原子指标时，页面展示「批量导出」按钮。点击「批量导出」，确认本次导出的原子指标数量后，点击「确定」，系统将指标导出为 Excel 文件。
- 仅能导出拥有编辑权限的原子指标。
- 若勾选原子指标后未显示「批量导出」按钮，请进入「管理中心 > 角色」，确认当前角色已开启指标中心的「导出」权限。普通用户默认拥有导出权限。
批量导入
批量导入指标的步骤如下：
- 在指标主题中进入需要导入指标的目标文件夹，点击指标列表上方的「批量导入」，打开「批量导入」对话框。「全部」视图不支持批量导入，因此不会显示该按钮。
- 点击 批量导入指标模板 下载模板，按照模板说明填写指标信息。
- 上传填写完成的模板，点击「导入」。
- 导入完成后，查看导入总数、成功数和失败数。如存在失败数据，可下载导入失败文件，修改后重新上传。
- 上传文件不能包含合并单元格，支持
.xls和.xlsx格式。.xlsx文件不能超过 500 MB，.xls文件不能超过 5 MB。 - 「覆盖已存在的同名指标」列必须填写。选择「是」时，新导入的指标将覆盖已有同名指标；选择「否」时，同名指标将导入失败。
下图为批量导入模板和导入结果示例。
批量删除
在指标列表中勾选需要删除的指标后点击「批量删除」，确认后即可完成删除。
- 仅支持删除下线状态的指标。
- 指标被其他复合指标、衍生指标或卡片引用时，无法删除。
批量下线
在指标列表中勾选需要下线的在线指标，点击页面下方的「批量下线」，按照页面提示确认。指标能否下线需遵循 指标状态说明 中的规则。
指标上下线及版本管理
指标上下线用于控制指标是否可被仪表板或其他指标使用。指标每次上线时，系统都会生成新的版本号，原版本则保留为历史版本，便于追溯和恢复指标定义。
指标状态说明
进入指标详情页，点击右上角「更多」，可根据指标当前状态执行上线或下线操作。
指标状态规则如下：
- 指标只有在上线后才能被仪表板使用，仪表板处只能选择在线状态的指标。
- 指标只有在上线后才能被衍生指标、复合指标使用，只能选择在线状态的指标。
- 指标如果被复合/衍生指标/卡片引用，则无法下线。
指标版本说明
在指标详情页点击「版本」页签，或在右上角「更多」中选择「历史版本」，可查看当前版本和历史版本，并恢复需要的历史版本。
- 指标可保留多个历史版本，但最多只能存在一个草稿。
- 每次上线指标时，系统都会为当前版本分配新的版本号，原版本自动转为历史版本。
指标权限管理
指标权限由主题角色、指标角色和指标中心角色操作权限共同决定。用户访问或操作指标时，需同时满足对应的主题角色、指标角色和指标中心角色操作权限。完整权限规则，详见 权限管理。