关于数据库:图文结合丨带你轻松玩转MySQL-Shell-for-GreatSQL

一、引言

1.1 什么是 MySQL Shell ?

MySQL Shell 是 MySQL 的一个高级客户端和代码编辑器，是第二代 MySQL 客户端。第一代 MySQL 客户端即咱们罕用的 MySQL。除了提供相似于 MySQL 的 SQL 性能外，MySQL Shell 还提供 JavaScript 和 Python 脚本性能，并包含与 MySQL 一起应用的 API。MySQL Shell 除了能够对数据库里的数据进行操作，还能够对数据库进行治理，特地是对 MGR 的反对，应用 MySQL Shell 能够十分不便的对 MGR 进行搭建、治理、配置等

1.2 什么是 MySQL Shell for GreatSQL ?

MySQL Shell for GreatSQL 的呈现是因为在 GreatSQL 8.0.25-16 版本的时候引入了 MGR 仲裁节点（投票节点）的新个性，MySQL 提供的 MySQL Shell 无奈辨认该个性，因而咱们提供了 MySQL Shell for GreatSQL 版本，以下就称为MySQL Shell for GreatSQL

然而！因为 JS 库中含有商业库，所以 GreatSQL 社区在编译的时候就没有加上 JS 的脚本性能。

大家应用的时候不要始终输出 \js 说怎么切换不过来了 :)

不过 Python 模式的语法和 JavaScript 模式的语法是大同小异的，举个例子：

不过就是变量名命名格调些许不同而已，实质上是没有区别的。本文也将应用 GreatSQL Shell-8.0.25-16 中 Python 模式来带你玩转 MySQL Shell for GreatSQL

二、装置与配置

2.1 装置 MySQL Shell for GreatSQL

首先咱们先下载 MySQL Shell for GreatSQL，下载地址在 GreatSQL 的 gitee 仓库，和咱们的 GreatSQL 8.0.32-24 新版本放在一起：https://gitee.com/GreatSQL/GreatSQL/releases/tag/GreatSQL-8.0…。进入下载文件列表最下方就是咱们的 MySQL Shell for GreatSQL，大家按机器和架构下载对应版本~

本文机器环境是 CentOS7.9-x86-64 所以下载第一个即可

$ cat /etc/system-release
CentOS Linux release 7.9.2009 (Core)

$ uname -a
Linux hy 3.10.0-1160.el7.x86_64 #1 SMP Mon Oct 19 16:18:59 UTC 2020 x86_64 x86_64 x86_64 GNU/Linux

下载实现后解压：

$ tar -xvf greatsql-shell-8.0.25-16-Linux-glibc2.17-x86_64.tar.xz

接着把 bin 目录增加到环境变量中：

$ echo "export PATH=$PATH:/usr/local/greatsql-shell-8.0.25-16-Linux-glibc2.17-x86_64/bin" >> /root/.bash_profile

MySQL Shell for GreatSQL 须要 Python 3.6 的环境，如果没有环境的话，须要装置yum install python3 -y

$ python3 -V
Python 3.6.8

所有准备就绪！就能够开始应用 MySQL Shell for GreatSQL 了

$ mysqlsh

2.2 界面特色

MySQL Shell for GreatSQL 的界面如下：

仔细的同学就会发现，有一个 WARNING，没关系咱们依据提醒看下 mysqlsh.log

$ cat /root/.mysqlsh/mysqlsh.log

在日志中发现这样一段提醒，意思就是少了一个 Python 的模块 certifi

ModuleNotFoundError: No module named 'certifi'

解决办法就是用 pip 来装置下这个缺失的模块即可：

$ pip3.6 install --user certifi

再次进入 MySQL Shell for GreatSQL $ mysqlsh

当初就没有厌恶的 WARNING 了 :）

MySQL Shell for GreatSQL 同时也是反对定义本人的提示符的，在 promt 目录下，有许多的模板可供使用

