You need to enable JavaScript to run this app.
导航
配置并发布模型
最近更新时间:2024.07.03 17:40:16首次发布时间:2024.04.30 15:22:22

创建模型后,您可以在模型的基础上关联维度和定义的指标。其中,对于统计指标的物理实现,目前提供以下两种构建方式:

  • 根据主数据源的字段或自定义字段直接构建指标,例如活跃设备数。
  • 根据该模型已有的指标,指标间进行四则运算构建新的指标,例如:新增设备次日留存率=新增设备次日留存/新增设备数。

1 约束限制

  • 仅业务线管理员或指标管理员具备操作权限。
  • 仅开启数据查询的模型才支持发布。目前仅 LAS-Hive 数据源类型的模型不支持发布。

2 前提条件

  • 已创建模型。
  • 已创建所需的指标定义,才可配置指标。

3 配置并发布模型

  1. 登录 DataLeap 控制台,进入指标平台
  2. 在页面右上角的业务线下拉列表中,选择要管理的业务线。
  3. 选择指标管理 > 模型管理,进入模型管理页面。
  4. 单击模型目录中要编辑的模型,进入该模型详情信息显示页面。
    图片
  5. 可查看模型详情信息并执行以下操作完善模型配置。
    • 配置维度
    • 配置指标
    • 配置业务限定
  6. 单击发布按钮,在弹出窗口中,填写发布说明信息后,单击确定按钮,发布物化模型,并使配置信息生效。此时,单击已发布指标的名称,可查看该指标对应的物理实现详情。

说明

  • 模型发布物化后,才可在物化信息页签查看物化信息和物化记录。
  • 新增、编辑或删除指标/维度配置信息后,重新发布模型才能生效。

4.1 配置维度

  1. 单击模型详情页面的指标/维度页签,进入指标/维度信息配置页面。

  2. 单击新建维度按钮,弹出新建维度窗口。
    图片

  3. 可通过以下方式,将所选字段填充在待创建维度列表中。

    • 单击左侧主表字段名称所在行的添加图标按钮。

      说明

      • 可快速筛选已配置和未配置过维度的字段,还可输入字段名或字段描述关键词快速搜索符合条件的字段。
      • 在当前模型上已经配置过维度的字段右侧将带有蓝色圆形提示。
    • 单击一键推荐按钮,在弹出的推荐窗口中,系统根据主表字段和已有维度英文名匹配,推荐检测到的维度,单击确定按钮。

      说明

      模型上已配置的维度将不做二次推荐。

    • 单击 +自定义SQL 按钮,可自定义维度名称、英文名以及维度计算逻辑。
  4. 可按需编辑维度信息后,单击确定按钮,完成维度创建。
    新建维度相关参数说明如下表所示。

    参数

    说明

    *维度名称

    新建维度的名称,自行设定,同一业务线下具有唯一性。

    说明

    系统会推荐业务线下模型上已存在的维度名称,为了名称的统一规范,请尽量和已存在的相似维度名保持一致。

    *维度英文名

    新建维度的英文名称,同一业务线下具有唯一性。
    仅可由英文、数字或下划线组成。

    说明

    模型管理以及指标应用/服务将统一使用该名称获取维度。

    关联维度

    该模型关联的维度,下拉可选已创建的维度。

    说明

    若选择关联已创建的维度,则维度名称维度英文名描述字段自动填充为该关联维度的信息。

    字段

    创建维度的字段名称。
    当选择主表字段时,该参数直接显示主表字段名称,不可编辑。

    *数据类型

    维度的数据类型,支持VARCHAR、BIGINT、DOUBLE 和 DATE四个类型选项。

    *计算逻辑

    计算逻辑为来源字段。
    如果关联了实体/码值维度,则该计算逻辑为主表外键字段。

    cube默认值

    该维度的cube默认值。
    设置默认值后,配置Cube时才可选择相应的关联维度。

    支持范围

    维度在模型内支持的维度值范围。

    描述

    数据模型维度的详细描述信息。

    主键

    维度枚举值的唯一标识字段,一般为id或者码值。
    若为复合主键,则可选择多个字段。相同主键(粒度)的数据默认汇总展示在数据集市。

  5. 对已创建的维度,还可执行以下管理操作:

    • 单击维度列表中某条信息操作列的查看图标,可以查看该维度详情信息。
    • 单击维度列表中某条信息操作列的编辑图标,可以修改该维度的配置信息。
    • 单击维度列表中某条信息操作列的删除图标,弹出确认删除维度对话框,确认后可以删除该维度。

