SQL标签

用户通过SQL语句创建新的标签，使用返回的SQL计算结果作为标签的值，标签创建默认基于数据档案进行。
*底表创建功能保留，历史已经创建的SQL标签仍然存在，无需重新配置。
*该功能仅支持私有化环境。

2.1前提权限

用户需拥有 项目编辑 或 权限-模块-标签体系-新建SQL标签 的权限。

2.2 权限配置

点击项目中心-权限-按内容管理-新建规则，对成员进行相关权限配置。
开启数据档案权限时支持管理员选择禁用的数据档案，其余档案权限默认开启。

前往标签体系>新建标签>SQL标签 进入创建页面

3.1 配置基础信息

• 标签名称：新建标签的名称（100个字符以内；同一项目下，标签名称不可重复）

• 路径：选择该标签所在的文件夹分类

• 描述：输入标签描述，供其他标签使用者参考

• 计算类型：可选离线计算或实时计算

• 更新类型：可选定时更新或手动更新

• 执行频率：定时更新时需设置更新频率与时刻，支持天/周/月同步

• 计算结果存储规则：定时更新时，可设置需要保留的历史版本个数，次日将对超出限制的历史版本进行删除。

  • 若此处选择不限个数，则将遵循集团配置中的标签系统表TTL长度；

  • 若此处选择定制ttl，则将遵循此处设置的保留最近版本个数（当单标签的定制ttl>集团的标签系统表TTL长度，以集团的标签系统表TTL长度为准）；

3.2 配置标签规则

在标签规则配置页选择标签类型，左侧目录树展示用户有查看权限的标签及对应库表，用户可在创建标签时对源头表进行查询，右侧编辑框中支持写入SQL语句。

3.2.1 标签类型数据档案

选中标签类型的数据档案，点击右上角插入SQL语句。

插入后自动显示标签查询的完整代码 点击右上角 创建完成 即可完成创建。

代码逻辑为：

select ‘标签相关表达式’---标签名称：xx
from 标签底表名插入值

创建完成后即可在标签管理中查看到所建的标签信息

3.2.2 明细/属性类型数据档案

基于明细/属性档案创建SQL标签时，需要手动输入查询代码。
选择明细/属性类型数据档案，可以查看数据源字段以及对应事件，根据需求 单击插入字段 即可将字段名称插入代码框，点击 插入库表名称 即可将数据档案所属库表名称插入代码框，简化库表查询逻辑。

代码逻辑为：

Select ‘底表字段插入值’
From 底表实际名插入值

编写完成后，点击创建完成，之后即可在标签管理中查询到新建标签。

3.2.3 行为类型数据档案

选择行为事件类型数据档案，可以查看数据源字段以及事件，根据需求 单击插入字段 即可将字段名称插入代码框，点击 插入库表名称 即可将数据档案所属库表名称插入代码框，简化库表查询逻辑。

代码逻辑为：

select ‘底表字段插入值’
from 底表实际名称插入值 ---行为档案名称：xx
where event=‘事件插入值’
and string_map{'事件属性字段插入值'}

编写完成后，点击创建完成，之后即可在标签管理中查询到新建标签。

3.3 标签配置指引功能

创建SQL标签时候可通过「格式化」，「解析」，「预览」，以及右侧示例，帮助您快速新建SQL标签功能。

• 格式化：将您输入的SQL代码按照内置格式显现，可视化程度增加。

• 解析：检测输入的SQL代码正确性。

• 预览：在创建完成前可以对结果进行预览。

• 展开示例：包括用户创建SQL标签需要注意的事项，并附上了代码示例，您可自查SQL代码的准确性。

编写代码逻辑或返回结果缺失会导致创建失败，用户可通过复制错误信息，根据错误信息提示修正代码，或者联系您的技术支持修正代码。

帮助功能动态演示

3.4 预估人数

点击[预估人数]，快速了解标签覆盖范围。

3.5 查看标签详情

点击 创建完成 即可完成当前标签的创建，在标签详情页即可查看当前标签人数分布情况、历史详情及运行记录等。

3.6 血缘信息查询

支持对底表和数据档案之间进行转换关系查询。前往标签体系>新建标签>SQL标签 进入创建页面。点击顶部提示 查询客户底表和数据档案之间的关系，可以快速对底表和数据档案之间进行转换关系查询。

3.6.1 通过底表查询对应数据档案

点击通过底表查询对应数据档案，选择Hive或者Clickhouse类型，依次按照集群>库>表的路径选中目标底表

点击查询后，弹窗下方会显示选中库表对应的数据档案名称以及档案类型。

3.6.2 通过数据档案查询对应底表

点击通过数据档案查询对应底表， 通过档案类型>档案名称路径选中目标数据档案，点击查询，下方即展示选中的数据档案上游底表信息。