$ ls /usr/local/GreatSQLshell/greatsql-shell-8.0.25-16-Linux-glibc2.17-x86_64/share/mysqlsh/prompt
prompt_16.json      prompt_256.json       prompt_256pl.json    prompt_dbl_256.json       prompt_dbl_256pl.json  README.prompt
prompt_256inv.json  prompt_256pl+aw.json  prompt_classic.json  prompt_dbl_256pl+aw.json  prompt_nocolor.json

应用形式如下, 例如我想换成这个模板prompt_16.json

$ export MYSQLSH_PROMPT_THEME=/usr/local/GreatSQLshell/greatsql-shell-8.0.25-16-Linux-glibc2.17-x86_64/share/mysqlsh/prompt/prompt_16.json  

再进入 MySQL Shell for GreatSQL 看看曾经变了个样子

当然也能够自行批改.json 文件，批改成你喜爱的自定义配置，这都是没问题的

当初的 MySQL Shell for GreatSQL 是没法应用的，因为咱们是用 $ mysqlsh 命令间接登录到 Shell 环境，因为未携带登录验证信息（user、host、password）等处于未连贯服务状态，在外部应用 \c \h 等繁难命令外，执行其它获取服务器信息的命令会报 Not Connected.

三、基本操作和应用

3.1 连贯数据库实例

MySQL Shell for GreatSQL 提供了多种连贯实例登录形式，能够依据本人爱好抉择

$ mysqlsh --help

... 下面省略局部...
Usage examples:
$ mysqlsh root@localhost/schema
$ mysqlsh mysqlx://root@some.server:3307/world_x
$ mysqlsh --uri root@localhost --py -f sample.py sample param
$ mysqlsh root@targethost:33070 -s world_x -f sample.js
$ mysqlsh -- util check-for-server-upgrade root@localhost --output-format=JSON
$ mysqlsh mysqlx://user@host/db --import ~/products.json shop

这里抉择 MySQL Shell for GreatSQL sock 的形式连贯数据库实例

$ mysqlsh -S/data/GreatSQL/mgr01/mysql.sock root@localhost

用 sock 形式连贯数据库实例会让输出明码，而后会问是否保留明码

Please provide the password for 'root@localhost': // 这里输出明码
Save password for 'root@localhost'? [Y]es/[N]o/Ne[v]er (default No): y // 是否保留明码

一旦存储了服务器 URL 的明码，每当 MySQL Shell for GreatSQL 关上会话时，它都会从已配置的 Secret Store Helper 中检索明码，登录到服务器，而无需交互输出明码。MySQL Shell for GreatSQL 执行的脚本也是如此。如果未配置任何 Secret Store Helper，则以交互方式申请明码。

留神！MySQL Shell for GreatSQL 仅通过 Secret Store 保留服务器 URL 和明码，而不自行保留明码。

明码只有在 手动输出 时才会保留。如果在运行 MySQL Shell for GreatSQL 时应用相似于服务器 URI 的连贯字符串或在命令行中提供了明码，则该明码不会保留。

连贯到 MySQL Shell for GreatSQL 所承受的最大明码长度为 128 个字符。

3.2 根本命令

MySQL Shell for GreatSQL 的因为命令须要独立于执行模式而可用，因而它们以转义序列 \ 字符结尾，简略列举几个：

3.3 根本用法

Ⅰ、切换 SQL 模式 \sql，在 SQL 模式下按 Tab 键 能够实现主动补全哦!

GreatSQL Py > \sql
Switching to SQL mode... Commands end with ;

Ⅱ、可在任何语言状态执行操作系统命令 \system

GreatSQL Py > \system ls /usr/local
greatsql-shell-8.0.25-16-Linux-glibc2.17-x86_64.tar.xz    GreatSQL8.0.32

Ⅲ、查看历史命令 \history，选项 history.maxSize 为 MySQL Shell for GreatSQL 的最大存储条数，默认为 1000 条轮替。

GreatSQL Py > \history
    1  \system ls /usr/local
    2  /history
    3  history
    4  help()
    5  /hasattr()

