Skip to main content

指标共享

「指标共享」功能主要是实现不同项目之间业务指标的共享互通，通过指标共享实现一键指标分享，从而减少指标的重复开发，提高指标的利用率，保证指标的业务一致性。

note

目前仅针对管理员层面的角色开放此功能，包括租户所有者、租户管理员、项目所有者。

共享流程​

share1

场景举例：

项目「浙江省」中，有一个「产品销售总额」指标，需要将指标的业务逻辑以及里头杭州部分的数据给「杭州」项目中的成员看到。

场景说明：

  1. 共享来源：「浙江省」项目即为共享来源，需要将这个项目下的指标共享出去
  2. 共享对象：指标「产品销售总额」
  3. 共享目标：「杭州」项目
  4. 共享规则：指标「产品销售总额」中杭州部分的销售总额数据

新增共享指标​

新增共享时，我们可以通过共享规则的制定，来控制指标共享的数据范围。

入口：【指标共享】-右上角【新增指标共享】进入新增页面，配置指标共享的共享规则：

基础设置：

  • 共享来源选择：选项范围为用户有权限的租户下的项目
  • 共享指标选择：基于选择的项目，选项范围为已发布的指标
  • 共享目标选择：选项范围为用户有权限的租户下的项目。其中，当选择了全部之后，如果新增或者删除了项目，也是实时去实现全部的项目共享

共享内容设置：

  • 可仅共享选中指标，也可同步共享其血缘上游指标、数据模型及维度对象。其中，若共享指标中包含原子指标，数据模型必须同步共享
  • 若选择了模型共享，系统目前支持表级别共享，即将对模型中的每个表单独进行共享，因此条件设置时需对每个表单独设置过滤条件

共享规则设置：

  • 设置方式：包括固定值和动态值两种规则设置方式，选择后，将同步作用于所有共享内容

    • 固定值
      1. 适用场景：所有共享目标获得的指标数据范围一致，看到的都一样；
      2. 配置方式：支持添加固定的共享条件，对不满足条件的指标结果进行过滤，保证共享目标看到的指标结果数据都是过滤后的；
    • 动态值
      1. 适用场景：所有共享目标获得的指标数据范围不一样，如杭州市的用户看到杭州市的数据，温州市的用户看到温州市的数据，他们的数据范围和自身自带的属性相匹配；
      2. 配置方式：选择「动态值」后，同样支持添加共享条件，只不过此时条件的右侧值域为项目的属性。

  • 公共维度共享规则设置：针对选中指标的公共维度进行条件批量设置，设置结果将作用于第二步对每个共享内容赋予默认值，最终的共享规则将以第二步设置内容为准。

  • 单个内容的共享条件设置：通过第二步的配置实现，其中，原子指标不需要单独设置规则，其规则通过设置数据模型实现。

note

此处规则设置方式，和「数据权限」模块类似，因为指标共享目前是跨项目的指标共享，所以支持根据项目的属性来动态设置规则

共享指标查询​

进入「指标共享」功能页面：

share2

  1. 共享目录：展示当前租户下所有的共享来源项目，点击名称，右侧列表中联动展示当前项目下，正在共享的指标；
  2. 共享列表
  • 列表内容：展示当前租户下所有正在共享的指标，包括指标名称，共享状态，共享版本等信息；
  • 共享版本：当前指标共享给其他项目所用的版本，默认实时更新最新版本，当指标更新状态异常时，系统会默认用最近一次正常的版本
  • 指标更新状态：包括正常和异常状态，当指标口径发生变化时，其共享视图不会做同步更新，此时的指标更新状态为异常，需重新提交一次指标共享信息，完成共享视图的更新后，指标更新状态即可变为正常
  • 共享状态：包括已完成、失败、进行中三个状态，括号中体现共享的目标总数和当前已经完成共享的数量。以下场景可能会产生共享失败的情况发生：
    • 共享对象中的项目不存在
    • 数据源集群不稳定
    • 数据源集群异常
note

关于更新状态，正常/异常的判断和「指标API」模块中的相同，当指标的技术口径发生变化（维度变更、过滤条件变更等），因为会直接影响到指标的计算逻辑和表结构，所以为了保证下游的正常运行，我们根据更新状态来判断。

此外，也可通过指标详情中的应用信息查询特定指标的共享情况。

共享指标使用​

所有共享成功的指标，在共享目标项目的「指标市场-共享市场」中均能看到，也可在指标中心的指标列表中看到（切换到共享指标即可）。

share4

如上图显示，在指标市场中，点击「共享市场」切换至共享指标市场：

  1. 共享目录：展示了当前所有共享指标的来源；
  2. 共享列表：展示了所有共享给当前项目的指标，包括指标名称、指标类型、指标目录、发布时间以及指标来源项目等基本信息
  3. 结果查询：点击获取指标的结果信息，这里的结果范围，是经过共享规则筛选后的指标结果；
  4. 指标详情：点击指标名称进入共享指标详情界面。

共享模型查询​

进入「指标共享」-「模型共享」功能页面：

整体内容呈现与指标共享相似，此处不做赘述

共享模型使用​

所有共享成功的模型，在共享目标项目的「指标中心」中的「数据模型」模块可以看到（切换到共享模型即可）。

共享的模型可通过复制功能生成自有模型，结合项目内自有表形成新的模型进行后续指标加工

共享维度查询​

进入「指标共享」-「维度共享」功能页面：

整体内容呈现与指标共享相似，此处不做赘述

共享维度使用​

所有共享成功的维度，在共享目标项目的「指标中心」中的「维度管理」模块可以看到（切换到共享模型即可）。

模型、自定义指标选择维度时，既可以选择自建维度内容，也可以选择共享维度内容，但不可对共享维度进行编辑、删除等操作。