管理维度配置


在维度表页面的维度配置标签页中为定义好的维度表配置数据,并可对维度配置进行编辑、发布等操作。

前提条件


开始之前,请确保以下事项:

  • 当前账号已被分配包含 维度表 在内的菜单组。如未分配,联系应用管理员。
  • 在维度定义中配置了数据连接类型,且已发布维度表的维度定义。
  • 若选择 从数据库同步从数据库映射 的方式作为维度属性数据 配置方式,确保已在数据源下创建数据表。

新建维度配置


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。
  2. 选择 新建,在弹窗中输入以下信息:
    • 选择维度:选择已经发布过维度定义且配置了数据连接类型的一张维度表。
    • 选择配置方式:选择一种方式为维度表中的属性配置数据。
      • 从数据资产目录同步:从数据资产目录中同步主数据对象,并将主数据对象的属性值配置给维度表中的属性。
      • 手动导入:下载模板,在模板中填写维度属性和属性值后上传。
      • 从数据库同步:通过同步的方式,将数据库中数据表的属性值配置给维度表中的属性。
      • 从数据库映射:通过映射的方式,将数据库中数据表的属性值配置给维度表中的属性。

从数据资产目录同步


  1. 选择 从数据资产目录同步 作为配置方式。

  2. 数据源配置 页面中输入以下信息后,选择 下一步

    • 对象类型:选择数据资产目录中的一个或多个主数据对象类型。还可选择 属性筛选 attri_filter_icon,添加和设置对象属性过滤条件,过滤对象类型。参见数据资产目录中的 主数据详情对象属性过滤,了解更多信息。
    • 标签筛选:在下拉框中选择标签组下的标签作为过滤条件。参见数据资产目录中的 标签过滤,了解更多信息。
  3. 映射配置 页面的 数据源属性 下拉框中选择主数据对象类型的属性,建立主数据对象类型的字段与维度属性的映射关系。不同的维度属性可以映射相同的数据表字段。选择 下一步

  4. 同步周期 配置页面输入以下信息后,选择 下一步


    同步类型 含义 所需操作
    周期同步 数据源中的数据根据周期,定时、自动进行全量同步。 可选择周期同步的 生效日期
    具体时间 中根据页面上 Crontab 语法规则 提示,输入同步周期。例如,希望设置同步周期为“每个周一的 12:00 进行同步”,则可以输入 Crontab 语法 00 12 *  *  1
    手动同步 完成维度配置后,默认自动触发一次全量同步。 可在 生效日期 栏中设置下一次触发全量同步的日期。

    注解

    同步任务每触发一次,就会在 任务运维 页面中生成一个维度任务实例。


  5. 预览 页面确认完维度配置后,选择 发布 保存并发布维度配置。

    若暂时无需发布,可选择 保存 为草稿。后续如需发布,参见 发布维度配置


发布维度配置后,与该维度表相连的数据库中会生成一张当前的维度表。

手动导入


  1. 选择 手动导入 作为配置方式。选择 下载数据模板
  2. 在模板中填写所选维度表中定义的属性字段和属性值。
  3. 选择更新方式为 增量更新全量更新
  4. 选择 发布


发布维度配置后,与该维度表相连的数据库中会生成一张当前的维度表。

从数据库同步


  1. 选择 从数据库同步 作为配置方式,在 数据源配置 页面中输入以下信息:

    • 来源表
      • 选择 选择数据表:从维度定义中配置的数据源下的数据表中引入字段。
      • 选择 通过 SQL 自定义:输入 SQL 语句自定义字段。
    • 表名:选择数据源下已创建的一张数据表。
    • SQL:输入自定义 SQL 语句,查询数据库中的一张数据表作为维度表的数据来源。
  2. 映射配置 页面的 数据源属性 下拉框中选择数据表中的字段,建立数据表的字段与维度属性间的映射关系。不同的维度属性可以映射相同的数据表字段。选择 下一步

  3. 同步周期 配置页面输入以下信息后,选择 下一步


    同步类型 含义 所需操作
    周期同步 数据源中的数据根据周期,定时、自动进行全量同步。 可选择周期同步的 生效日期
    具体时间 中根据页面上 Crontab 语法规则 提示,输入同步周期。例如,希望设置同步周期为“每个周一的 12:00 进行同步”,则可以输入 Crontab 语法 00 12 *  *  1
    手动同步 完成维度配置后,默认自动触发一次全量同步。 可在 生效日期 栏中设置下一次触发全量同步的日期。

    注解

    同步任务每触发一次,就会在 任务运维 页面中生成一个维度任务实例。


  4. 预览 页面确认完维度配置后,选择 发布 保存并发布维度配置。

    若暂时无需发布,可选择 保存 为草稿。后续如需发布,参见 发布维度配置


发布维度配置后,与该维度表相连的数据库中会生成一张当前的维度表。

从数据库映射


  1. 选择 从数据库映射 作为配置方式,在 数据源配置 页面中输入以下信息:

    • 来源表
      • 选择数据表:选择在维度定义中配置的数据源下的一张数据表作为数据来源。
      • 通过 SQL 自定义:输入 SQL 语句自定义字段。
    • 表名:选择数据源下已创建的一张数据表。
    • SQL:输入自定义 SQL 语句,查询数据库中的一张数据表作为维度表的数据来源。
  2. 映射配置 页面的 数据源属性 下拉框中选择数据表中的字段,建立数据表的字段与维度属性间的映射关系。不同的维度属性可以映射相同的数据表字段。选择 下一步

  3. 预览 页面确认完维度配置后,选择 发布 保存并发布维度配置。

    若暂时无需发布,可选择 保存 为草稿。后续如需发布,参见 发布维度配置

编辑维度配置


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。
  2. 将鼠标悬浮于目标维度表行末的省略号(…)上后,选择 编辑 edit_icon,并在修改后进行保存或发布操作。

删除维度配置


如需删除维度配置,确保已提前删除与该维度配置关联的事实表、派生指标或查询映射配置分组。


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。

  2. 将鼠标悬浮于目标维度表行末的省略号(…)上后,选择 删除 delete_icon

发布维度配置


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。
  2. 可通过以下两种方式发布维度配置:
    • 选择目标维度表行末的 发布 publish_icon
    • 勾选多个需要发布的维度表,选择页面上方的 发布 publish_2_icon,批量发布维度配置。

维度配置被发布后,才可在 事实表定义 页面关联事实表。

下线维度配置


如需下线维度配置,确保已提前删除与该维度配置关联的事实表、派生指标或查询映射配置分组。


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。
  2. 选择目标维度表行末的 下线 unpublish_icon,取消发布该维度配置。

预览维度配置


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。
  2. 选择目标维度表行末的 数据预览 preview_icon,查看已发布的维度配置。

查看线上版本的维度配置


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。
  2. 将鼠标悬浮于状态为 修改待发布 的目标维度表行末的省略号(…)上后,选择 查看线上版本 view_version_icon,查看前一次发布的维度配置。

恢复维度配置为线上版本


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。
  2. 将鼠标悬浮于状态为 修改待发布 的目标维度表行末的省略号(…)上后,选择 恢复为线上版本 revert_version_icon,重新发布前一次的维度配置。

导出/导入维度配置


如需在不同 OU 之间进行维度配置的共享和迁移,可以进行导出/导入操作。


  1. 选择左侧导航栏中的 维度表,选择 维度配置 标签页。
  2. 勾选已发布的维度表,选择 导出,导出一个 JSON 格式的文件作为模板。
  3. 选择 导入配置,导入本地的维度配置文件。