默认历史只能保留以后会话命令，全局不可见，退出后主动删除。可通过启用 history.autoSave 选项保留会话之间的历史记录。

3.4 全局对象

MySQL Shell for GreatSQL 启动时，能够应用以下模块和对象

• dba：用于 InnoDB Cluster、ReplicaSet 治理；
• mysql：反对应用经典 MySQL 协定连贯到 MySQL 服务器，容许执行 SQL；
• mysqlx：用于通过 MySQL X DevAPI 解决 X 协定会话；
• os：容许拜访容许与操作系统交互的性能；
• session：代表以后关上的 MySQL 会话；
• shell：容许拜访通用性能和属性；
• sys：容许拜访零碎特定的参数；
• util：对诸如降级查看器和 JSON 导入之类的各种工具进行了分组；

四、备份和复原

MySQL Shell for GreatSQL 有 Dump & Load 工具，比 mydumper 更快的逻辑备份工具，与 myloader 不一样的是，MySQL Shell for GreatSQL Load 是通过 LOAD DATA LOCAL INFILE 命令来导入数据的。而 LOAD DATA 操作，依照官网文档的说法，比 INSERT 操作快 20 倍。该序列工具包含：

• util.dump_instance()：备份整个数据库实例，包含用户
• util.dump_schemas()：备份指定数据库 schema
• util.dump_tables()：备份指定的表或视图
• util.load_dump()：复原备份

咱们来入手操作下，筹备一个表空间有 724MB 的表内含七百万条数据

greatsql> select count(*) from student1;
+----------+
| count(*) |
+----------+
|  7000000 |
+----------+
1 row in set (2.62 sec)

greatsql> system ls -l /data/GreatSQL/mgr01/test
-rw-r----- 1 mysql mysql 759169024 7 月  25 12:15 student1.ibd

4.1 备份整个数据库实例，包含用户

dump_instance(outputUrl[, options])，备份整个数据库实例，包含用户

• outputUrl 是备份目录，不能为空。
• options 是可指定的选项

options 有什么选项能够应用 \? dump_instance 查看

GreatSQL Py > \? dump_instance
The following options are supported:// 找到这句上面就是

应用起来也是有限度的，官网原文：

Requirements
- MySQL Server 5.7 or newer is required.
- File size limit for files uploaded to the OCI bucket is 1.2 TiB.
- Columns with data types which are not safe to be stored in text form
  (i.e. BLOB) are converted to Base64, hence the size of such columns
  cannot exceed approximately 0.74 * max_allowed_packet bytes, as
  configured through that system variable at the target server.
- Schema object names must use latin1 or utf8 character set.
- Only tables which use the InnoDB storage engine are guaranteed to be
dumped with consistent data.

简略来说就是

• "最好是 INNODB 的数据引擎"
• "版本在 5.7 及以上"
• "必须应用 latin1 或 utf8 字符集"
• "要有 BACKUP_ADMIN 权限"

话不多说，开始入手尝试吧

GreatSQL Py > util.dump_instance("/data/backups",{"compression": "none","threads":"16"})
Acquiring global read lock
Global read lock acquired
Gathering information - done
All transactions have been started
Locking instance for backup
Global read lock has been released
Writing global DDL files
Writing users DDL
... 两头省略
1 thds dumping - 109% (19.00M rows / ~17.37M rows), 263.77K rows/s, 54.42 MB/s            
Duration: 00:01:05s                                                           
Schemas dumped: 3                                                             
Tables dumped: 11                                                             
Data size: 3.05 GB                                                            
Rows written: 19000005                                                        
Bytes written: 3.05 GB                                                        
Average throughput: 46.80 MB/s

留神！compression:“none”指的是不压缩，这里设置为不压缩次要是为了不便查看数据文件的内容。线上应用倡议开启压缩

开启 16 线程，速度还是蛮快的，接下来咱们看下数据目录

