【MySQL内置数据库】mysql_innodb_cluster_metadata

mysql_innodb_cluster_metadata 是 MySQL Shell / InnoDB Cluster / ClusterSet 的“系统目录库”。它里面每一张表都记录了 拓扑、状态、实例、路由器、版本号 等关键信息,千万不要手工改动,否则集群会直接报错或无法启动。

集群总体信息

表名

关键字段 作用 clusters cluster_id, cluster_name, topology_mode 当前 InnoDB Cluster 的名称、模式 单主/多主 clustersets clusterset_id, clusterset_name 当启用 ClusterSet 跨地域容灾 时,记录全局 ClusterSet 信息 schema_version major, minor, patch 元数据 版本号,升级 Shell 或 MySQL 时会自动变更

clusters

clustersets

schema_version

实例 节点 清单

表名

关键字段 作用
instances mysql_server_uuid, hostname, port, role, weight — 老版本 v1 的节点清单,记录每个 MySQL 实例的地址、角色、权重
v2_instances instance_id, addresses, attributes, version_token — 新版本 v2 的节点信息,字段更丰富,支持 IPV6、多地址
日常用 select * from v2_instances\G 就能快速看出 哪个节点没上线。

instances

v2_instances

GR 集群/视图

表名

关键字段 作用 v2_gr_clusters cluster_id, group_name, group_seeds, member_weight 与 Group Replication 参数一一对应,自动同步 v2_ar_clusters cluster_id, topology 异步复制集群 ReplicaSet/DR 场景 的元数据 async_cluster_members member_id, member_role, member_host, member_port 异步集群的成员信息

v2_clusters

v2_ar_clusters

async_cluster_members

Router 相关

表名

关键字段 作用 routers / v2_routers router_id, hostname, last_check_in, version MySQL Router 的心跳、版本、最后一次上报时间 router_rest_accounts / v2_router_rest_accounts account, password Router 连接元数据库用的 REST API 账号 v2_this_instance instance_id, cluster_id Router 本机属于哪个实例、哪个集群 快速定位

routers

v2_routers

router_rest_accounts

v2_router_rest_accounts

v2_this_instance

ClusterSet 扩展 v2 专用

表名

关键字段 作用 v2_cs_clustersets clusterset_id, primary_cluster, failover_counter 整个 ClusterSet 的 主集群、故障切换次数 v2_cs_members member_cluster_id, member_role 每个集群在 ClusterSet 里的角色 PRIMARY / REPLICA v2_cs_router_options option_name, option_value Router 对 ClusterSet 的 路由策略 读写分离权重等

v2_cs_clustersets

v2_cs_members

v2_cs_router_options

提示

  • 只读表:任何 UPDATE/DELETE 都会导致 Shell 报错 Metadata inconsistency。
  • 升级 Shell 或 MySQL 时会自动 ALTER 这些表,无需手工干预。