管理派生指标


可以在指标管理中基于原子指标来定义派生指标，并对派生指标进行编辑、发布等操作。

前提条件


开始之前，请确保以下事项：

  • 当前账号已被分配包含 指标中心 在内的菜单组。如未分配，联系应用管理员。
  • 当前标准指标库中已包含所需使用的原子指标，或已创建所需使用的原子指标。
  • 已创建并发布所需使用的维度表。

新建派生指标


  1. 选择左侧导航栏中的 指标中心，默认进入 原子指标 页面。

  2. 选择 派生指标 标签页，选择 新建，在派生指标创建页面输入以下信息：

    • 指标类型：选择 单值指标 或 多值指标。创建后不可修改。

      • 单值指标：只有一个固定的值与之对应的指标。例如，某设备某天的发电量。
      • 多值指标：有多个值与之对应的指标。例如，某设备每天的发电量。

    • 关联原子指标：在下拉框中选择系统内置的 标准指标 库中的原子指标，或选择已创建的指标库中的原子指标来定义指标的计算逻辑。若当前原子指标库无法满足业务需求，可选择 创建原子指标。更多信息，参见 新建原子指标。

    • 统计维度：在下拉框中选择一张已发布的维度表，定义该派生指标的统计维度。若该派生指标不需要按照维度统计，选择 全部(ALL)。

    • 周期：下拉选择指标的统计周期。

      • 当指标类型为多值指标时，某一设定时间段内的历史数据将按照所选的频率，以聚合函数进行统计计算，并返还多个值。例如，某一设备正在持续发送数据，且设置统计周期为 周，指标聚合函数为 SUM，此时若设置时间范围为 2022 年 12 月 1 日-2022 年 12 月 14 日，则系统会按 SUM 函数聚合 1 号-7 号的数据及 8 号-14 号的数据，并返还 2 个值。
      • 当指标类型为单值指标时，系统会根据聚合函数计算该周期内的数据，并返还一个值。例如，某一设备正在持续发送数据，且设置统计周期为 当日，指标聚合函数为 MAX，则当调用该指标时，系统会找出当日的最大数据并返还。


      以当天为 2022 年 6 月 23 日为例，对周期选项进行说明。

      周期 含义 示例
      当日 当天日期。 2022 年 6 月 23 日。
      当周 从每周一至当日。 2022 年 6 月 20 日 ~ 2022 年 6 月 23 日。
      当月 从每月 1 号至当日。 2022 年 6 月 1 日 ~ 2022 年 6 月 23 日。
      当月自然完整月 从每月 1 号至每月最后一天。（对于计划发电量、预测功率等指标，需要统计未来数据） 2022 年 6 月 1 日 ~ 2022 年 6 月 30 日。
      当年 从每年 1 月 1 号至当日。 2022 年 1 月 1 日 ~ 2022 年 6 月 23 日。
      当年自然完整年 从每年 1 月 1 号至每年最后一天。（对于计划发电量、预测功率等指标，需要统计未来数据） 2022 年 1 月 1 日 ~ 2022 年 12 月 31 日。
      全生命周期 从数据产生至今。 若 2019 年 6 月 1 日在系统中录入某数据，则该周期为 2019 年 6 月 1 日 ~ 2022 年 6 月 23 日。
      最新值 数据在最新的时间点的值。 只统计数据在当下时刻的最新值。


    • 指标聚合函数：自动生成关联原子指标所配置的聚合函数。

    • 单位：选择该派生指标的计算单位。

    • 数据类型：选择该派生指标的数据类型。

    • 派生指标 ID：自定义派生指标 ID，也可选择 自动生成 派生指标 ID。创建后不可修改。

    • 派生指标名称：自定义派生指标名称，也可选择 自动生成 派生指标名称。

    • 描述：输入对该派生指标的附加描述。

    • 属性：选择 添加属性，输入属性的键值对，为派生指标添加用于标记或区分的其他属性。例如：指标所属领域。

  3. 选择 发布，保存并发布派生指标。

    若暂时无需发布，选择 保存 为草稿。后续如需发布，参见 发布派生指标。


保存或发布完派生指标后，可以在 派生指标 标签页下的列表中查看。

编辑派生指标


  1. 选择左侧导航栏中的 指标中心，并选择 派生指标 标签页。
  2. 选择目标派生指标行末的 编辑 edit_icon，并在修改后进行保存或发布操作。

删除派生指标


如需删除派生指标，确保已提前删除该派生指标的查询映射配置分组。


  1. 选择左侧导航栏中的 指标中心，并选择 派生指标 标签页。
  2. 将鼠标悬浮于目标派生指标行末的省略号（…）上后，选择 删除 delete_icon。

发布派生指标


  1. 选择左侧导航栏中的 指标中心，并选择 派生指标 标签页。
  2. 可通过以下两种方式发布派生指标：
    • 选择目标派生指标行末的 发布 publish_icon。
    • 勾选多个需要发布的派生指标，选择页面上方的 发布 publish_2_icon，批量发布派生指标。

派生指标被发布后，才可在 查询映射配置 页面配置查询映射。

下线派生指标


如需下线派生指标，确保已提前删除该派生指标的查询映射配置分组。


  1. 选择左侧导航栏中的 指标中心，并选择 派生指标 标签页。
  2. 将鼠标悬浮于目标派生指标行末的省略号（…）上后，选择 下线 unpublish_icon，取消发布派生指标。

查看线上版本的派生指标


  1. 选择左侧导航栏中的 指标中心，并选择 派生指标 标签页。
  2. 将鼠标悬浮于状态为 修改待发布 的目标派生指标行末的省略号（…）上后，选择 查看线上版本 view_version_icon，查看前一次发布的派生指标。

恢复派生指标为线上版本


  1. 选择左侧导航栏中的 指标中心，并选择 派生指标 标签页。
  2. 将鼠标悬浮于状态为 修改待发布 的目标派生指标行末的省略号（…）上后，选择 恢复为线上版本 revert_version_icon，重新发布前一次的派生指标。

导出/导入派生指标


如需在不同 OU 之间进行派生指标的共享和迁移，可以进行导出/导入操作。


  1. 选择左侧导航栏中的 指标中心，并选择 派生指标 标签页。
  2. 勾选派生指标，选择 导出，导出一个 JSON 格式的文件作为模板。
  3. 选择 导入，导入本地的派生指标。


派生指标被导入成功后，将出现以下几种情况：

  • 若被导入的派生指标 ID 不属于当前指标列表，则在指标列表中将直接新增该衍生指标，且该指标将被自动发布，状态变更为 草稿。
  • 若被导入的派生指标 ID 已存在于当前指标列表中，且当前指标处于 草稿 状态或 下线 状态，则被导入的派生指标的字段值将直接覆盖列表中相同 ID 下的字段值，且该指标将被自动发布，状态变更为 草稿。
  • 若被导入的派生指标 ID 已存在于当前指标列表中，且当前指标处于 修改待发布 状态或 已发布 状态，则被导入的派生指标的字段值将覆盖列表中相同 ID 下除 指标类型 字段外的字段值，且该指标将被自动发布，状态变更为 草稿。

洞察派生指标


如需在指标洞察页面查看派生指标的值，确保已提前发布该派生指标。


  1. 选择左侧导航栏中的 指标中心，并选择 派生指标 标签页。
  2. 选择目标派生指标行末的 指标洞察 insight_icon，快速洞察派生指标 的值。