1.功能说明

虚拟属性是通过 SQL 表达式，对同一条数据中的属性，进行再计算而得出的一个新的属性。如果这条数据是事件数据，为事件虚拟属性；如果是针对同一用户的用户属性进行的计算，为用户虚拟属性。

虚拟属性的应用场景如：

• 数值计算：如将数据中的几个数值型属性进行计算得出一个新的结果，比如订单实付款/定价=折扣率
• 内容抽取：如将一个字符型属性中特定内容单独抽取成为一个属性，比如 url 中的 id 值
• 属性属性合并：如将相同意义的不同属性合并为一个属性，gpid、gid 合并为 group_id
• 日期与时间格式化：如将从某个时分秒的日期值格式化成为周几的新虚拟属性

所以虚拟属性是由真实上报的原始属性计算得出的、可以用于统计计算，但并没有在原始数据里上报的属性值。

2.使用方法

2.1 创建事件虚拟属性

有可创建权限的用户，可在事件属性管理右上角点击“创建属性-虚拟属性”，进入事件虚拟属性的创建页面

• 事件虚拟属性需要指定生效的事件，只有关联的事件在分析时才会显示当前创建的虚拟属性。
• 虚拟属性需要指定虚拟属性的数据类型，该类型将影响到虚拟属性在分析模型中计算时可以选用的方法。
• 当选定指定事件时，右侧属性列表将展示所有指定事件共有的事件属性，在编辑 SQL 表达式时可以点击列表中的属性，直接将属性添加到指定位置。

2.2 创建用户虚拟属性

有可创建权限的用户，可在用户属性管理右上角点击“+用户虚拟属性”按钮，进入用户虚拟属性的创建页面。

• 与事件虚拟属性的创建相比，用户虚拟属性不与事件相关联，没有指定事件选择区域
• 同时右侧展示的是用户表中的属性列表。
• 其它设置项，包括 SQL 表达式的编辑要求、抽取数据进行结果检验等与事件虚拟属性的处理相同。

2.3 关于 SQL 表达式的编写

• 支持 Clickhouse 21.8 及以下版本相关的函数的语法。
• 需要在引用的属性前加上表名前缀，如引用事件属性 vip_level 时需完整输入 events.vip_level，引用用户属性时增加表名前缀 users。
• 表达式只支持 sql as 标准语法，如：select xxx as 'abc' from events。即sql表达式只支持 xxx部分。
• 表达式中需要至少引用一个库中存在的属性。
• 只支持输入关联事件的共有属性。

关于结果检验

• 点击结果检验时会先进行表达式的检查。
• 编写的表达式无误时会从数据库中直接抽取对应数量的数据计算出结果进行展示，以便确定结果是否如预期。
• 计算得出的值的数据类型，需要符合条件中选择的数据类型，否则校验不通过，无法进行保存。
• 修改任何条件时都需要重新进行结果检验且通过，才可以进行虚拟属性的保存。

2.4 虚拟属性的计算逻辑

虚拟属性仅支持对同一条数据里的属性进行计算和处理，或者进行属性与常量之间的计算，不支持跨多条数据进行计算。

当 SQL 表达式里引用的属性在同一条数据中完整出现时，这条数据才会被计算虚拟属性，否则不会计算。

事件虚拟属性只会出现在指定的事件下，没有关联的事件下不会出现。

2.5 虚拟属性的应用

• 数据管理-事件属性/用户属性

保存的虚拟属性，作为一种特殊类型的属性，同样会展示在属性列表中，其类型为：虚拟属性。

在事件属性或用户属性列表上，虚拟属性的属性标识后显示“SQL”icon，点击时可查看生成该虚拟属性的 SQL 表达式。

• 分析模型-事件属性列表-属性指标计算

事件虚拟属性与事件的原始属性一样，可以被来在分析模型中进行指标计算。

关联到事件上的虚拟属性，可以在选定事件后的属性列表中被选择，之后按照虚拟属性类型进行指标计算。

• 分析模型-用户属性列表

在分析模型中，涉及用户属性的展示和选择处，同样支持用户虚拟属性，使用方法与用户原始属性一致。

• 分析模型-筛选项与分组项-事件属性/用户属性

在分析模型中，事件属性、用户属性可以被用于进行事件指标的筛选及分组展示，事件虚拟属性、用户虚拟属性同样可以用于筛选及分组展示，使用方法与事件属性、用户属性一致。

3.权限说明

操作权限：负责人、超级管理员、组管理员，及拥有事件属性、用户属性可编辑权限的角色，可以创建及管理对应的虚拟属性

入口：首页-产品页-顶部主菜单-数据管理-元数据管理-事件属性 或 用户属性