原子指标是对指标统计口径、具体算法的抽象。Dataphin创新性地提出了设计即开发的理念,指标定义同时也明确了设计统计口径(即计算逻辑),提升了研发效率,并保证了统计结果的一致性。

根据计算逻辑的差异性,Dataphin将原子指标分为2种:
  • 原生的原子指标,例如支付金额。
  • 衍生原子指标,基于原子指标组合构建,例如客单价为支付金额除以买家数。

新建原子指标

  1. 登录Dataphin。
  2. 在Dataphin首页,选择研发 > 开发 > 规范建模 > 原子指标,进入原子指标页面。
  3. 您可以通过以下4中方式中的任何1种方式进入新建原子指标
    • 单击项目名称后的,选择规范定义 > 原子指标,进入新建原子指标页面。
    • 单击原子指标,然后单击新建原子指标,进入新建原子指标页面。
    • 单击原子指标下的,然后单击新建原子指标,进入新建原子指标页面。
    • 单击页面左下角的原子指标对象列表,进入对象列表页原子指标页面,单击页面右上的新建原子指标然后,然后单击原子指标,进入新建原子指标页面。
  4. 新建原子指标页面,根据页面提示选择数据域来源表
    参数 说明
    数据域 根据原子指标来源表所属的业务过程,选择汇总该业务过程所在的数据域。
    说明 数据域的划分请参见划分数据域
    来源表 选择原子指标计算逻辑中,所用字段的来源表。为保证规范建模过程中,建设过程标准规范,来源表仅支持维度逻辑表、事实逻辑表。
    说明 选择来源表之后,页面会展示该来源表下已有的原子指标列表。
  5. 新建原子指标页面,单击新建原子指标,进入新建原子指标,完成参数配置后单击提交
    参数 说明
    主要来源字段 基于所选来源表,选择事实表或维度表中的字段。
    英文名 基于所选主要来源字段,英文名自动填充为字段名。您也可以根据需要修改英文名。
    名称 填写名称。名称由汉字、字母、数字、下划线或-组合组成。
    描述 对原子指标的简单描述。
    数据类型 选择数据类型。类型包括:STRINGBIGINTDOUBLEDATETIME
    字段 选择统计周期所限制的字段,默认选择所属业务板块设置的时间分区字段。
    格式类型 统计周期绑定的字段,在计算时使用的格式类型。
    计算逻辑 定义基于来源逻辑表模型定义所需指标的SQL计算表达式,例如count(distinct order_id),其中order_id 为来源逻辑表模型中的字段。
    说明
    1. 单击主键计算逻辑后面的参考示例,可以查看SQL编写示例。
    2. SQL编写完成后,单击主键计算逻辑后面的规范性校验,可以校验您编写的SQL是否符合规范。
  6. 提交成功后,完成原子指标的新建。发布新建的原子指标,请参见发布管理
说明 Basic模式下的Basic项目和Dev-Prod模式下的Dev项目均可以直接新建原子指标。在开发环境中的Dev项目新建、提交、发布原子指标成功后,生产环境中的Prod项目才会新增该原子指标。

新建衍生原子指标

基于已提交的原子指标进行引用,设定组装逻辑,生成衍生原子指标。例如,其中一个已提交的原子指标为下单金额,另一个已提交的原子指标为下单人数,您可以通过新建衍生原子指标的方式统计人均下单金额:
  1. 请参见新建原子指标新建衍生原子指标页面。
  2. 根据页面提示完成参数的配置,并单击提交
    参数 说明
    英文名 填写英文名。英文名由字母、数字、下划线组合组成。
    名称 填写名称。名称由汉字、字母、数字、下划线或-组合组成。
    描述 对衍生指标的简单描述。
    数据类型 选择数据类型。类型包括:STRINGBIGINTDOUBLEDATETIME
    计算逻辑 基于已提交原子指标,组合设定所需指标的统计计算方式:
    • 在SQL语句输入框中输入衍生指标的计算公式,其中计算公式中引用的原子指标均为已提交的原子指标。
      1. 单击引用原子指标,选择数据域来源表
      2. 单击筛选出来的原子指标后的添加,将原子指标添加在右侧的SQL语句输入框中。

      或在后输入原子指标关键字进行快速搜索,单击搜索出来的原子指标后的添加,将原子指标添加在右侧的SQL语句输入框中。

    例如,计算人均下单金额crt_amt/usr_cnt,其中crt_amt为下单金额对应的已提交原子指标,usr_cnt为用户数对应的已提交原子指标。

  3. 提交成功后,完成衍生原子指标的新建。发布新建的衍生原子指标,请参见发布管理
说明 Basic模式下的Basic项目和Dev-Prod模式下的Dev项目均可以直接新建衍生原子指标。在开发环境中的Dev项目新建、提交、发布衍生原子指标成功后,生产环境中Prod项目才会新增该衍生原子指标。