$ ll /data/backups/
#有好多这里就列举几个
-rw-r----- 1 root root     5773 8 月   2 11:28 @.done.json
-rw-r----- 1 root root     1119 8 月   2 11:27 @.json
-rw-r----- 1 root root      231 8 月   2 11:27 @.post.sql
-rw-r----- 1 root root      231 8 月   2 11:27 @.sql
-rw-r----- 1 root root      458 8 月   2 11:27 test.json
-rw-r----- 1 root root 24536863 8 月   2 11:27 test@student1@0.tsv

• @.done.json：会记录备份的完结工夫，备份集的大小, 备份完结时生成。
• @.json：会记录备份的一些元数据信息，包含备份时的一致性地位点信息：binlogFile，binlogPosition 和 gtidExecuted，这些信息可用来建设复制。
• @.sql，@.post.sql：这两个文件只有一些正文信息。不过在通过 util.loadDump 导入数据时，咱们能够通过这两个文件自定义一些 SQL。其中，@.sql 是数据导入前执行，@.post.sql 是数据导入后执行。
• sbtest.json：记录 sbtest 中曾经备份的表、视图、定时器、函数和存储过程。
• *.tsv：数据文件。

咱们看看数据文件的内容：

$ head -3 test@student1@0.tsv
1       Kathleen Ford   F       344 Jiangnan West Road, Haizhu District 139-1119-0424   163     lin4brNtHD      918
2       David Mitchell  M       355 Papworth Rd, Trumpington    5892 672144     702     qoA6axcT6u      218
3       Lin Yunxi       M       620 Hanover Street      7091 590385     194     Tl4LY3UmgY      765

TSV 格局，每一行贮存一条记录，字段与字段之间用制表符（\t）分隔。

• test@student1.json：记录了表相干的一些元数据信息，如列名，字段之间的分隔符（fieldsTerminatedBy）等。
• test@student1.sql：sbtest.sbtest1 的建表语句。
• test.sql：建库语句。如果这个库中存在存储过程、函数、定时器，也是写到这个文件中。
• @.users.sql：创立账号及受权语句。默认不会备份 mysql.infoschema，mysql.session，mysql.sys 这三个外部账号。

4.2 备份指定数据库

util.dump_schemas(schemas, outputUrl[, options])备份指定库的数据。

其中，第一个 schemas 参数必须为数组，第二个是备份目录

GreatSQL Py > util.dump_schemas(["test"],"/data/backup_schemas",{"threads":"16"})
Acquiring global read lock
Global read lock acquired
Gathering information - done
All transactions have been started
... 两头省略...
1 thds dumping - 109% (19.00M rows / ~17.37M rows), 530.98K rows/s, 49.34 MB/s uncompressed, 22.02 MB/s compressed    
Duration: 00:00:58s                                                                      
Schemas dumped: 1    
Tables dumped: 4
Uncompressed data size: 3.05 GB
Compressed data size: 1.57 GB
Compression ratio: 1.9
Rows written: 19000000
Bytes written: 1.57 GB
Average uncompressed throughput: 52.35 MB/s
Average compressed throughput: 26.96 MB/s 

当然从 MySQL Shell 8.0.28 版本开始，可间接应用 util.dumpInstance 中的 includeSchemas 选项进行指定库的备份。

上面展现下在 MySQL Shell version 8.0.34 版本下的内容和介绍

- includeSchemas: list of strings (default: empty) - List of schemas to
  be included in the dump.

GreatSQL Py > util.dump_instance("/data/backups",{"includeSchemas":["test"],"threads":"16"})

如果想要更高的版本的 MySQL Shell for GreatSQL，能够参考文章“MySQL Shell 8.0.32 for GreatSQL 编译装置 https://mp.weixin.qq.com/s/TzR-Szitdd2ocOqwJaaqEQ”

4.3 备份指定表

util.dump_tables(schema, tables, outputUrl[, options])备份指定表的数据

用法和下面两个雷同，tables参数必须为数组

