MySQL NDB增加数据节点后为什么还要重分布数据

MySQL NDB 增加数据节点后还要重分布数据，是因为“节点已经加入集群”和“已有表已经采用新的分片布局”是两件事。创建新 node group 只改变了集群可以使用的拓扑；在新 node group 建立之前已经存在的 NDBCLUSTER 表，仍要逐表执行 ALTER TABLE ... REORGANIZE PARTITION，数据和索引才会按新的布局分到新增节点。本文限定 MySQL NDB Cluster 8.4，不把这个过程与 InnoDB 扩容混为一谈。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/mysql-cluster.html

一句话记忆：扩容先改变 node group，重分布再改变存量表的分片；扩容后新建的表则会自动使用新的分布范围。

新增节点为什么不等于已有表已经搬过去

NDB 的数据节点按 node group 组织，表的数据和索引以分片形式分布在这些节点上。在线增加节点时，官方流程要求先把新数据节点加入新的 node group，再为每一张已经存在的 NDBCLUSTER 表执行重组分区。这个设计把“改变集群拓扑”和“迁移每张表的数据”拆开，避免管理服务在节点刚加入时擅自改动所有表。

因此，刚启动的新节点可能已经能在管理客户端的 SHOW 中看到，但某张老表的读写分片仍可能只落在原有节点组。只看节点在线状态，不能推导出存量表已经完成重分布。

新表和旧表的分布规则不一样

这也是很多“节点扩容后容量没有按预期下降”问题的来源：新节点有容量，并不表示每一张旧表已经有分片落在那里。官方说明还特别指出，只有在新 node group 加入前已经存在的表需要这一步；之后创建的表不需要再为“补上新节点”重复执行同样的操作。

存量表的最小重分布写法

确认新节点已经启动并通过管理客户端创建 node group 后，可以在 SQL 节点上对每一张既有 NDBCLUSTER 表执行下面的语句。这里的表名只是示例，命令本身用于说明写法，不代表本文在某个生产集群上执行过。

-- 让这张既有 NDBCLUSTER 表重新采用当前 node group 布局
ALTER TABLE orders
  ALGORITHM=INPLACE,
  REORGANIZE PARTITION;

-- 按同样规则处理另一张存量表；实际项目应逐表安排窗口
ALTER TABLE order_items
  ALGORITHM=INPLACE,
  REORGANIZE PARTITION;

这里的 REORGANIZE PARTITION 用法与普通“列出旧分区并写出新分区定义”的场景不同。在 NDB 在线加节点的语境里，官方示例将它作为把表重新分布到新 node group 的声明使用，不需要在语句后继续写分区定义。

表数量较多时，可以先整理出引擎为 NDBCLUSTER 的表名，再由负责人逐条确认：

-- 只列出需要纳入扩容清单的 NDB 表，不执行迁移
SELECT TABLE_SCHEMA, TABLE_NAME
FROM INFORMATION_SCHEMA.TABLES
WHERE ENGINE = 'NDBCLUSTER';

三个容易踩到的边界

第一，MAX_ROWS 表不能机械套用。官方文档说明，使用 MAX_ROWS 创建的表不适用上面的普通重组写法，需要使用带 MAX_ROWS=... 的 ALTER TABLE ... ALGORITHM=INPLACE 方式重新组织；同时，靠 MAX_ROWS 设置分区数已经不推荐，新的设计应关注 PARTITION_BALANCE 等对应选项。

第二，重分布不自动等于旧节点空间已经回收。REORGANIZE PARTITION 重新组织分片后，旧节点释放出的部分空间可能仍未回收。对适用的内存 NDB 表，可再评估 OPTIMIZE TABLE；它并不适用于所有列类型，也不适用于 Disk Data 表，不能把它当成无条件的收尾命令。

第三，不能用节点在线替代表级检查。扩容清单至少要记录新 node group、既有 NDBCLUSTER 表、是否执行过重组以及是否需要空间回收。对于生产环境，还应根据业务负载安排表级操作，不要把所有表的变更拼成未经评估的一条大命令。

最小回顾

MySQL NDB 在线加数据节点时，新增节点先成为新的 node group；存量表的分片布局不会因为节点上线而自动重写，所以要逐表执行 ALTER TABLE ... REORGANIZE PARTITION。新建表会按新增后的集群拓扑分布，MAX_ROWS 表和空间回收则需要单独处理。

为什么新节点已经能在 SHOW 中看到，老表仍不使用它？因为 SHOW 反映节点和 node group 状态，不代表每张既有表已完成重分布。

所有表都要执行 REORGANIZE PARTITION 吗？只针对新 node group 创建时已经存在的 NDBCLUSTER 表；之后创建的表不需要为同一原因重复处理。

REORGANIZE 完成后还要 OPTIMIZE TABLE 吗？是否需要取决于空间回收目标、表的列类型和是否为 Disk Data 表，不能一概而论。