复合指标

复合指标

使用场景：数据开发人员需创建复合指标供消费人员消费使用。

使用角色：数据开发人员。

功能描述：平台提供复合指标构建能力，将可派生指标通过四则运算等加工形成复合指标资产供用户消费。

复合指标配置

新建

进入数据开发 > 数据指标 > 复合指标界面，点击页面上方的“新建复合指标”按钮，在弹窗中填写页面信息后“保存”即可。

• 复合指标基本信息

  • 指标中文名：必填，用户根据实际业务场景手动输入指标中文名称，空间内不允许重复；
  • 指标英文名：必填，用户根据实际业务场景手动输入指标英文名称，空间内不允许重复；
  • 提供方：必填，下拉选择组织机构，即该复合指标的来源组织；
  • 责任人：必填，下拉选择用户作为该复合指标责任人，当前仅为业务层面责任人，不会在计算时进行相关权限校验；
  • 资源标签：非必填，可多选自定义资源标签；
  • 参考依据：非必填，可多选，下拉选择已发布标准文件名称，后续查看指标时可下载标准文件；
  • 关联目录：非必填，点击按钮后可勾选多个目录进行关联目录，可用于后续按目录检索及数据开放按目录展示；
  • 描述：非必填，用户可以根据实际业务场景或复合指标创建用途等信息填写。

• 复合指标计算规则

  • 计算模式：平台提供三种计算模式，包括表达式、同比、环比，用户手动选择；

    • 表达式：支持拖动四则运算符号、派生指标至画布组合成计算逻辑；画布中指标、符号均支持移除，指标从画布移除不影响左侧已选；表达式中所选派生指标必须同时包含至少一个相同的维度值，保存时校验；
    • 同比计算公式:
      $$同比增长率= \frac{本期数值-同期数值}{同期数值}\times100\%。$$
      同期为去年同一期
    • 环比计算公式：
      $$环比增长率= \frac{本期数值-上期数值}{上期数值}\times100\%。$$
      上期为今年上一期
      同环比示例

      计算2024年10月的“当月销售额”的同环比增长率。

      • 同比增长率：（2024年10月销售额-2023年10月销售额）÷ 2023年10月销售额×100%
      • 环比增长率：（2024年10月销售额-2024年9月销售额）÷ 2024年9月销售额×100%

  • 计算逻辑：下拉选择平台当前空间内已创建好的派生指标。若用户计算模式选择为表达式，则在计算逻辑中还需要拖动四则运算符号、派生指标至画布组合成计算逻辑；

  • 计量单位：用户根据实际业务场景手动输入计量单位。

派生指标选择说明

• 下拉多选，计算模式为表达式时可选择所有状态的派生指标，支持多选；
• 时间周期为“前1小时、前3小时、前1天、前7天、前30天、前90天、前180天、前365天”的派生指标不支持参与同环比计算；
• 已选派生指标不可重复选择；
• 左侧为预选区域，可反复新增删除；右侧表达式可选择左侧已选派生指标，但左侧派生指标删除不会影响右侧已配置表达式。

注意

• 复合指标创建完成后可点击指标名称查看“数据预览”；
• 数据预览支持选择指定时间段，若不选择则取最新时间的数据进行实时计算；
• 派生指标数据缺失、计算分母为0时，无法计算出数值，则结果显示“-”；
• 派生指标数据缺失并非单纯派生指标无数据，而是需保证指定周期数据不缺失上，如计算2024年4月同比，则要求派生指标的本期2024年4月、同期2023年4月均需有数据。

修改

进入数据开发 > 数据指标 > 复合指标界面，点击复合指标列表操作列的“修改”按钮，即可修改复合指标的所有信息。

注意

• 未发布的复合指标方可修改。

删除

进入数据开发 > 数据指标 > 复合指标界面，点击复合指标列表操作列的“删除”按钮，二次确认后可删除派生指标。

注意

• 未发布的复合指标方可删除。

发布&下架

平台提供发布/下架和批量发布/下架两种操作，进入数据开发 > 数据指标 > 复合指标界面，可按需选择对应操作按钮。

指标消费注意

• 业务时间精确到时分秒，开始时间默认为00:00:00，结束时间默认23:59:59；
• 根据所选业务时间，指标结果可以是一条或者多条；
• 若计算失败，则直接显示计算失败，并显示失败日志。
• 复合指标发布后，且所在目录也已发布，则可在数据开放 > 本空间资产 > 数据指标资产模块查看并消费；复合指标发布后不允许修改、删除操作，需下架后再进行修改、删除。
• 复合指标无调度，不会周期性计算指标结果，只有在API消费时进行实时计算指标值。

关联目录&解除关联

• 关联目录
  平台支持将资产关联至目录，供后续资产发布至数据开放模块时，若关联目录也发布，则可按目录展示资产。

1. 点击某个资产“关联目录”按钮；或批量勾选资产后，点击“批量关联目录”按钮。
2. 进入 “关联目录” 操作界面后勾选需要关联的“待选”目录，将其确认为“已选”目录，保存即可关联目录。

注意

• 已发布资产不允许关联目录，需下架资产再操作；
• 一个指标可关联多个目录，当前表已选目录不可重复选择；
• 批量关联时不会显示多个表的已关联目录，并且保存后会清空各表已关联目录，仅关联最新批量选择的目录。

• 解除关联
  已关联目录的资产支持解除关联，则该资产不可在数据开放模块可见。

1. 点击某个资产“关联目录”按钮，即可解除关联目录。
2. 进入 “关联目录” 操作界面后将需要解除关联的“已选”删除，保存即可解除关联目录。

注意

• 已发布资产不允许解除关联目录，需下架资产再操作；
• 当前暂不支持批量解除关联目录。

指标图谱

1. 进入数据开发 > 数据指标 > 复合指标界面，选择目标复合指标，点击“指标图谱”按钮可快速查看各类指标的关联关系，均显示中文名，当前原子指标将高亮展示。

2. 点击图谱中指标名称后方的“发布/下架”图标，可快速对派生/复合指标进行发布/下架操作；点击指标名称后方的“删除”图标，经二次确认后将删除该指标，并同步删除关联指标。

相关术语

派生指标 复合指标

最佳实践

数据开发-指标开发