GreatSQL localhost  Py > util.dump_tables("test",["student1"],"/data/backup_table",{"threads":"16"})
Acquiring global read lock
Global read lock acquired
Gathering information - done
All transactions have been started
... 两头省略...
1 thds dumping - 110% (7.00M rows / ~6.31M rows), 539.12K rows/s, 44.17 MB/s uncompressed, 18.75 MB/s compressed   
Duration: 00:00:12s
Schemas dumped: 1
Tables dumped: 1
Uncompressed data size: 572.88 MB
Compressed data size: 242.92 MB
Compression ratio: 2.4
Rows written: 7000000
Bytes written: 242.92 MB
Average uncompressed throughput: 44.50 MB/s      
Average compressed throughput: 18.87 MB/s   

当然从 MySQL Shell 8.0.28 开始，可间接应用 util.dumpInstance 中的 includeTables 选项进行指定表的备份。

- includeTables: list of strings (default: empty) - List of tables or
  views to be included in the dump in the format of schema.table.

GreatSQL Py > util.dump_instance("/data/backups",{"includeTables":["test.test"],"threads":"16"})

4.4 导入生成的备份

util.load_dump(url[, options])用于导入通过 dump 命令生成的备份集

导入前，记得先关上”local_infile“参数设置set global local_infile = ON;

GreatSQL Py > util.load_dump("/data/backup_table",{"threads":"16"})

如果想再导入一次，要把 resetProgress 设置为 True

GreatSQL Py > util.load_dump("/data/backup_table",{"threads":"16","resetProgress":True})

当然，咱们也做过导入速度测试，下附测试后果，具体比照文章见”myloader 导入更快吗？并没有 … https://mp.weixin.qq.com/s/b3q27ZMmWJ0tX5wQkzFpIQ“

从下面图表看出，尽管 util.load_dump 很快，但还是比 GreatSQL 8.0.32-24 自带的 并行 load data速度慢了一些，并行 load data 实用于频繁导入大批量数据的利用场景，性能可晋升约 20+ 倍。详情可见 5 -enhance/5-1-highperf-parallel-load.md · 万里数据库 /GreatSQL-Manual – Gitee.com

4.5 参数解析

• analyzeTables：可选参数 on/off/histogram；表加载结束后，是否执行 ANALYZE TABLE 操作。默认是 off（不执行），histogram（只对有直方图信息的表执行）
• characterSet：字符集，无需显式设置，默认会从备份集中获取。
• createInvisiblePKs：是否创立隐式主键，默认从备份集中获取。
• deferTableIndexes：可选参数 off（不提早）/fulltext（只提早创立全文索引，默认值）/all（提早创立所有索引）；是否提早（数据加载结束后）创立二级索引。
• dryRun: 试运行。此时只会打印备份信息，不会执行备份操作。
• excludeSchemas: 疏忽某些库的备份，多个库之间用逗号隔开 excludeSchemas: [“db1”, “db2”]
• excludeTables: 疏忽某些表的备份，表必须是 库名. 表名 的格局，多个表之间用逗号隔开 excludeTables: [“sbtest.sbtest1”, “sbtest.sbtest2”]
• excludeUsers: 疏忽某些账号的备份，可指定多个账号。
• ignoreExistingObjects: 是否疏忽曾经存在的对象，默认为 off。
• ignoreVersion: 疏忽 MySQL 的版本检测。默认状况下，要求备份实例和导入实例的大版本统一。
• includeSchemas: 指定某些库的备份。
• includeTables: 指定某些表的备份。
• includeUsers: 指定某些账号的备份，可指定多个账号。
• loadData: 是否导入数据，默认为 true。
• loadDdl: 是否导入 DDL 语句，默认为 true。
• loadIndexes: 与 deferTableIndexes 一起应用，用来决定数据加载结束后，最初的二级索引是否创立，默认为 true。
• loadUsers: 是否导入账号，默认为 false。留神，即便将 loadUsers 设置为 true，也不会导入以后正在执行导入操作的用户。
• progressFile: 在导入的过程中，会在备份目录生成一个 progressFile，用于记录加载过程中的进度信息，这个进度信息可用来实现断点续传性能。默认为 load-progress…progress。
• resetProgress: 如果备份目录中存在 progressFile，默认会从上次实现的中央继续执行。如果要从头开始执行，需将 resetProgress 设置为 true。该参数默认为 off。
• schema: 将表导入到指定 schema 中，实用于通过 util.dumpTables 创立的备份。
• showMetadata: 导入时是否打印一致性备份时的地位点信息。
• showProgress: 是否打印进度信息。
• skipBinlog: 是否设置 sql_log_bin=0，默认 false。这一点与 mysqldump、mydumper 不同，前面这两个工具默认会禁用 Binlog。
• threads: 并发线程数，默认为 4。
• updateGtidSet: 更新 GTID_PURGED。可设置：off（不更新，默认值）, replace（代替指标实例的 GTID_PURGED）, append（追加）。
• waitDumpTimeout:util.loadDump 可导入以后正在备份的备份集。解决完所有文件后，如果备份还没有完结（具体来说，是备份集中没有生成 @.done.json），util.loadDump 会报错退出，可指定 waitDumpTimeout 期待一段时间，单位秒。
• osBucketName:osNamespace，ociConfigFile，ociProfile，ociParManifest，ociParExpireTime：OCI 对象存储相干。
• osNamespace:OCI 对象存储相干。
• ociConfigFile:OCI 对象存储相干。
• ociProfile:OCI 对象存储相干。

