用途:在编写或修改任何 dbt 模型前优先调用,适用于新建 staging/intermediate/mart/OBT 模型、修改 SQL 逻辑、从仓库元数据生成 sources.yml 或 schema.yml、按分层重组模型、改为增量物化、搭建新 dbt 项目结构。不适用于加测试(用 dbt-test)、写描述(用 dbt-docs)、排查构建失败(用 dbt-troubleshoot)、分析变更影响(用 dbt-analyze)。
主要能力与用法:按“规划→探查→编写→验证”流程工作。规划阶段用 altimate-dbt info、parents、children 了解项目与依赖,用 dbt_profiles 确认适配器与目标。探查阶段用 schema_search 搜索表列,读取 YAML 与父模型 SQL,用 altimate-dbt columns、columns-source、execute、column-values 核对粒度、主键、空值与关系。编写阶段参考分层与增量策略模板。验证阶段用 altimate-dbt compile、build、test,对非平凡转换生成并运行 dbt 单元测试,用 schema-verify 核对列规格,用 sql_analyze、altimate_core_validate、altimate_core_column_lineage 检查质量与血缘,修改已有模型时用 children 与 --downstream 评估影响。
限制与注意:需具备文件写权限;资料未提供收费、平台与效果信息。规则要求先读源列再写 SQL、不能只编译必须 build、匹配现有模式、修复所有错误、逐项核对交付物、严格匹配列规格。资料还列出增量高水位边界、unique_key 选择、on_schema_change、快照策略、日期计算、COALESCE/CASE/UNION 类型统一、字符串拼接 NULL、模型版本化、CTE 抽取保持行数等常见陷阱。