维度是人们观察事物的角度，是确定事物的多方位、多角度、多层次的条件和概念。本文为您介绍如何新建维度。

前提条件

完成创建数据域，详情请参见新建数据域。

背景信息

维度即进行数据统计的对象。通常情况下，维度是实际存在、不因事件发生而存在的实体，例如时间维度、地区维度、产品维度等。创建维度，即从顶层规范业务中实体（或称主数据）的存在性及唯一性。

新建维度的权限限制，详情请参见数据开发权限列表。

操作步骤

  1. 登录Dataphin控制台。
  2. 在Dataphin控制台页面，选择工作区地域后，单击进入Dataphin>>。
  3. 进入新建维度页面。
    1. 在Dataphin首页，单击顶部菜单栏中的研发。
    2. 在数据开发页面，按照下图操作指引，进入新建维度页面。
      q
  4. 在新建维度页面，配置参数。
    1. 配置维度基本信息区域参数。
      填写维度基本信息
      参数 描述
      数据域 选择该维度所属的数据域。
      说明 数据域的划分，详情请参见划分数据域。
      维度英文名 维度英文名由字母、数字或下划线（_）组合组成，且默认以dim_作为前缀。
      说明 维度英文名不能超过60个字符。
      维度名称 维度名称由汉字、字母、数字、下划线（_）或短划线（-）组合组成。
      说明 维度英文名不能超过64个字符。
      维度描述 填写对维度简单的描述。
    2. 配置维度逻辑信息区域参数。
      维度逻辑信息用于定义维度对象范围和对象特征，确保维度真实且唯一性存在。Dataphin为您提供四种维度类型，以满足不同维度对象建设需求。维度逻辑信息
      维度类型 描述
      普通维度 需定义主键及维度主从关系。普通维度创建完成并已成功发布后自动生成对应的维度逻辑表。
      普通维度（层级） 需定义主键、来源逻辑及层级，支持使用多个维度进行分析，不同维度之间存在稳定的层级关系。维度创建完成并已成功发布后自动生成一组有层级关联关系的维度逻辑表。
      枚举维度 需定义主键，支持列举及标准化枚举值以标识枚举维度对象。
      虚拟维度 需定义主键，支持没有具体业务实体承载、没有可固化数据范围逻辑定义的维度对象，也可以规范化业务建模。
      • 选择普通维度，配置参数信息如下。
        参数 描述
        主键英文名 主键英文名由字母、数字或下划线（_）组合组成。
        说明 主键英文名不能超过64个字符。
        主键名称 主键名称由汉字、数字、字母、下划线（_）或短划线（-）组合组成。
        说明 主键名称不能超过64个字符。
        主键类型 主键类型包括STRING、BIGINT、DOUBLE、DATETIME和DECIMAL。
        主键计算逻辑 填写维度主键计算逻辑：
        1. 在主键计算逻辑区域，编辑SQL代码，示例如下。
          select province from dataphin_test where ds='${bizdate}';

          您也可以单击主键计算逻辑后的参考示例，查看示例代码。

        2. 单击主键计算逻辑后的规范性校验，可以校验您编写的SQL代码是否符合规范。

          如果规范校验不通过，您可以单击格式化，系统自动调整SQL代码的格式。

        说明 SQL代码中需要限制时间分区条件，否则可能出现运维报错或数据错误。
        所属主维度 选择所属的主维度。如果选择是，则需单击主维度显示框，在下拉列表中选择所属的主维度。
      • 选择普通维度（层级），在配置向导页面，完成以下操作。
        1. 在主键&来源逻辑定义页签，配置参数。
          参数 描述
          主键英文名 主键英文名由字母、数字或下划线（_）组合组成。
          说明 主键英文名不能超过64个字符。
          主键名称 维度名称由汉字、字母、数字、下划线（_）或短划线（-）组合组成。
          说明 主键名称不能超过64个字符。
          主键类型 主键类型包括STRING、BIGINT、DOUBLE、DATETIME和DECIMAL。
          主表表名 选择主表。
          说明 建议您选择生产环境中的表。
        2. 单击下一步。
        3. 在层级定义页签，配置参数。
          参数 描述
          子层字段 选择层级字段中的子层字段。
          父层字段 选择层级字段中的父层字段。
          名称字段 选择名称字段。
          层级定义 填写层级的个数，系统支持最多9个层级。
          生成叶子维度 选择是否生成叶子维度：
          • 如果选择是，则系统会自动生成叶子维度。
          • 如果选择否，则需要您定义叶子维度的生成逻辑。
          层级根节点定义 基于来源主表字段，设定层级根节点（即无父层级）的判断条件：
          1. 在层级根节点定义区域，编辑SQL代码，示例如下。
            is_parent='true'

            您也可以单击参考示例，查看代码示例。

          2. 单击规范性校验，可以校验您编写SQL代码是否符合规范。

            如果规范校验不通过，您可以单击格式化，系统自动调整SQL代码的格式。

          时间分区逻辑 基于来源主表字段，设定数据更新及获取时间周期的判断条件：
          1. 在时间分区逻辑区域，编辑SQL代码，示例如下。
            ds=${bizdate}

            您也可以单击参考示例，查看代码示例。

          2. 单击规范性校验，可以校验您编写SQL代码是否符合规范。

            如果规范校验不通过，您可以单击格式化，系统自动调整SQL代码的格式。

      • 选择枚举维度，配置参数信息如下。
        在设置枚举信息的左侧区域中，填写枚举维度成员与对应成员的信息，并以英文逗号（,）隔开，示例如下。 
        F,女 
M,男
        在设置枚举信息的右侧区域，为您展示系统自动解析的code和value。
      • 选择虚拟维度，配置参数信息如下。
        参数 描述
        主键英文名 主键英文名由字母、数字或下划线（_）组合组成。
        说明 主键英文名不能超过64个字符。
        主键名称 维度名称由汉字、字母、数字、下划线（_）或短划线（-）组合组成。
        说明 主键名称不能超过64个字符。
        主键类型 主键类型包括STRING、BIGINT、DOUBLE、DATETIME和DECIMAL。
        说明 如果虚拟维度为维度逻辑表或事实逻辑表的关联维度，则虚拟维度可以作为派生指标的统计粒度。
  5. 在新建维度页面，单击页面右上角的图标，保存维度。
  6. 提交维度。
    1. 在新建维度页面，单击页面右上角的图标。
    2. 在提交备注页面，填写备注信息。
    3. 单击确定并提交，完成维度的提交。
    提交成功的普通维度和层级普通维度（层级），系统自动生成对应维度逻辑表和一组具有层级关联关系的维度逻辑表。
  7. 可选：发布维度。
    • 如果您的开发模式是Dev-Prod模式，则需要发布新建的维度，详情请参见发布任务。
    • 如果您的开发模式是Basic模式，则提交成功的维度，即可进入生产环境。