管理维度定义


在维度表页面的维度定义标签页中新建维度定义，并可对维度定义进行编辑、发布等操作。

前提条件


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

  • 当前账号已被分配包含 维度表 在内的菜单组。如未分配，联系应用管理员。
  • 当选择 数据源注册 作为数据连接类型，需确保已在 数据源注册 中完成数据源信息的配置。

新建维度定义


  1. 选择左侧导航栏中的 维度表，默认进入 维度定义 标签页。

  2. 在 维度定义 标签页中，选择 新建，进入 新建维度 页面。

  3. 输入以下 基本信息：

    • 维度 ID：输入维度表在当前 OU 下的唯一 ID。
    • 维度名称：输入维度表的名称。
    • 数据连接类型：选择 数据源注册 或 无。
      • 选择 数据源注册，并选择数据源类型和数据源名称，定义维度表存放的位置及维度表中的数据来源。
      • 选择 无，后续可通过调用 Open API 来为维度表中的属性配置数据。
    • 数据源选择：选择数据源类型及注册在该类型下的数据源名称。
    • 描述：输入维度表的相关描述。

  4. 输入以下 维度逻辑信息：

    • 维度属性：为维度配置属性。例如，地理维度里的国家名称、国家 ID、省份名称等都属于维度属性。其中 guid 为每次创建维度表时会自动显示的一个属性。可以选择复制按钮 duplicate_icon 或选择 添加 来增添属性。


    字段 描述
    属性 ID 自定义的属性 ID 在当前维度表中唯一，此处的属性可以理解为维度表的表头，且必须以小写字母开头。
    描述 输入对属性的描述，帮助识别与理解。
    数据类型 属性值的类型。
    主键 主键不含有业务含义，主键值不能为空，不可重复。被设置为主键的属性的数据类型通常为 STRING。此处的主键可以理解为维度表的第一列，并能关联事实表的外键。例如，在设备维度表中，设备 ID 作为主键，通过设备 ID 能够定位到某一设备的所有设备属性数据。在相应事实表中，也存在一个设备 ID，通过设备 ID 能够将事实表与维度表关联起来。
    不为空 若此处属性设置不为空，则在配置数据映射时该属性值不可以为空，否则将会影响指标查询。


    • 维度层级：维度表中的多个属性有时会以层级方式互相关联。若维度间存在层级关系，可选择 添加，在弹窗中填写维度层级并添加，后续可根据维度层级进行指标数据的聚合与下钻。
      • 层级 ID：输入层级 ID。在当前维度表中需具有唯一性。
      • 层级名称：输入层级名称。
      • 层级类型：选择一种层级类型。层级类型的解释如下表所示。


    层级类型 含义 示例 相关操作
    通用层级 数据可分为多级，呈现树形结构。该类层级一般用于层级数量较为固定的数据。 例如某风机集团的层级，如下图 1 所示。 选择已添加的维度属性作为层级的 ID 和 名称。
    可通过拖拽层级的方式调整层级顺序。
    父子层级 数据分为 2 级，两个层级之间存在父子关系。通过父层字段和子层字段能够将两个层级关联起来。该类层级一般用于层级数量不固定的数据。例如，一般可将地理维度划分为“国家-省份-城市-县/行政区”，但对于上海而言，作为直辖市，没有“省份”这一层级。因此，为了避免使用通用层级后某些数据无法按照固定的层级对齐，可以使用父子层级划分数据。 例如，针对地理维度，可设置以下维度属性：ID、名称、父节点 ID。通过父节点 ID 可定位到父层级。生成的维度表如图 2 所示。 输入 父层字段 和 子层字段 的 ID 和名称。


    图 1：

    ../_images/standard_hierarchy.png


    图 2：

    ../_images/parent_hierarchy.png

    注解

    同一个属性 ID 可以在当前维度的不同的维度层级结构中重复使用。


    • 附加属性：为维度表添加附加信息，该信息与维度属性无关，并不会存放在维度表中。例如：维度表的创建者、维度表创建时间、维度表所属领域。

  5. 选择 发布，保存并发布维度定义。

    若暂时无需发布，可选择 保存 为草稿。后续如需发布，参见 发布维度定义。


保存或发布完当前维度表的维度定义后，可以在维度定义标签页的列表中查看。

编辑维度定义


  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，重新发布前一次的维度定义。