第6章：治理与生态——文档、血缘、权限与集成
第 6 章 · 治理与生态：文档、血缘、权限与集成
章节摘要：当数据项目的消费者从两三个人变成几十人、当「这张表能不能动」的问题每天被问五遍，项目就需要治理：文档让新人和业务方自助找答案，血缘让变更影响面从猜测变成计算，权限让正确的人碰到正确的数据，生态集成让 dbt 融进公司已有的数据版图。本章是全册的收尾——治理做得好不好，决定项目从「能用」到「被信任」之间还差多远。
学习目标
阅读完本章，你应当能够：
- 用「描述写在代码旁」的方式维护模型文档，让文档随代码评审同步更新，而不是靠事后补写；
- 部署并维护一个自动更新的文档站点，让业务方自助查表义、查口径；
- 用血缘图回答「改这个模型影响哪些下游」的影响面问题，并据此制定变更预案；
- 为项目设计分级访问控制：凭据管理、角色划分、敏感列的权限收敛；
- 画出 dbt 与上下游生态（同步、BI、编排、指标层）的集成边界，判断新工具该接在哪一环。
本章知识点清单
- 文档的三种形态与各自归宿：行内描述、配置文档、文档站点；
- 文档保鲜机制：描述与代码同仓同审，改代码不改描述会被评审拦下；
- 血缘的两个方向：上游溯源（这数从哪来）与下游影响（改这会动谁）；
- 组级血缘与节点级血缘的粒度差异；
- 凭据不进版本库的实现路径与角色划分原则；
- 敏感数据的分层收敛：原始敏感列不出贴源层；
- 生态四环节的衔接边界：同步、dbt、编排、消费。
核心概念速览
治理的四个主题不是并列关系，而是层层递进的信任链条：文档回答「这是什么」，血缘回答「它从哪来、动它会怎样」，权限回答「谁可以碰它」，生态回答「它在整个数据版图的哪个位置」。前一层是后一层的前提——连表义都说不清的模型，谈权限分级没有意义。
一句话锚点：文档建立理解，血缘建立因果，权限建立边界，生态建立位置——治理的全部目标，是让数据资产配得上「信任」两个字。
落到工程动作上，这条信任链可以翻译成四份可验收的交付物：一份与代码同审的描述规范、一张随构建刷新的血缘图、一张三角色的权限基线表、一页生态清单（每个外部工具标注它接在哪一环、产物是否可审计）。本章四节各交付其中一份，验收标准也各自可查——描述看消费端的覆盖率，血缘看图外暗边的数量（血缘覆盖不到的硬编码引用），权限看生产写入账号的个数（理想值是一，只属于流水线），生态看业务口径有没有漂到工具侧。治理最容易走偏的方向是变成一场只发生在会议里的讨论：它应该像本章写的那样，每一项都落在可验收的工程产物上，讨论才有落点。
子章节导航
6.1 文档与知识管理 —— 把文档从「项目结束补材料」变成「与代码同步生长的资产」：描述写在哪、站点怎么自动更新、什么样的文档才有人看。
6.2 数据血缘与影响分析 —— 血缘图不只是好看的图片：它回答变更影响面的计算问题。本节讲两个方向的使用法与一份基于血缘的变更预案模板。
6.3 安全与访问控制 —— 从凭据管理到角色划分到敏感列收敛，一套分级访问控制的完整设计，以及它如何复用 5.1 节的环境机制。
6.4 生态集成与演进趋势 —— dbt 在现代数据栈里的位置：与同步、编排、BI、指标层的衔接边界；社区与标准化的演进方向，以及判断「新工具要不要接」的框架。
子章节之间的逻辑关系
四节沿「信任链」递进：文档与血缘解决「理解与因果」（对内），权限解决「边界与合规」（对管控），生态解决「位置与协作」（对外）。工程主线（第三、四、五章）讲的是把东西建出来，本章讲的是让建出来的东西被更多人放心地用。
6.1 文档（这是什么） => 6.2 血缘（因果与影响） => 6.3 权限（边界） => 6.4 生态（位置与协作）
前置知识与后续延伸
前置知识：全册前五章的概念都在本章被回收再用——血缘挂在第二章的依赖图上，权限复用第五章的环境与凭据机制，生态话题回指第一章的架构定位。
往后没有「下一章」了，但有两条继续走的路：往深走，宏的自定义物化、钩子与包开发是四个值得专攻的工程方向；往宽走，指标语义层、数据质量平台、元数据管理是与本章生态话题直接相邻的领域。学完本册，这两条路上的路标你都应该认得了。