用途:对 PostHog 数据仓库中的物化视图(物化保存查询)做项目级健康审计,汇总哪些视图失败、哪些物化但未被使用。适用于用户想要视图健康概览而非单个失败深挖的场景,例如“哪些视图坏了”“是否有物化视图浪费计算”“HogQL 或 schema 变更后复查视图健康”“依赖物化视图的仪表盘过期或报错”。
主要能力:通过 data-warehouse-data-health-issues-retrieve 一次性拉取全流程失败/降级项,并筛选 materialized_view 类型;view-list 列出所有保存查询/物化视图及状态与 latest_error;view-run-history 查看特定物化视图的运行历史。审计关注 materialized_view 类别(is_materialized=true 且 status=Failed),每条含 id、name、type、status、error、failed_at、url。
使用方式:先调用 data-warehouse-data-health-issues-retrieve 保留 materialized_view 条目;无问题即告知健康并停止。对每个失败视图展示错误并指向问题查询,需要时用 view-run-history 查看失败轨迹。以人类可读的优先级报告呈现,不要直接输出原始 JSON。若用户明确要求更广审计,再用 view-list 找出已物化但近期未被查询的视图作为清理候选(可通过 view-unmaterialize 取消物化)。最后给出明确后续建议,如“是否打开某视图修复 HogQL”。
适用场景:视图健康汇总、HogQL/schema 变更后复查、仪表盘过期排查。
限制:审计为只读,未经明确确认不得调用破坏性工具(如 view-unmaterialize、view-delete)。data-health 端点只报告活跃失败,不报告非物化视图错误,也不报告健康但未使用的物化视图(需额外检查)。source/external_data_sync 属于 auditing-warehouse-source-health;destination(批量导出)与 transformation(HogFunction)由其他产品负责,应转交而非在此诊断。视图失败通常是视图自身的 HogQL 或数据问题,一般不级联,不要暗示更大范围故障。空结果即健康,不要编造问题。