原子指标

创建原子指标

1. 进入原子指标。
   1. 登录DataWorks控制台。
   2. 在左侧导航栏，单击工作空间列表。
   3. 选择工作空间所在地域后，单击相应工作空间后的数据开发。
   4. 单击左上方的图标，选择全部产品 > 数据建模 > 数据指标，在数据指标页面的左侧导航栏，单击原子指标，进入原子指标页面。
2. 创建原子指标。
   1. 在原子指标页面，单击图标新建原子指标。
3. 配置原子指标信息。
   1. 配置基本信息。
      

      参数	描述
      业务过程	原子指标所属的业务过程，用于明确需要统计分析的业务活动。
      英文缩写	原子指标的英文缩写，用于唯一标识该指标。创建后无法修改。
      英文名称	原子指标的英文名称。 建议使用原子指标所统计数值的英文，便于快速了解该指标的统计类型。
      中文名称	原子指标的中文名称。 建议使用原子指标所统计数值的中文，便于快速了解该指标的统计类型。
      业务口径	用于统一原子指标所统计的业务活动的统计口径，防止统计时产生歧义。 例如，下单实际支付金额的业务口径为用户下单生成订单后，通过支付渠道支付了订单金额的总和。该金额为扣除掉所有红包优惠后，用户实际支付的金额总和。
      描述	原子指标的描述信息。

   2. 配置计算逻辑。
      计算逻辑仅用于定义目标原子指标在后续使用时的计算方式及单位。在实际使用过程中，您需要根据此处定义的计算逻辑，编写计算代码，实现真实的计算操作。

      参数	描述
      指标来源	选择当前指标通过哪个明细表或维度表的度量字段进行计算。
      计算函数	选择当前指标计算时所使用的函数。
      小数位数	根据所选度量单位，确定小数位数。例如，统计支付金额时，度量单位为元，则小数位数为2。
      数据单位	基于原子指标的统计数据类型，选择合适的度量单位。例如，统计支付金额，则可选择货币单位。 说明 如果已创建的单位类型中没有适合业务使用的，则可进入度量单位页面创建，详情请参见度量单位。
      是否去重	根据业务需求判断统计时是否去重。例如，原子指标为会员数，则统计时需要去重，不能进行单纯的累加。

4. 单击保存，完成创建。
5. 单击提交，将当前版本的原子指标提交上线。提交成功的原子指标才可被模型和派生指标引用。
   说明

   • 仅支持提交已保存的原子指标。
   • 原子指标每次提交将生成一个新的版本，每个版本提交成功后不可再重复提交。

版本管理及关联表

在指标编辑页面的右侧导航栏，您还可管理指标版本或查看关联表。

操作项	说明
管理指标版本	用于查看指标的所有版本信息。同时，还可执行下表操作： 版本对比 比较所选版本的内容差异。当仅选择一个版本时，则是比较所选版本与当前已保存的指标内容间的差异。 说明 最多支持选择两个版本进行对比。 回滚 切换至所需的指标版本。切换后指标编辑页面的内容将被目标版本内容覆盖。 说明 回滚操作仅是将界面配置更新至所选回滚版本，如模型和派生指标想引用最新的配置内容，需再次执行保存、提交操作。
查看关联表	用于查看指标所关联的模型表字段。单击字段后的查看详情，即可进入模型表详情页查看更多表信息。

导入原子指标

如果您有大量原子指标待创建，则可以通过上传本地文件来批量导入原子指标。DataWorks为您提供了导入模板，您可按照模板表格填写好待导入的原子指标后上传文件，实现批量导入。

1. 进入原子指标页面，鼠标悬停至图标，单击Excel导入。
   进入原子指标页面可参考创建原子指标的相关步骤。
2. 在导入对话框中配置导入信息。
   
   1. 选择导入模式为跳过已存在的同名对象。
      当前仅支持使用跳过已存在的同名对象模式导入。
   2. 根据需求选择导入状态，原子指标导入成功后将按照您所选的状态执行保存或提交操作。
   3. 单击下载模板下载批量导入原子指标的模板表格。
   4. 在模板表格中，填写并保存待导入的各原子指标的业务过程、英文缩写、中文名称等信息。
      各参数的格式要求请参见创建原子指标。

      说明 下载模板表格后，如果一开始无法编辑表格，可单击表格顶部的启用编辑按钮。
   5. 单击选择文件，选择上述保存原子指标的模板后单击确定。
      后续您可以在导入结果的提示对话框中查看导入是否成功及导入详情。

导出原子指标

如果您有大量已创建的原子指标需要导出，则可使用批量导出功能。

1. 进入原子指标列表页面。
   双击原子指标页面左侧目录树的原子指标，即可进入原子指标列表。在该页面您可查看所有已创建的原子指标信息。
2. 选择待导出指标。
   说明 当使用导出全量方式导出全量指标时，无需执行该步骤。

   您可通过如下两种方式选择：

   • 搜索关键字：在搜索对话框输入关键字搜索所需指标。
     说明 搜索支持模糊匹配，即输入关键字后便会搜索出所有名称包含关键字的原子指标。
   • 直接选择：直接勾选所需指标。
3. 批量导出原子指标。
   您可根据需求通过如下三种方式导出：

   • 导出全量：导出当前工作空间下已创建的所有原子指标。
   • 导出已搜索：您需要先在搜索对话框输入关键字搜索所需指标。该方式会将所有匹配到的搜索结果导出。
   • 导出已选择：您需要先选择所需指标。该方式会将所有选择的指标导出。
4. 查看并下载导出结果。
   原子指标导出任务发起后，界面自动跳转至原子指标导出状态详情页，您可在该页面查看导出状态。导出成功后，单击下载文件即可下载原子指标至本地使用。

批量删除及提交

如果您存在多个废弃使用的原子指标，或已创建的多个原子指标未提交，则可进入原子指标列表批量删除或提交。

1. 进入原子指标列表页面。
   双击原子指标页面左侧目录树的原子指标，即可进入原子指标列表。在该页面您可查看所有已创建的原子指标信息。
2. 选择待批量操作的指标。
   说明 批量提交仅支持选择已保存且未提交的原子指标。
3. 根据业务需求选择批量删除或提交。
   • 批量删除：删除后的指标将无法再被模型和派生指标关联和引用。
     说明 若当前原子指标已被模型或派生指标关联引用，则需先删除引用关系后才可成功删除指标。
   • 批量提交：提交后的指标能够被模型和派生指标关联和引用，并且将生成最新的版本记录。指标版本说明，详情请参见版本管理及关联表。