用途:为星型模型一次性构建干净、可复用的维度表(如 dim_country、dim_plan、dim_date),避免每个模型各自重新推导查找逻辑。事实表(事件、扣费、收入项)通常长而可加,维度表则短、每实体一行、用于切片描述。
主要能力与用法:建模维度分三步。一是确定来源:以 CSV 上传/种子方式提供查找表(国家→地区、套餐→层级),从系统记录(应用数据库、Stripe 产品)同步,或从事件派生(出现过的国家、按人观察到的套餐属性)。二是整形:用带别名的 SELECT 输出干净列名,保证每实体一行并去重,保存为视图,并按较慢的同步频率(7天/30天)物化,因为维度变化少但读取频繁。三是关联:通过已保存的 join(维度→事实表)或 person join(维度→人员),使维度列在查询、筛选、细分中呈现为原生字段。
规则:每实体一行、唯一键,重复键会造成事实表扇出,需测试唯一性(PostHog 在整形查询中校验,dbt 用 unique + not_null);列名使用稳定别名如 country_code、region、plan_tier,作为后续一切依赖的 join 接口;静态维度按慢调度物化,不要长期保留为虚拟视图;注册并在目录中认证重要维度,避免他人另建重复副本。
货币:PostHog 已内置受管理的货币维度,通过 convertCurrency(from, to, amount, timestamp?) 提供历史汇率正确的换算,直接使用即可,不要再自建货币表;只有当使用 dbt(无等价功能)或需要 PostHog 未提供的汇率源时,才自行构建货币维度。
实现配方:PostHog 侧整形带别名的维度视图后物化并 join,参考 references/posthog/dim_country.sql(从事件派生并富化)与 dim_plan.sql(查找/上传模式);dbt 侧构建一致的 dim_* 模型并附加 unique/not_null/relationships 测试,以及生成的 dim_date,参考 references/dbt/。常见维度目录、来源方式与自然键见 references/dimension-catalog.md。配套技能包括建模仓库基础(join 与货币)、设置数据仓库来源/建议数据导入,以及消费这些维度的各项指标模型。
限制:本技能未提供独立的定价、性能或平台兼容性信息,实际可用性取决于 PostHog 与 dbt 环境及上述依赖技能。