4.6 应用注意事项

• 导入时，留神 max_allowed_packet 的限度，导入之前，需将指标实例的 local_infile 设置为 ON。
• 该工具属于客户端工具，生成的文件在客户端。
• 导出的时候，导出门路下不能有文件。
• 表上存在主键或惟一索引能力进行 chunk 级别的并行备份。字段的数据类型不限。不像 mydumper，分片键只能是整数类型。
• 对于不能进行并行备份的表，目前会备份到一个文件中。如果该文件过大，不必放心大事务的问题，util.loadDump 在导入时会主动进行切割。
• util.dumpInstance 只能保障 InnoDB 表的备份一致性。
• 默认不会备份 information_schema，mysql，ndbinfo，performance_schema，sys。
• 备份实例反对 GreatSQL/MySQL 5.6 及以上版本，导入实例反对 GreatSQL/MySQL 5.7 及以上版本。
• 备份的过程中，会将 BLOB 等非文本平安的列转换为 Base64，由此会导致转换后的数据大小超过原数据。

五、疾速搭建 MGR 集群

能够用 MySQL Shell for GreatSQL 来搭建 MGR 集群 或接管现有集群十分的方便快捷。加上 GreatSQL 针对 MGR 做了大量的改良和晋升工作，进一步晋升 MGR 的高牢靠等级。

快捷的部署 + 好用的 GreatSQL MGR 为什么不必呢？

5.1 部署筹备

采纳的是一个单机多实例的部署形式，如何部署单机多实例能够返回 6 -oper-guide/6-6-multi-instances.md · 万里数据库 /GreatSQL-Manual – Gitee.com

接下来再把 MySQL Shell for GreatSQL 下载安装实现，即可开始部署。

留神！本次部署皆采纳 Shell 的 Python 模式

5.2 开始部署

利用 MySQL Shell for GreatSQL 构建 MGR 集群比较简单，次要有几个步骤：

1. 查看实例是否满足条件。
2. 创立并初始化一个集群。
3. 一一增加实例。

首先，用管理员账号 root 连贯到第一个节点：

$ mysqlsh -S/data/GreatSQL/mgr01/mysql.sock root@localhost
MySQL Shell 8.0.25

应用 \s 命令查看以后节点状态，确保连贯失常可用

执行 dba.configure_instance() 命令开始查看以后实例是否满足装置 MGR 集群的条件，如果不满足能够间接配置成为 MGR 集群的一个节点：

