实体SQL标签，支持自定义SQL语句创建标签并赋值给实体，适用于个性化的取数场景。

仅私有化/私有化订阅版本，或开通实体SQL标签资源包的SaaS版本支持该功能。

7.1 标签基础信息

必选实体对象，由用户选定所需打标的实体，下拉选择已有自定义实体列表。

必填标签名称，50个中文字符限制。

选填标签描述，100个中文字符限制。

可选标签分组，默认选择全部，下拉可选择已有的其他标签组。

可添加应用场景标记，支持多选。

7.2 标签值

标签值数据类型支持选择：整数、实数、字符串、日期。

当选择标签值数据类型为字符串时，支持关联字典表对标签值进行翻译。选择关联字典表后，标签值命中字典value时会按字典翻译展示，例如关联字典“1：女，2：男”，则打上“1”时会翻译展示为“女”。

7.3 SQL表达式规范

必须有且只有实体的系统内部ID和标签值两列，确保给某一实体ID打上标签值。查询结果需返回2列数据，且需order by tag_val，一列返回实体的系统内部ID，一列返回标签值（tag_val）。如给实体打上“支付订单总数”标签，示意如下：

SELECT event.itemid AS itemid, COUNT(event.orderid) AS tag_val

FROM event

WHERE event_name = '支付订单'

ORDER BY tag_val

7.4 更新方式

实体SQL标签支持选择以下更新方式：

a. 手动更新：选择手动更新后，仅用户点击更新后对规则进行重新计算；

b. 自动更新：按照用户定义的规则自动进行更新。自动更新，可进一步选择更新策略，即每日/每周/每月开始更新的时间点；

c. 调度更新：按照任务上下游血缘依赖的排序自动进行按日调度更新；

更新数据范围：触发更新时包含的数据当前时间点以前的所有数据；

触发更新时的任务状态：该标签任务在更新中的状态，此时无法对标签进行任何操作，也不展示标签覆盖的实体数量，直至更新完成。

7.5 预估实体数

为了让创建者快速了解标签圈选的有效性（实体数过少）及是否超过触达上限（实体数过多），SQL标签支持【预估覆盖实体数】，点击后弹窗展示预估统计结果：每一标签值覆盖的实体数量、实体占比。

计算结果展示如下图：