mysql-shell

MySQL Shell 管理与 InnoDB Cluster

补充说明

MySQL Shell 提供 SQL、JavaScript、Python 三种模式，管理 InnoDB Cluster、升级检查和备份工具。命令是 mysqlsh。

常用示例

mysqlsh --uri app@db1:3306
mysqlsh --uri app@db1:3306 --sql -e 'SELECT VERSION();'
mysqlsh --uri app@db1:3306 --file init.sql
mysqlsh --uri app@db1:3306 --js -e 'util.checkForServerUpgrade()'
mysqlsh --uri admin@db1:3306

InnoDB Cluster：

dba.configureInstance()
dba.createCluster("prod")
cluster.status()
cluster.addInstance("db2:3306")
cluster.removeInstance("db2:3306")
cluster.switchToMultiPrimaryMode()
cluster.switchToSinglePrimaryMode()

易错点与排错

• URI 格式和认证方式要正确；--uri user@host:port，不是 JDBC。
• 默认进入 JS 模式；执行 SQL 要 --sql 或在交互里 \sql。
• InnoDB Cluster 需要 MySQL 8+、GTID 和正确的复制配置。
• dba.configureInstance() 会修改配置并可能重启实例；生产先评估。
• 升级检查 util.checkForServerUpgrade() 只做检查，不自动修复。
• 集群元数据在 mysql_innodb_cluster_metadata 库；不要手改。
• 版本和 Router 版本要匹配。

相关命令

• mysql — 传统客户端
• mysql-router — 集群路由
• mysqlsh — 管理 Shell