GreatSQL Py > dba.configure_instance()
Configuring local MySQL instance listening at port 3306 for use in an InnoDB cluster...

This instance reports its own address as 172.17.139.77:3306
#提醒以后的用户是管理员，不能间接用于 MGR 集群，须要新建一个账号
ERROR: User 'root' can only connect from 'localhost'. New account(s) with proper source address specification to allow remote connection from all instances must be created to manage the cluster.
1) Create remotely usable account for 'root' with same grants and password
2) Create a new admin account for InnoDB cluster with minimal required grants
3) Ignore and continue
4) Cancel
Please select an option [1]: 2 #这里抉择 2，即创立一个最小权限账号

接着输出要创立用户的用户名、明码即可

Please provide an account name (e.g: icroot@%) to have it created with the necessary
privileges or leave empty and press Enter to cancel.
Account Name: GreatSQL  #用户名
Password for new account:  #明码
Confirm password:    #确认明码

applierWorkerThreads will be set to the default value of 4.

The instance '172.17.139.77:3306' is valid to be used in an InnoDB cluster.

Cluster admin user 'GreatSQL'@'%' created.
The instance '172.17.139.77:3306' is already ready to be used in an InnoDB cluster.

# 这个正告音讯是通知你正在应用的零碎变量 @@slave_parallel_workers 曾经被弃用，将在将来的版本中被移除，倡议你应用新的变量名 replica_parallel_workers 来替换。WARNING: '@@slave_parallel_workers' is deprecated and will be removed in a future release. Please use replica_parallel_workers instead. (Code 1287).

Successfully enabled parallel appliers.

实现查看并创立完新用户后，退出以后的管理员账户，并用新创建的 MGR 专用账户登入，筹备初始化创立一个新集群：

GreatSQL Py > exit()

$ mysqlsh --uri GreatSQL@172.17.139.77:3306
MySQL Shell 8.0.25

这时候就能够应用咱们的 dba 工具了，定义一个变量名 c，不便上面援用

GreatSQL 172.17.139.77:3306 ssl  Py > c = dba.create_cluster('MGR1');
A new InnoDB cluster will be created on instance '172.17.139.77:3306'.

Validating instance configuration at 172.17.139.77:3306...

This instance reports its own address as 172.17.139.77:3306

Instance configuration is suitable.
NOTE: Group Replication will communicate with other members using '172.17.139.77:33061'. Use the localAddress option to override.

Creating InnoDB cluster 'MGR1' on '172.17.139.77:3306'...

Adding Seed Instance...

Cluster successfully created. Use Cluster.addInstance() to add MySQL instances.
At least 3 instances are needed for the cluster to be able to withstand up to
one server failure.

这就实现了 MGR 集群的初始化并退出第一个节点（疏导节点）。接下来，用同样办法先用 root 账号别离登入到另外两个节点，实现节点的查看并创立最小权限级别用户（此过程略过 … 留神各节点上创立的用户名、明码都要统一），之后回到第一个节点，执行 addInstance() 增加另外两个节点。

GreatSQL 172.17.139.77:3306 ssl  Py > c.add_instance('GreatSQL@172.17.139.77:3307');
#这里要指定 MGR 专用账号
... 省略...
Please select a recovery method [C]lone/[A]bort (default Abort): Clone  <-- 抉择用 Clone 形式从第一个节点全量复制数据
Validating instance configuration at 172.17.139.77:3306...
... 省略...
The instance '172.17.139.77:3306' was successfully added to the cluster.

这样节点就退出胜利了！用 c.describe() 看下集群状态，如果要显示更详细信息能够应用c.status()

GreatSQL 172.17.139.77:3306 ssl  Py > c.describe()
{
    "clusterName": "mgr1", 
    "defaultReplicaSet": {
        "name": "default", 
        "topology": [
            {
                "address": "172.17.139.77:3306", 
                "label": "172.17.139.77:3306", 
                "role": "HA"
            }, 
            {
                "address": "172.17.139.77:3307", 
                "label": "172.17.139.77:3307", 
                "role": "HA"
            }
        ], 
        "topologyMode": "Single-Primary"
    }
}

