Definition

Data Architecture Decision Record 是记录数据架构关键决策的轻量文档,说明为什么选择某个方案、拒绝哪些方案、有哪些约束和后续风险。

Business Value

  • 降低架构评审和项目交接成本。
  • 让平台演进有可追溯依据,避免反复讨论同一个选型。
  • 为面试、复盘和演讲提供高质量项目证据。

Architecture / Flow

flowchart LR
  A["Context"] --> B["Options"]
  B --> C["Decision"]
  C --> D["Consequences"]
  D --> E["Verification / Review"]

Commercial Practice

常见决策包括:湖仓 vs 数仓、Lambda vs Kappa、实时链路技术栈、元数据平台选型、指标口径管理方式、是否引入语义层、Agent 是否允许执行 SQL。

Common Pitfalls

  • 只写结论,不写约束和拒绝方案。
  • 把 ADR 写成会议纪要,没有后续验证标准。
  • 决策过大,导致单篇记录难以复用。

Interview Answer

我会用 ADR 记录数据架构中的关键取舍,例如为什么选择湖仓一体、为什么引入语义层、为什么限制 Agent 只能生成 SQL 草稿。ADR 的价值是让架构选择可解释、可复盘、可交接。