用途：从已同步的仓库表读取数据，把选定列写入 PostHog 的人员属性（$set）或分组属性（$groupidentify）。每行通过 distinct ID 列匹配到人员，或通过分组键列匹配到分组。首次同步后，这些值即为普通人员/分组属性，可用于功能开关、队列、洞察、问卷和回放筛选。界面位于 Data > Warehouse properties，含 Persons 和 Groups 选项卡。
主要工具：external-data-schemas-list 查找表与 schema id；query（HogQL）检查列并抽样键列；custom-property-definitions-create 创建定义（target_type 为 person 或 group）；custom-property-sources-create 绑定仓库表与列映射；custom-property-sources-list/-retrieve 查看同步状态；custom-property-sources-runs-list 查看运行历史；custom-property-sources-backfill 回填历史行（不计费）；custom-property-sources-sync 立即触发同步（计费）；custom-property-sources-partial-update 改 key_column 或关闭映射；custom-property-sources-destroy 停止同步；custom-property-definitions-destroy 删除定义与绑定。
必要用法：先确认功能已启用、存在已同步表、键列值能对应 PostHog 中真实 distinct ID 或分组键、有仓库源编辑权限（分组还需分组付费功能及权限）。抽样键列验证后再创建定义，再绑定源并填 key_column、column_property_map 与可选 column_descriptions。创建启用的源会立即触发回填。
限制：视图、保存查询和物化视图不能作为人员或分组目标；不要传 saved_query 或 source_column。键无法解析的行会被丢弃并计入 skipped_missing_person，该功能不会创建人员。属性名会直接展示给用户，避免 $ 前缀及 email、name、username。删除映射不会撤销已写入的值，需修正数据或映射后回填覆盖。关闭映射用 is_enabled:false。