Cassandra nodetool repair -pr执行要求存疑：需在各DC所有节点运行？

核心差异：修复的Token范围 #

• 不带-pr参数：修复节点上全部Token范围，包括该节点作为副本存储的、属于其他节点的Primary Range数据
• 带-pr参数：仅修复该节点自身负责的Primary Token Range，不会处理节点上存储的其他节点的副本范围数据

为什么无-pr只需单个DC全节点执行即可覆盖全集群 #

Cassandra的Token环是全局共享的，单个DC内所有节点的Primary Range加起来就是完整的Token空间。当在单个DC的所有节点执行无-pr的修复时：

• 每个节点会对比自身存储的所有范围（本地Primary范围+其他DC的副本范围）的Merkle树
• 默认修复是集群范围的，会自动拉取所有DC中对应Token范围的副本节点参与对比和同步
• 因此，单个DC全节点执行无-pr修复，就能完成全集群所有Token范围的数据同步，无需在其他DC重复执行

为什么-pr需要在每个DC的每个节点执行 #

-pr只处理节点自身的Primary Range，而每个DC的节点都持有全局Token环中属于该DC的独立Primary分片：

• 比如复制因子配置为{DC1:3, DC2:3}时，DC1的3个节点各自负责一部分Primary Range，DC2的3个节点也各自负责另一部分Primary Range（全局Token环由所有DC的节点共同拆分）
• 如果只在DC1的节点执行-pr，仅能修复DC1节点负责的Primary Range，DC2节点持有的Primary Range不会被处理
• 只有在每个DC的每个节点都执行-pr，才能覆盖全局所有的Primary Range，进而完成全集群的完整修复

跨DC修复的传播影响 #

• 无-pr的默认修复：会触发跨DC全副本同步，比如上述{DC1:3, DC2:3}的场景，单个Token范围会有6个节点参与Merkle树对比和数据传输；如果是4个DC各3副本，就会有12个节点同步，数据传输量极大，还会导致同一个Token范围被重复修复多次（每个副本节点都会处理该范围）
• 带-pr的修复：默认依然是集群范围同步（除非结合-local参数，但官方不推荐这种组合，仅适用于本地DC拥有该范围全量数据的场景）——也就是说，-pr只处理当前节点的Primary Range，但会和所有DC中的对应副本节点同步数据，避免了无-pr时重复修复同一个Token范围的问题

关于文档表述差异的说明 #

Apache官方文档和DataStax文档的差异，主要是表述场景的省略：

• Apache文档提到“单个DC的每个节点执行-pr即可修复整个集群”，其实隐含了“每个DC都需要执行此操作”的前提，否则无法覆盖其他DC的Primary Range
• DataStax的表述则更明确，直接强调必须在每个DC的每个节点都运行-pr，避免遗漏部分Primary Range
• 关于-pr与-local不能结合的说明，是因为-local仅在本地DC同步，而-pr处理的是Primary Range，如果本地DC没有该范围的所有副本（比如RF>1），就无法完成完整的修复，因此该组合仅适用于本地DC拥有全量数据的特殊场景

内容的提问来源于stack exchange，提问作者slalomoon