Skip to main content

实体管理

实体是一个独立的业务对象,可创建独立的标签体系,包含标签与群组,如人、书籍、门店可作为单独的实体对象。

实体创建

填写基础信息

步骤一:进入某项目,在实体管理页面点击「新增实体」按钮,填写实体名称、实体标识、实体标识、选择数据源主表及主键、添加辅表等。

  • 实体名称:支持中文、字母、数字、下划线,不超过64个字符;

  • 实体标识:实体的唯一标识(英文名称),项目内唯一,支持字母、数字、下划线,不超过64个字符;

  • 实体描述:实体对象描述,除空格外,不限制其余字符,不超过200个字符;

  • 选择数据源主表:需选择该项目对应数据库的某一张表,作为原子标签表,从此处接入。该张表一般是离线计算DWS的一张表,包含实体的基础属性。该表分为分区表与非分区表,若为分区表,需选择分区字段的格式。

  • 选择主键:需选择数据源主表的某字段作为实体的主键,如用户实体,主键为user_id,标识唯一用户;门店实体,主键为store_id,标识唯一门店。主键用于查找某一具体实例。

  • 选择辅表:可以选择该项目对应数据库下的多张表来加工衍生标签,辅表需要与主表保持同一主键,且不能选择已经与实体绑定的表。

    • 选择与主表关联键:从辅表的所有字段中选择一个与主表主键关联的字段,每张辅表都必须选择与主表关联键。
  • 关联任务:主表和辅表可以关联外部任务,以便进行任务依赖。目前支持关联「离线应用」的任务,选择外部任务后,标签系统的任务依赖关系将变化,变成新任务与标签大宽表任务的依赖。

    • 选择租户:单选,选择该集群内的租户
    • 选择项目:单选,选择所选租户和对应应用下的项目
    • 选择任务:单选,可选择所选项目内已提交的任务
tip

目前分区字段格式只支持日期格式,即分区字段必须为日期字段。

数据源主表和主键选择后,不支持修改。

设置维度信息

步骤二:设置维度信息。经过上一步,系统会读取主表辅表中的字段,填充该维度的中文名称、数据类型、是否为多值列

2022 03 10T02 533A40 864Z

  • 配置字典:可为主表维度配置映射字典或穷举字典,为辅表配置穷举字典,不同类型字典的用法可见字典管理
  • 字典的配置方式
    • 自定义:填写名称和内容自定义添加字典,系统将直接保存至字典管理菜单下
    • 引用:引用已在字典管理菜单下创建的字典
  • 选择原子标签:从主表中选择部分维度映射为原子标签
  • 标记多值列:此字段可有多个值同时存在,并用英文逗号“,”作为分隔符拆分,且只有字符型字段支持拆分。将该标签标记为多值标签后,可以基于拆分后的标签值进行圈群、画像分析、显著性分析等。

生成原子标签

步骤三:生成原子标签。预览标签值,设置标签的中文名、描述等信息。

此处对于数值型原子标签还可以设置标签数据的展示格式,支持展示成小数、百分数、千分数,并支持设置小数点后位数。标签、群组详情中的实例数据、下载数据以展示格式为准,标签值分布统计数据以实际值为准。

设置更新维度

步骤四:配置标签大宽表的更新周期,支持设置更新周期和更新优先级。

原子标签跟随此处设置的标签大宽表更新规则一同更新,无需另外配置;衍生标签、组合标签可在创建标签时设置更新周期。

  • 更新周期:支持天、周、月、小时、分钟更新,默认每天02:00更新

  • 更新时间:根据更新周期选择计划的具体更新时间,可参考更新周期

  • 更新优先级:可选1~10,数字越小,优先级越高;当底层资源不够时,系统会按照优先级顺序运行任务

  • 延迟实例:当选择“小时”或“分钟”更新周期时,会出现“延迟实例”自动取消的复选框。

    • 延迟实例自动取消的含义:如某分钟任务每隔10 分钟运行一次,1:00一条实例,1:10一条实例,若1:10时,1点的实例未运行完成,1点的实例自动取消,开始运行1:10的实例。
    tip

    选择延迟实例自动取消时,该任务的下游任务实例不受影响,不会自动取消。

实体创建成功后,可以在任务管理标签实例中查看到任务名为“${实体中文名}_标签大宽表更新”的更新任务。

实体详情

点击实体名称,可查看实体详情,包含以下信息:

  1. 基本信息 包含实体名称、实体ID、实体描述、数据源、数据表、数据源主键、数据量、创建人、创建时间、更新时间等信息。
  2. 数据维度 可查看实体对应源表的数据维度,包含维度名称、中文名、数据类型、是否多值列、是否关联原子标签等信息。
  3. 数据预览 默认展示数据源主表下最近20条数据,可看到部分实体的实例数据。

实体编辑

实体编辑与实体新建页面一致,可修改基础信息、标签更新周期。但是数据源主表和主键无法修改。

实体删除

tip
  1. 实体下的标签类目、标签、群组、群组的API都将被删除;
  2. 与(被删除的)实体绑定的关系将无法用来加工衍生标签,请谨慎操作。

实体授权

info

该功能仅旗舰版支持。

在实体详情页面中,点击右上角【授权】按钮给用户/用户组/角色授予当前实体的权限,包括查看、编辑权限,也可以将资源设置为【全员公开】可查看/可编辑,实现细粒度的权限控制。

实体权限具备的功能
可查看实体列表、实体详情,可在该实体下创建标签、导入数据、标签圈群、创建群组、分析群组(群组交并差/对比分析/画像分析/显著性分析)、搜索个体、设置行级权限/脱敏、创建API等能力
可编辑在查看权限的基础上,还具备该实体编辑、删除的能力

2022 03 10T02 533A40 864Z

tip
  1. 授权功能仅限实体创建人、租户所有者、租户管理员、项目所有者、项目管理员
  2. 实体默认全员公开,项目内所有人有查看权限;数据管理员、数据开发默认有编辑权限