4.2 配置指标

  1. 单击模型详情页面的指标/维度页签,进入指标/维度信息配置页面。

  2. 可选择以下任一方式,完成模型指标创建。

    • 根据字段直接新建

      1. 单击新建指标 > 根据字段直接新建按钮,弹出新建指标窗口。

      2. 可通过以下方式,将所选字段填充在待创建指标列表中。

        • 单击左侧主表字段名称所在行的添加图标按钮。

          说明

          • 可快速筛选已配置和未配置过指标的字段,还可输入字段名或字段描述关键词快速搜索符合条件的字段。
          • 在当前模型上已经配置过维度的字段右侧将带有蓝色圆形提示。
        • 单击筛选按钮旁的一键配置所有字段图标。
          图片
        • 单击一键推荐按钮,在弹出的推荐窗口中,系统根据主表字段和已有衍生指标英文名匹配,推荐检测到的指标,单击确定按钮。

          说明

          模型上已配置的指标将不做二次推荐。

        • 单击 +自定义SQL 按钮,可自定义指标定义和计算逻辑。
      3. 设置指标信息后,单击确定按钮,完成模型指标创建。

        说明

        通过字段操作列的设置图标,可进一步配置该指标的业务信息、技术信息等。

        新建指标相关参数说明如下表所示。

        参数

        说明

        *指标定义

        业务线下已有的指标定义关联,下拉可选。
        仅可关联当前业务线下状态为生效中的指标。

        *计算逻辑

        指标的计算逻辑。下拉可选,支持求和、计数和去重计数三个选项;还可通过单击 </> 写自定义SQL。

        说明

        计算逻辑需与所选字段的类型相匹配。

        *查数偏移

        查询数据时查询日期偏移时间分区的量,支持多个选项,下拉可选。
        例如查指标9月1日数据,若查数偏移为${date + 0},则查询9月1日分区;若偏移为${date + 1},则查9月2日分区。

        说明

        该设置项仅针对个别留存类型指标。

        更多配置- 业务信息

        *级别

        指标级别,支持以下三个选项:

        • D1(公司级指标),支撑公司战略决策,需要在公司范围内统一:例如日活、新增、留存等。
        • D2(业务级核心指标),支持业务决策和拆分D1级指标:例如直播时长、直播观看人数、搜索次数等。
        • D3(其他分析型指标),灵活,常用于分析和辅助业务发展:例如签约主播直播时长、主动搜索次数等。

        单位

        指标的单位,如个、元、条等,按需自行设定。

        指标评价

        该指标的评价,支持正向和负向两个选项。

        • 正向:代表向上或向前发展、增长的指标,值越大评价就越好。
        • 负向:指数值越小越好。

        更多配置- 技术信息

        *产出时间

        数据产出时间,下拉可选,支持 T+n、实时等多个选项,其中 T 表示业务日期。例如:一般次日留存数据产出时间是T+2,七日留存数据产出时间是T+8。

        *日期累加

        支持全累加和不可累加两个选项。

        • 全累加:表示指标在各个维度上都可累加。
        • 不可累加:表示指标只在“日期”维度上不可累加。

        *指标数据类型

        指标采用的数据类型,支持 bigint、double 和 string 三个选项。

        说明

        数据类型需与所选字段的类型相匹配。

        *小数点位数

        可选择保留几位小数,下拉可选。

        优先级

        定义指标查询模型优先级,下拉可选,其中P0为最高优先级。

        更多配置- 高级属性

        字段属性名称

        按需以 K-V 模式进行配置,即设置字段属性名称和对应的字段值

        字段值

        按需以 K-V 模式进行配置,即设置字段属性名称和对应的字段值

    • 根据已有指标组合构建

      1. 单击新建指标 > 根据已有指标组合构建按钮,弹出新建指标窗口。
      2. 单击添加组合指标按钮,新增一条构建指标。
        图片
      3. 设置指标信息后,单击确定按钮,完成指标创建。

        说明

        通过指标操作列的更多配置按钮,可进一步配置该指标更多信息。

      新建指标相关参数说明如下表所示。

      参数

      说明

      *构建逻辑

      仅支持选择当前模型上的非四则运算指标,组成构建逻辑。

      指标定义

      选择一个指标关联,当前计算逻辑将成为关联指标的一个物理实现。
      仅可关联当前业务线下状态为生效中的指标。

      *负责人

      模型指标负责人。
      默认为当前用户,下拉可选当前租户下所有账号,支持选择多个。

      更多配置- 业务信息

      *级别

      指标级别,支持以下三个选项:

      • D1(公司级指标),支撑公司战略决策,需要在公司范围内统一:例如日活、新增、留存等。
      • D2(业务级核心指标),支持业务决策和拆分D1级指标:例如直播时长、直播观看人数、搜索次数等。
      • D3(其他分析型指标),灵活,常用于分析和辅助业务发展:例如签约主播直播时长、主动搜索次数等。

      单位

      指标的单位,如个、元、条等,按需自行设定。

      指标评价

      该指标的评价,支持正向和负向两个选项。

      • 正向:代表向上或向前发展、增长的指标,值越大评价就越好。
      • 负向:指数值越小越好。

      更多配置- 技术信息

      *数据类型

      指标采用的数据类型,支持 BIGINT、DOUBLE 两个选项。

      *小数点位数

      指标显示的小数点位数,下拉可选。
      数据类型DOUBLE 时,需设置该参数。

      说明

      该设置仅对预览生效。

      更多配置- 高级属性

      字段属性名称

      按需以 K-V 模式进行配置,即设置字段属性名称和对应的字段值

      字段值

      按需以 K-V 模式进行配置,即设置字段属性名称和对应的字段值

    说明

    • 创建指标后,会自动生成 api查询码,您可通过该参数获取指标数据。
    • 通过指标详情页或指标物理实现详情页,可查看 api查询码。
  3. 对已创建的指标,还可执行以下管理操作:

    • 单击指标列表中某条信息操作列的查看图标,可以查看该指标详情信息,包括api查询码。
    • 单击指标列表中某条信息操作列的编辑图标,可以修改该指标的配置信息。
    • 单击指标列表中某条信息操作列的删除图标,弹出确认删除指标对话框,确认后可以删除该指标。

      注意

      • 删除指标可能会影响下游服务使用,请谨慎删除,可前往指标详情页查看指标最近使用情况。
      • 在确认删除指标对话框的指标列表中,将同时展示依赖于当前指标构建的其他指标。删除当前指标后,会同时删除列表中的关联指标,建议先联系负责人解除依赖。
    • 单击批量及下载 > 下载关联指标按钮,可以批量下载已关联的指标文件。
    • 勾选一条或多条信息,单击批量及下载 > 批量删除按钮,可以完成批量删除。
    • 单击查看SQL按钮,可以查看当前模型已发布的维度/指标整体的取数逻辑。