列出下 DBA 对象所有的命令：

GreatSQL 172.17.139.77:3306 ssl  Py > \help dba*
Found several entries matching dba*

• dba：命令自身提供对集群治理和实例治理的高级性能的拜访。
• dba.check_instance_configuration：查看 GreatSQL 实例的配置是否合乎 InnoDB 集群的要求。
• dba.configure_instance：配置实例以退出 InnoDB 集群，调整设置以满足集群要求。
• dba.configure_local_instance：配置本地 GreatSQL 实例以便用于 InnoDB 集群。
• dba.configure_replica_set_instance：配置正本集实例以满足正本集的要求。
• dba.create_cluster：创立一个新的 InnoDB 集群。
• dba.create_replica_set：创立一个新的 GreatSQL 正本集。
• dba.delete_sandbox_instance：删除一个现有的沙箱实例。
• dba.deploy_sandbox_instance：在本地计算机上部署一个沙箱 GreatSQL Server 实例。
• dba.drop_metadata_schema：删除现有的 InnoDB 集群元数据模式。
• dba.get_cluster：获取现有的 InnoDB 集群的援用。
• dba.get_replica_set：取现有 GreatSQL 正本集的援用。
• dba.help：显示 dba 模块的帮忙信息。
• dba.kill_sandbox_instance：杀死沙箱 GreatSQL 实例。
• dba.reboot_cluster_from_complete_outage：从齐全停机状态重新启动 InnoDB 集群。
• dba.session：获取以后 GreatSQL 会话的援用。
• dba.start_sandbox_instance：启动沙箱 GreatSQL 实例。
• dba.stop_sandbox_instance：进行沙箱 GreatSQL 实例。
• dba.upgrade_metadata：降级集群的元数据模式以使其与以后版本的 MySQL Shell for GreatSQL 兼容。
• dba.verbose：用于管制 dba 命令的具体输入。

如果要更具体的某个命令的帮忙手册，则能够 \help 后接具体的命令：

GreatSQL 172.17.139.77:3306 ssl  Py > \help dba.get_cluster

咱们 GreatSQL 社区有 ”深入浅出 MGR 系列文章“ 其中就有应用 Shell 部署[第四篇]MGR 以及治理[第五篇]：

系列文章地址：GreatSQL-Doc: GreatSQL-Doc – Gitee.com

利用 MySQL Shell 装置部署 MGR 集群：https://mp.weixin.qq.com/s/51ESDPgeuXqsgib6wb87iQ

MGR 治理保护：https://mp.weixin.qq.com/s/D5obkekTClZEdN2KQ9xiXg

有对 MGR 想理解的或深刻学习的，都能够去浏览下。

六、总结

MySQL Shell for GreatSQL 以其弱小的性能、灵活性和先进的工具集，的确为数据库管理人员和开发者关上了全新的大门。从根本的数据库操作到简单的集群治理。

对于想要充分利用 GreatSQL 性能的任何人来说，把握 MySQL Shell for GreatSQL 都是一项必备技能。无论你是老手还是经验丰富的数据库专家，心愿这篇文章都能为你的 GreatSQL 旅程提供贵重的领导和灵感。

• 参考文章：MySQL Shell 工具 – 墨天轮 (modb.pro)

Enjoy GreatSQL :)

## 对于 GreatSQL

GreatSQL 是实用于金融级利用的国内自主开源数据库，具备高性能、高牢靠、高易用性、高平安等多个外围个性，能够作为 MySQL 或 Percona Server 的可选替换，用于线上生产环境，且完全免费并兼容 MySQL 或 Percona Server。

相干链接：GreatSQL 社区 Gitee GitHub Bilibili

GreatSQL 社区：

社区博客有奖征稿详情：https://greatsql.cn/thread-100-1-1.html

技术交换群：

微信：扫码增加 GreatSQL 社区助手 微信好友，发送验证信息 加群。