用途:帮助用户在 AE(TE 分析引擎)前端分析模型中使用系统预设字段。系统字段在 SQL 查询中默认可直接使用,但前端分析模型中默认隐藏、不能直接用。
系统字段分类:事件表系统字段(事件属性范围)与用户表系统字段(用户属性范围)。事件表字段需两步:先「创建并连接」,再用 relation_always 包装为虚拟属性;用户表字段只需一步「创建并连接」,连接后即可在前端模型直接使用。
字段命名:以 $ 开头为分区字段,以 # 开头为系统属性字段,如事件表的 $part_event、$part_date、#event_name、#event_time、#uuid 等,用户表的 #reg_time、#update_time、#event_date、#user_operation 等。#user_id、#account_id、#distinct_id、#server_time、#dw_update_time、#kafka_offset、#uuid 在两张表中都存在,单凭名称无法确定类别,必须引导用户确认。
用法:先用 metadata 查询字段是否已连接,按 prop_name 精确匹配;scope 为 event 即事件属性,user 即用户属性。未连接时回退到字段清单匹配,再引导用户在「数据」→「数据管理」→「事件属性/用户属性」→「来源…管理」中点击「创建并连接」。事件表字段连接后用 ae-cli analysis-meta virtual-property create 创建虚拟属性:机器名以 #vp@ 开头,表类型 event,SQL 表达式用引号引用含 # $ @ 的字段标识,关联事件设为 relation_always,数据类型保持与原始字段一致;select_type 须使用 property list 返回的真实值,不能照抄占位命令。
适用场景:事件分析、漏斗分析、留存分析等前端模型;仅需 SQL 查询时无需任何配置。
限制:字段清单可能随 AE 版本变化,遇未列字段优先用查询核实;不得猜测跨表字段类别;不确认已连接状态不可创建虚拟属性;用户字段通常无需虚拟属性,除非用户主动要求;本文未提供收费、价格与平台信息。