管理维度定义¶

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

前提条件¶

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

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

新建维度定义¶

选择左侧导航栏中的 维度表，默认进入 维度定义 标签页。
在 维度定义 标签页中，选择新建，进入 新建维度 页面。
输入以下 基本信息：
- 维度 ID：输入维度表在当前 OU 下的唯一 ID。
- 维度名称：输入维度表的名称。
- 数据连接类型：选择 数据源注册 或 无。
  - 选择 数据源注册，并选择数据源类型和数据源名称，定义维度表存放的位置及维度表中的数据来源。
  - 选择 无，后续可通过调用 Open API 来为维度表中的属性配置数据。
- 数据源选择：选择数据源类型及注册在该类型下的数据源名称。
- 描述：输入维度表的相关描述。

输入以下 维度逻辑信息：

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

字段	描述
属性 ID	自定义的属性 ID 在当前维度表中唯一，此处的属性可以理解为维度表的表头，且必须以小写字母开头。
描述	输入对属性的描述，帮助识别与理解。
数据类型	属性值的类型。
主键	主键不含有业务含义，主键值不能为空。被设置为主键的属性的数据类型通常为 `STRING`。从 0 开始按序设置一个或多个属性作为主键，且不可重复。顺序为 0 的主键可以理解为维度表的第一列，主键均可关联事实表的外键。例如，在设备维度表中，设备 ID 作为主键，通过设备 ID 能够定位到某一设备的所有设备属性数据。在相应事实表中，也存在一个设备 ID，通过设备 ID 能够将事实表与维度表关联起来。
主键名称	主键名称即为主键的显示名称，与含有相同序号的主键联合使用，方便通过多个属性快速定位所要查询的数据。例如，某一设备在当前 OU 下唯一，而多个 OU 的设备数据被纳入了同一张维度表，此时可通过主键“OU ID”和主键名称“设备 ID”共同定位目标设备。在一个维度表中可设置多个主键和与之对应的多个主键名称，主键名称数量必须小于等于主键数量。例如，设置属性 `countryid 0`，`provinceid 1`，`cityid 2` 作为主键，此时可设置属性 `provincename 1`，`cityname 2` 作为 `provinceid 1` 和 `cityid 2` 的主键名称。
不为空	若此处属性设置不为空，则在配置数据映射时该属性值不可以为空，否则将会影响指标查询。

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

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