支持用户通过SQL语句创建新的标签，使用返回的SQL计算结果作为标签的值，标签创建默认基于数据档案进行。
*该功能仅支持私有化环境。
用户需要具备「**新建SQL标签」**的功能权限，并拥有对应数据档案的查看权限。
2.1 新建SQL标签的功能权限
用户需拥有 项目编辑 或 权限-模块-标签体系-新建SQL标签 的权限。
2.2 数据档案的查看权限配置
点击项目中心-权限-按内容管理-新建规则，对成员进行相关权限配置。
注意：开启数据档案权限时支持管理员选择禁用的数据档案，其余档案权限默认开启。
前往标签体系>新建标签>SQL标签 进入创建页面
3.1 配置基础信息
- 标签名称：新建标签的名称（100个字符以内；同一项目下，标签名称不可重复）
- 路径：选择该标签所在的文件夹分类
说明
新建标签-路径涉及两处开关：
1）集团开关：在项目中心-集团配置-功能配置处，设有标签目录权限控制开关，默认为关，打开后将在创建标签创建时对“目录”做严格权限管控，无编辑标签树权限者仅允许放置到“未分类”。
2）模块开关：标签目录权限控制开关开启后，无编辑标签树权限用户在新建标签时默认“未分类”路径（项目管理员可在 项目中心-权限 中为用户授权）
- 描述：输入标签描述，供其他标签使用者参考
- 计算类型：可选离线计算或实时计算
- 更新类型：可选定时更新或手动更新
- 执行频率：定时更新时需设置更新频率与时刻，支持天/周/月同步
- 计算结果存储规则：定时更新时，可设置需要保留的历史版本个数，次日将对超出限制的历史版本进行删除。
- 若此处选择不限个数，则将遵循集团配置中的标签系统表TTL长度；
- 若此处选择定制ttl，则将遵循此处设置的保留最近版本个数（当单标签的定制ttl>集团的标签系统表TTL长度，以集团的标签系统表TTL长度为准）；
说明
TTL（Time To Live）：数据生命周期，即让存储的数据失效的时间；
3.2 配置标签规则
在标签规则配置页选择标签类型，左侧目录树展示用户有查看权限的标签及对应库表，用户可在创建标签时对源头表进行查询，右侧编辑框中支持写入SQL语句。
注意
- 目前SQL标签目前支持文本型、数值型、小数型、日期型、时间日期型、多值文本型5种类型
- 可用库表仅限通过数据连接接入CDP并经可视化建模（期间需完成id-mapping）后输出的hive或clickhouse类型。
3.2.1 Hive-SQL标签使用流程
SQL 标签界面用于展示当前登录用户有权限查看的 Hive 数据档案。点击数据档案后，界面会自动将其转化为 Hive 底表名称，根据配置的 Hive 账号权限和当前登录用户权限来判断用户是否具有相应的权限。
*注意：底表创建功能保留，历史已经创建的SQL标签仍然存在，无需重新配置。
创建hive数据档案
数据档案权限管理
* 数据档案权限授予
* 数据档案权限排除 具有数据档案模块权限的用户，即拥有项目下所有数据档案的权限，如果要取消用户对特定数
据档案的权限，可以通过如下操作进行排除；
创建Hive SQL标签
具有数据档案查看权限的用户，即可通过数据档案创建SQL标签；
3.2.2 标签类型数据档案
选中标签类型的数据档案，点击右上角插入SQL语句。
插入后自动显示标签查询的完整代码 点击右上角 创建完成 即可完成创建。
代码逻辑为：
select ‘标签相关表达式’---标签名称：xx from 标签底表名插入值
创建完成后即可在标签管理中查看到所建的标签信息
3.2.3 明细/属性类型数据档案
基于明细/属性档案创建SQL标签时，需要手动输入查询代码。
选择明细/属性类型数据档案，可以查看数据源字段以及对应事件，根据需求 单击插入字段 即可将字段名称插入代码框，点击 插入库表名称 即可将数据档案所属库表名称插入代码框，简化库表查询逻辑。
代码逻辑为：
Select ‘底表字段插入值’ From 底表实际名插入值
编写完成后，点击创建完成，之后即可在标签管理中查询到新建标签。
SQL标签支持复制。
3.2.4 行为类型数据档案
选择行为事件类型数据档案，可以查看数据源字段以及事件，根据需求 单击插入字段 即可将字段名称插入代码框，点击 插入库表名称 即可将数据档案所属库表名称插入代码框，简化库表查询逻辑。
代码逻辑为：
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 通过数据档案查询对应底表
点击通过数据档案查询对应底表， 通过档案类型>档案名称路径选中目标数据档案，点击查询，下方即展示选中的数据档案上游底表信息。