MySQL报错MY-010191，NDB表没准备好，远程修复思路分享

MySQL报错MY-010191，这个错误代码通常与MySQL Cluster（NDB引擎）相关，根据MySQL官方手册和一些技术社区如Stack Overflow、DBA专用论坛上的讨论，这个错误的核心意思是NDB存储引擎报告某些表没有处于联机或就绪状态，就是MySQL服务器实例（SQL节点）想用NDB集群里的表，但发现这些表“没准备好”，可能是表结构没同步过来，或者是表的数据节点还在启动、加载数据的过程中。

当你在一个分布式环境（也就是NDB集群）里遇到这个错误，而你又需要远程进行修复时，情况会比较棘手，因为你不能直接物理接触到服务器，下面分享一些基于经验的、按步骤来的排查和修复思路，操作NDB集群需要非常小心，任何不当操作都可能导致数据不一致或服务中断。

第一步：先看明白错误日志，搞清楚是哪张表“没准备好”

错误MY-010191通常不会孤立出现，它会伴随着更详细的信息，你需要登录到出问题的那个MySQL服务器（SQL节点）上，仔细查看MySQL的错误日志文件（通常是hostname.err），日志里会明确指出是哪个数据库（schema）下的哪张表出了问题，可能会看到类似“Table 'mydb.mytable' is not available ...”这样的描述，把这个表名记下来，这是你后续所有操作的焦点，这是所有修复工作的起点，必须精确。

第二步：检查NDB集群的整体健康状况

既然表在NDB集群里,那么整个集群的状态是首要检查点，你需要连接到集群的管理节点（ndb_mgm）使用管理客户端进行检查。

1. 远程登录到管理节点：使用SSH等工具连上去。
2. 启动NDB管理客户端：执行 ndb_mgm 命令。
3. 查看集群状态：在管理客户端里，输入 SHOW 命令，这会列出所有的数据节点（ndbd）和管理节点，你要重点关注所有数据节点的状态是否都是“Started”或“Online”，如果任何一个数据节点是“No contact”（失去联系）、“Starting”（启动中）或者“Failed”（失败），那么整个集群都不健康，表自然无法就绪，这时候，修复的重点就不是单张表，而是先让有问题的数据节点恢复正常。

第三步：如果集群健康，深入检查特定表的状态

SHOW 命令显示所有数据节点都运行良好，那问题可能就出在那张特定的表上，继续在ndb_mgm管理客户端里操作：

1. 列出所有NDB表：输入 SHOW TABLES 命令，这个命令会显示在NDB集群中注册的所有表。
2. 查找问题表：在输出的列表里，找到你在第一步中记下的那个问题表，关注它的状态，它可能显示为“正在创建中”、“已断开连接”或其他非“正常”状态，这能给你一个更明确的线索。

第四步：尝试在SQL节点上“唤醒”表

表在NDB集群层面是好的,但SQL节点与它的连接可能出现了“卡住”或不同步的情况，这时候可以尝试在出问题的MySQL服务器（SQL节点）上，使用MySQL客户端进行一些简单操作来“唤醒”它。

1. 登录MySQL：使用mysql命令连接到本地的MySQL实例。
2. 选择数据库：USE your_database_name;
3. 尝试访问表结构：执行一个最无害的查询，CHECK TABLE problem_table; 或者 REPAIR TABLE problem_table; 命令。CHECK TABLE 只是检查，而 REPAIR TABLE 会尝试修复，仅仅是MySQL服务器重新去NDB集群拉取一次表元数据，就能让表状态恢复正常，这是一个相对安全的首选尝试。

第五步：更进一步的操作——删除并重建表连接

如果上述方法无效,可能需要更果断的措施，思路是：在NDB集群中，表定义是存储在数据节点上的，而SQL节点只是保存了一个“链接”或“影子表”，如果这个链接坏掉了，我们可以删掉SQL节点上的这个坏链接，然后让它从集群重新拉取。

警告：此操作需要极其谨慎，确保你有备份或充分理解后果！

1. 在SQL节点上删除表：在MySQL客户端里，执行 DROP TABLE problem_table;。注意： 对于NDB表，在SQL节点上执行DROP TABLE默认不会删除NDB集群中的数据节点上的实际表和数据！它只是删除了SQL节点本地的表定义链接，这是这个操作能进行的关键前提，但为了绝对安全，在执行前，最好通过管理节点的 ndb_mgm -e "SHOW TABLES" 确认表在集群中依然存在。
2. 从集群恢复表到SQL节点：删除本地链接后，你需要重新创建它，最直接的方法是使用源表的结构，如果有完整的SQL脚本，直接执行CREATE TABLE语句即可（确保引擎是ENGINE=NDB或ENGINE=NDBCLUSTER），如果没有，可以尝试从一个确定是好的、能正常访问该NDB表的其他SQL节点上，导出表结构（使用 SHOW CREATE TABLE problem_table\G），然后在出问题的节点上执行这个CREATE TABLE语句。

当你执行CREATE TABLE语句时，MySQL会去NDB集群查询元数据，并重新建立本地表与集群数据的关联，大多数情况下，这样就能解决问题。

第六步：终极手段——重启SQL节点进程

如果所有方法都失败了,一个简单粗暴但往往有效的方法是：重启出现问题的那个MySQL服务器（SQL节点）的mysqld服务，使用 systemctl restart mysql 或 service mysql restart 等命令，重启会清空所有缓存和连接，当服务再次启动时，它会重新初始化并与NDB集群同步所有表元数据，这在远程修复中是一个可行的“重启大法”，但要注意这会导致该SQL节点上的所有连接暂时中断。

总结一下远程修复思路的核心：

• 日志定位：先看日志，精准定位问题表。
• 由广至深：先检查整个NDB集群是否健康，再聚焦到单张表的状态。
• 由简至繁：先尝试简单的CHECK/REPAIR命令，无效再考虑DROP & CREATE本地表链接。
• 重启备用：最后考虑重启SQL节点服务。

整个过程需要你对NDB架构有基本的理解（SQL节点、数据节点、管理节点的角色），但操作上可以避免过于深奥的专业命令，远程操作务必保持冷静，一步一步来，并做好每一步结果的记录和观察。