实体管理
实体是一个独立的业务对象,可创建独立的标签体系,包含标签与群组,如人、书籍、门店可作为单独的实体对象。
实体创建
填写基础信息
步骤一:进入某项目,在实体管理页面点击「新增实体」按钮,填写实体名称、实体标识、实体标识、选择数据源主表及主键、添加辅表等。
实体名称:支持中文、字母、数字、下划线,不超过64个字符;
实体标识:实体的唯一标识(英文名称),项目内唯一,支持字母、数字、下划线,不超过64个字符;
实体描述:实体对象描述,除空格外,不限制其余字符,不超过200个字符;
选择数据源主表:需选择该项目对应数据库的某一张表,作为原子标签表,从此处接入。该张表一般是离线计算DWS的一张表,包含实体的基础属性。该表分为分区表与非分区表,若为分区表,需选择分区字段的格式。
选择主键:需选择数据源主表的某字段作为实体的主键,如用户实体,主键为user_id,标识唯一用户;门店实体,主键为store_id,标识唯一门店。主键用于查找某一具体实例。
选择辅表:可以选择该项目对应数据库下的多张表来加工衍生标签,辅表需要与主表保持同一主键,且不能选择已经与实体绑定的表。
- 选择与主表关联键:从辅表的所有字段中选择一个与主表主键关联的字段,每张辅表都必须选择与主表关联键。
关联任务:主表和辅表可以关联外部任务,以便进行任务依赖。目前支持关联「离线应用」的任务,选择外部任务后,标签系统的任务依赖关系将变化,变成新任务与标签大宽表任务的依赖。
- 选择租户:单选,选择该集群内的租户
- 选择项目:单选,选择所选租户和对应应用下的项目
- 选择任务:单选,可选择所选项目内已提交的任务
目前分区字段格式只支持日期格式,即分区字段必须为日期字段。
数据源主表和主键选择后,不支持修改。
设置维度信息
步骤二:设置维度信息。经过上一步,系统会读取主表或辅表中的字段,填充该维度的中文名称、数据类型、是否为多值列
- 配置字典:可为主表维度配置映射字典或穷举字典,为辅表配置穷举字典,不同类型字典的用法可见字典管理
- 字典的配置方式
- 自定义:填写名称和内容自定义添加字典,系统将直接保存至字典管理菜单下
- 引用:引用已在字典管理菜单下创建的字典
- 选择原子标签:从主表中选择部分维度映射为原子标签
- 标记多值列:此字段可有多个值同时存在,并用英文逗号“,”作为分隔符拆分,且只有字符型字段支持拆分。将该标签标记为多值标签后,可以基于拆分后的标签值进行圈群、画像分析、显著性分析等。
生成原子标签
步骤三:生成原子标签。预览标签值,设置标签的中文名、描述等信息。
此处对于数值型原子标签还可以设置标签数据的展示格式,支持展示成小数、百分数、千分数,并支持设置小数点后位数。标签、群组详情中的实例数据、下载数据以展示格式为准,标签值分布统计数据以实际值为准。
设置更新维度
步骤四:配置标签大宽表的更新周期,支持设置更新周期和更新优先级。
原子标签跟随此处设置的标签大宽表更新规则一同更新,无需另外配置;衍生标签、组合标签可在创建标签时设置更新周期。
更新周期:支持天、周、月、小时、分钟更新,默认每天02:00更新
更新时间:根据更新周期选择计划的具体更新时间,可参考更新周期
更新优先级:可选1~10,数字越小,优先级越高;当底层资源不够时,系统会按照优先级顺序运行任务
延迟实例:当选择“小时”或“分钟”更新周期时,会出现“延迟实例”自动取消的复选框。
- 延迟实例自动取消的含义:如某分钟任务每隔10 分钟运行一次,1:00一条实例,1:10一条实例,若1:10时,1点的实例未运行完成,1点的实例自动取消,开始运行1:10的实例。
tip选择延迟实例自动取消时,该任务的下游任务实例不受影响,不会自动取消。
实体创建成功后,可以在任务管理或标签实例中查看到任务名为“${实体中文名}_标签大宽表更新”的更新任务。
实体详情
点击实体名称,可查看实体详情,包含以下信息:
- 基本信息 包含实体名称、实体ID、实体描述、数据源、数据表、数据源主键、数据量、创建人、创建时间、更新时间等信息。
- 数据维度 可查看实体对应源表的数据维度,包含维度名称、中文名、数据类型、是否多值列、是否关联原子标签等信息。
- 数据预览 默认展示数据源主表下最近20条数据,可看到部分实体的实例数据。
实体编辑
实体编辑与实体新建页面一致,可修改基础信息、标签更新周期。但是数据源主表和主键无法修改。
实体删除
- 实体下的标签类目、标签、群组、群组的API都将被删除;
- 与(被删除的)实体绑定的关系将无法用来加工衍生标签,请谨慎操作。
实体授权
该功能仅旗舰版支持。
在实体详情页面中,点击右上角【授权】按钮给用户/用户组/角色授予当前实体的权限,包括查看、编辑权限,也可以将资源设置为【全员公开】可查看/可编辑,实现细粒度的权限控制。
实体权限 | 具备的功能 |
---|---|
可查看 | 实体列表、实体详情,可在该实体下创建标签、导入数据、标签圈群、创建群组、分析群组(群组交并差/对比分析/画像分析/显著性分析)、搜索个体、设置行级权限/脱敏、创建API等能力 |
可编辑 | 在查看权限的基础上,还具备该实体编辑、删除的能力 |
- 授权功能仅限实体创建人、租户所有者、租户管理员、项目所有者、项目管理员
- 实体默认全员公开,项目内所有人有查看权限;数据管理员、数据开发默认有编辑权限