mysql_innodb_cluster_metadata源数据库

目录

集群总体信息

clusters

clustersets

schema_version

实例（节点）清单

instances

v2_instances

GR 集群/视图

v2_clusters

v2_ar_clusters

async_cluster_members

Router 相关

routers

v2_routers

router_rest_accounts

v2_router_rest_accounts

v2_this_instance

ClusterSet 扩展（v2 专用）

v2_cs_clustersets

v2_cs_members

v2_cs_router_option

提示

---

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 这些表，无需手工干预。