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