4.3 配置业务限定

  1. 单击模型详情页面的业务限定页签,进入业务限定信息配置页面。

  2. 单击新增业务限定按钮,弹出新建维度窗口。
    图片

  3. 设置业务限定信息后,单击确定按钮,完成信息配置。
    新增业务限定相关参数说明如下表所示。

    参数

    说明

    *业务限定名称

    新建业务限定的名称,自行设定。

    说明

    相同限定类型的业务限定名称不可重复。

    *业务限定英文名

    新建业务限定的英文名称,自行设定。

    说明

    相同限定类型的业务限定名称不可重复。

    *限定类型

    业务限定的数据类型,支持手动输入或下拉选择,仅支持设置一个类型。

    *计算逻辑

    业务限定的计算逻辑,按需输入自定义SQL。

    描述

    数据模型业务限定的详细描述信息。

  4. 单击列表中某条信息操作列的编辑图标,还可修改已创建的业务限定信息。

说明

业务限定仅作为过滤条件,根据已有指标衍生构建其他指标。衍生构建其他指标的相关操作说明可参见 4.2 配置指标

4.4 查看模型字段

  1. 单击模型详情页面的模型字段页签,进入模型字段页面。
    图片
  2. 可以查看模型下所包含的字段信息。

说明

暂时不支持新增/编辑其他数据源字段。

4.5 Cube配置

当模型参数是否为cube选择cube时,才支持该功能配置。

  1. 单击模型详情页面的Cube配置页签,进入Cube配置页面。
    图片
  2. 可执行以下操作:
    • 单击新建Cube配置按钮,在弹出的窗口中,设置相关信息后,单击确定按钮完成配置。

      参数

      说明

      *cube类型

      主表数据的cube类型,提供全cube 和自定义cube 两个选项,根据实际情况选择。

      • 全cube:模型所有维度都支持上卷,默认cube维度值为all
      • 自定义cube:部分维度支持上卷或cube维度值不一致,创建模型后,配置维度时自定义填写cube信息。

      关联维度(默认值)

      查询时该维度使用的默认值,下拉可选已设置cube默认值的关联维度。

      说明

      关联维度后,才可配置cube,否则新建按钮灰显,不可配置。关联维度操作说明请参见4.1 配置维度

    • 单击某条信息操作列的预览按钮,可以预览该配置信息。

    • 单击配置预览按钮,可以展示当前模型下所有Cube配置去重结果。

    • 单击某条信息操作列的编辑按钮,可以修改该配置。

    • 单击某条信息操作列的删除按钮,二次确认后,可以删除该配置信息。删除后,Cube组合将不可恢复,删除已发布的Cube将影响模型查询结果。

4.6 模型同步

暂不支持数据集同步。