SuperAPI AI 工具集

setting-up-warehouse-properties

数据与分析

查看项目

更新于 10-16 03:45

技能介绍

用途:将数据仓库中已同步的表或物化视图的列,按该表自身的同步计划写入匹配的人员或分组属性,替代用 cron 发送 $set identify 事件的做法。适用于“把 postgres.customer_attributes 列同步为人员属性”“用 PostHog 拉取而非每日 identify 作业”“反向 ETL 进 PostHog”等场景。若表尚未进入仓库,应改用 setting-up-a-data-warehouse-source。

主要能力:通过 external-data-schemas-list/retrieve 查找已同步表及其列类型;通过 view-list/view-get 查找物化视图列;custom-property-definitions-list 查看已有仓库属性;custom-property-definitions-create 创建定义(target_type 为 person 或 group);custom-property-sources-create 一次性携带完整 column_property_map 完成绑定;custom-property-sources-backfill 回填历史;custom-property-sources-runs-list 查看运行漏斗;custom-property-sources-sync 立即运行底层表。

使用方式:先找到表与列,确认哪一列是 PostHog distinct ID 或分组键(key_column),不要凭 id、user_id 等名称猜测。随后构建完整映射 {warehouse_column: property_name} 并交用户确认,默认两侧同名。排除标识列、$ 前缀列及 email、name、username 等身份属性,并标记密码哈希、令牌、审计列等敏感列。检查与已有人员属性的命名冲突。创建时先建定义再建源,映射与绑定仅创建时生效,改列需删除后重建。创建启用的源会自动回填,再用 runs-list 检查 rows_read、changed、existing、produced 各阶段。

限制:只更新 PostHog 中已存在的人员或分组,匹配不到的行被跳过并记为 skipped_missing_person,不会创建新人员;null 值被跳过而非写入,无法用 null 清除属性。同步跟随表自身计划,不可单独调度。连续失败五次会自动禁用,重新启用会重置并触发新回填。人员与分组目标需要 warehouse-person-properties 功能,分组目标还需 group:write 权限。“Sync now”会执行真实计费的仓库同步或物化,不应作为检查手段。物化视图必须已物化,否则创建调用会被拒绝。