MySQLShell的介绍以及安装

 

01 ReplicaSet的架构

前面的文章中,我们说了ReplicaSet的基本概念和限制以及部署前的基本知识。今天我们来看InnoDB ReplicaSet部署过程中的两个重要组件之一的MySQL Shell,为了更好的理解MySQL Shell,画了一张图,如下:

通过上面的图,不难看出,MySQL Shell是运维人员管理底层MySQL节点的入口,也就是DBA执行管理命令的地方,而MySQL Router是应用程序连接的入口,它的存在,让底层的架构对应用程序透明,应用程序只需要连接MySQL Router就可以和底层的数据库打交道,而数据库的主从架构,都是记录在MySQL Router的原信息里面的。

今天,我们主要来看MySQL Shell的搭建过程。

 

02 MySQLShell的介绍以及安装

MySQL Shel是一个客户端工具,用于管理Innodb Cluster或者Innodb ReplicaSet,可以简单理解成ReplicaSet的一个入口。

它的安装过程比较简单:在MySQL官网下载对应版本的MySQL Shell即可。地址如下:

https://downloads.mysql.com/archives/shell/

这里使用8.0.20版本

下载完毕之后,在Linux服务器进行解压,然后就可以通过这个MySQL Shell来连接线上的MySQL服务了。

我的线上MySQL地址分别是:

192.168.1.10 5607

192.168.1.20 5607

可以直接通过下面的命令来连接MySQL服务:

/usr/local/mysql-shell-8.0.20/bin/mysqlsh'$user'@'$host':$port--password=$pass

成功连接之后的日志如下:

MySQLShell8.0.20

Copyright(c)2016,2020,Oracleand/oritsaffiliates.Allrightsreserved.
OracleisaregisteredtrademarkofOracleCorporationand/oritsaffiliates.
Othernamesmaybetrademarksoftheirrespectiveowners.

Type'\help'or'\?'forhelp;'\quit'toexit.
WARNING:Usingapasswordonthecommandlineinterfacecanbeinsecure.
Creatingasessionto'superdba@10.185.13.195:5607'
Fetchingschemanamesforautocompletion...Press^Ctostop.
YourMySQLconnectionidis831
Serverversion:8.0.19MySQLCommunityServer-GPL
Nodefaultschemaselected;type\use<schema>tosetone.
MySQL192.168.1.10:5607sslJS>
MySQL192.168.1.10:5607sslJS>
MySQL192.168.1.10:5607sslJS>
MySQL192.168.1.10:5607sslJS>

 

03 MySQL Shell连接数据库并创建ReplicaSet

上面已经介绍了使用MySQL Shell连接数据库的方法了,现在我们来看利用MySQL Shell来创建ReplicaSet的方法:

1、首先使用dba.configureReplicaSetInstance命令来配置副本集,并创建副本集的管理员。

MySQL192.168.1.10:5607sslJS>dba.configureReplicaSetInstance('root@192.168.1.10:5607',{clusterAdmin:"'rsadmin'@'%'"})
ConfiguringMySQLinstanceat192.168.1.10:5607foruseinanInnoDBReplicaSet...

Thisinstancereportsitsownaddressas192.168.1.10:5607
WARNING:User'rsadmin'@'%'alreadyexistsandwillnotbecreated.However,itismissingprivileges.
Theaccount'rsadmin'@'%'ismissingprivilegesrequiredtomanageanInnoDBcluster:
GRANTREPLICATION_APPLIERON*.*TO'rsadmin'@'%'WITHGRANTOPTION;
Dba.configureReplicaSetInstance:Theaccount'root'@'192.168.1.10'ismissingprivilegesrequiredtomanageanInnoDBcluster.(RuntimeError)

可以看到,上面的命令中,我们配置了副本集的一个实例:192.168.1.10:5607,并创建了一个管理员账号rsadmin,同时这个管理员拥有clusterAdmin的权限。

返回的结果中,有一个报错信息,它提示我们登陆的root账号少了replication_applier的权限,因此无法使用root账号对rsadmin账号授权。我们给root账号补充replication_applier权限之后,重新执行上面的命令,结果如下:

MySQL192.168.1.10:5607sslJS>dba.configureReplicaSetInstance('root@192.168.1.10:5607',{clusterAdmin:"'rsadmin'@'%'"})
ConfiguringMySQLinstanceat192.168.1.10:5607foruseinanInnoDBReplicaSet...

Thisinstancereportsitsownaddressas192.168.1.10:5607
User'rsadmin'@'%'alreadyexistsandwillnotbecreated.

Theinstance'192.168.1.10:5607'isvalidtobeusedinanInnoDBReplicaSet.

Theinstance'192.168.1.10:5607'isalreadyreadytobeusedinanInnoDBReplicaSet.

这次执行成功了。

我们登陆到底层的192.168.1.10上,查看rsadmin账号,可以发现,账号已经生成了,信息如下:

selectuser,host,concat(user,"@'",host,"'"),authentication_stringfrommysql.userwhereuserlike"%%rsadmin";
+---------+------+----------------------------+-------------------------------------------+
|user|host|concat(user,"@'",host,"'")|authentication_string|
+---------+------+----------------------------+-------------------------------------------+
|rsadmin|%|rsadmin@'%'|*2090992BE9B9B27D89906C6CB13A8512DF49E439|
+---------+------+----------------------------+-------------------------------------------+
1rowinset(0.00sec)

showgrantsforrsadmin@'%';
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|Grantsforrsadmin@%|
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|GRANTSELECT,RELOAD,SHUTDOWN,PROCESS,FILE,SUPER,EXECUTE,REPLICATIONSLAVE,REPLICATIONCLIENT,CREATEUSERON*.*TO`rsadmin`@`%`WITHGRANTOPTION|
|GRANTBACKUP_ADMIN,CLONE_ADMIN,PERSIST_RO_VARIABLES_ADMIN,SYSTEM_VARIABLES_ADMINON*.*TO`rsadmin`@`%`WITHGRANTOPTION|
|GRANTINSERT,UPDATE,DELETEON`mysql`.*TO`rsadmin`@`%`WITHGRANTOPTION|
|GRANTINSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,INDEX,ALTER,CREATETEMPORARYTABLES,LOCKTABLES,EXECUTE,CREATEVIEW,SHOWVIEW,CREATEROUTINE,ALTERROUTINE,EVENT,TRIGGERON`mysql_innodb_cluster_metadata`.*TO`rsadmin`@`%`WITHGRANTOPTION|
|GRANTINSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,INDEX,ALTER,CREATETEMPORARYTABLES,LOCKTABLES,EXECUTE,CREATEVIEW,SHOWVIEW,CREATEROUTINE,ALTERROUTINE,EVENT,TRIGGERON`mysql_innodb_cluster_metadata_bkp`.*TO`rsadmin`@`%`WITHGRANTOPTION|
|GRANTINSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,INDEX,ALTER,CREATETEMPORARYTABLES,LOCKTABLES,EXECUTE,CREATEVIEW,SHOWVIEW,CREATEROUTINE,ALTERROUTINE,EVENT,TRIGGERON`mysql_innodb_cluster_metadata_previous`.*TO`rsadmin`@`%`WITHGRANTOPTION|
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
6rowsinset(0.00sec)

注意,如果我们加入的副本集实例是当前连接的实例,那么也可以使用简单的写法:

dba.configureReplicaSetInstance('',{clusterAdmin:"'rsadmin'@'%'"})

2、使用dba.createReplicaSet命令创建副本集,并将结果保存在一个变量里面,如下:

MySQL192.168.1.10:5607sslJS>varrs=dba.createReplicaSet("yeyz_test")
Anewreplicasetwithinstance'192.168.1.10:5607'willbecreated.

*CheckingMySQLinstanceat192.168.1.10:5607

Thisinstancereportsitsownaddressas192.168.1.10:5607
192.168.1.10:5607:Instanceconfigurationissuitable.

*Updatingmetadata...

ReplicaSetobjectsuccessfullycreatedfor192.168.1.10:5607.
Users.addInstance()toaddmoreasynchronouslyreplicatedinstancestothisreplicasetandrs.status()tocheckitsstatus.

可以看到,我们创建了一个yeyz_test的副本集,并将结果保存在变量rs当中。

3、使用rs.status()查看当前的副本集成员

MySQL192.168.1.10:5607sslJS>rs.status()
{
"replicaSet":{
"name":"yeyz_test",
"primary":"192.168.1.10:5607",
"status":"AVAILABLE",
"statusText":"Allinstancesavailable.",
"topology":{
"192.168.1.10:5607":{
"address":"192.168.1.10:5607",
"instanceRole":"PRIMARY",
"mode":"R/W",
"status":"ONLINE"
}
},
"type":"ASYNC"
}
}

这里面,可以看到,当前ReplicaSet里面已经有192.168.1.10:5607这个实例的,他的状态是available,他的角色是Primary。

4、此时我们使用rs.addInstance命令加入第2个节点,并使用rs.status查看状态。

这里需要注意,加入第二个节点的时候,有一个数据同步的过程,这个数据同步有2中策略:

策略一:全量恢复

使用MySQL Clone组件,然后使用克隆快照来覆盖新实例上面的所有数据。这种方法非常适合空白实例加入到Innodb 副本集中。

策略二:增量恢复

它依赖MySQL的复制功能,将所有的丢失的事务复制到新实例上,如果新实例上的事务很少,则这个过程会很快。这个方法需要保证集群中至少存在一个实例,它保存了这些缺失事务的binlog,如果缺失的事务的binlog已经清理,则这个方法不能使用。

当一个实例加入一个集群的时候,MySQL Shell会自动尝试挑选一个合适的策略来同步数据,不需要人为干预,如果它无法安全的选择同步方法,则会提供给DBA一个选项,让你选择是通过Clone或者增量同步的方法来实现数据同步。

下面的例子中,就是通过自动选择增量同步的方法来同步数据的:

MySQL192.168.1.10:5607sslJS>rs.addInstance("192.168.1.20:5607")
WARNING:ConcurrentexecutionofReplicaSetoperationsisnotsupportedbecausetherequiredMySQLlockserviceUDFscouldnotbeinstalledoninstance'10.41.28.127:5607'.
MakesuretheMySQLlockservicepluginisavailableonallinstancesifyouwanttobeabletoexecutesomeoperationsatthesametime.Theoperationwillcontinuewithoutconcurrentexecutionsupport.

Addinginstancetothereplicaset...

*Performingvalidationchecks

Thisinstancereportsitsownaddressas192.168.1.20:5607
192.168.1.20:5607:Instanceconfigurationissuitable.

*Checkingasyncreplicationtopology...

*Checkingtransactionstateoftheinstance...
Thesafestandmostconvenientwaytoprovisionanewinstanceisthroughautomaticcloneprovisioning,whichwillcompletelyoverwritethestateof'192.168.1.20:5607'withaphysicalsnapshotfromanexistingreplicasetmember.Tousethismethodbydefault,setthe'recoveryMethod'optionto'clone'.

WARNING:ItshouldbesafetorelyonreplicationtoincrementallyrecoverthestateofthenewinstanceifyouaresureallupdateseverexecutedinthereplicasetweredonewithGTIDsenabled,therearenopurgedtransactionsandthenewinstancecontainsthesameGTIDsetasthereplicasetorasubsetofit.Tousethismethodbydefault,setthe'recoveryMethod'optionto'incremental'.

Incrementalstaterecoverywasselectedbecauseitseemstobesafelyusable.

*Updatingtopology
**Configuring192.168.1.20:5607toreplicatefrom192.168.1.10:5607
**WaitingfornewinstancetosynchronizewithPRIMARY...

Theinstance'192.168.1.20:5607'wasaddedtothereplicasetandisreplicatingfrom192.168.1.20:5607.

MySQL192.168.1.10:5607sslJS>
MySQL192.168.1.10:5607sslJS>rs.status()
{
"replicaSet":{
"name":"yeyz_test",
"primary":"192.168.1.10:5607",
"status":"AVAILABLE",
"statusText":"Allinstancesavailable.",
"topology":{
"192.168.1.10:5607":{
"address":"192.168.1.10:5607",
"instanceRole":"PRIMARY",
"mode":"R/W",
"status":"ONLINE"
},
"192.168.1.20:5607":{
"address":"192.168.1.20:5607",
"instanceRole":"SECONDARY",
"mode":"R/O",
"replication":{
"applierStatus":"APPLIED_ALL",
"applierThreadState":"Slavehasreadallrelaylog;waitingformoreupdates",
"receiverStatus":"ON",
"receiverThreadState":"Waitingformastertosendevent",
"replicationLag":null
},
"status":"ONLINE"
}
},
"type":"ASYNC"
}
}

加入第二个节点之后,可以看到,再次使用rs.status来查看副本集的结构,可以看到Secondary节点已经出现了,就是我们新加入的192.168.1.20:5607

当然我们可以分别使用下面的命令查看更详细的输出:

rs.status({extended:0})

rs.status({extended:1})

rs.status({extended:2})

不同的级别,显示的信息有所不同,等级越高,信息约详细。

这里不得不说一个小的bug,官方文档建议写法是:

ReplicaSet.status(extended=1)

原文如下:

The output ofReplicaSet.status(extended=1)is very similar toCluster.status(extended=1), but the main difference is that thereplicationfield is always available because InnoDB ReplicaSet relies on MySQL Replication all of the time, unlike InnoDB Cluster which uses it during incremental recovery. For more information on the fields, seeChecking a cluster's Status withCluster.status().

但是实际操作过程中,这种写法会报错,如下:

MySQL192.168.1.10:5607sslJS>sh.status(extended=1)
Youareconnectedtoamemberofreplicaset'yeyz_test'.
ReplicaSet.status:Argument#1isexpectedtobeamap(ArgumentError)

不知道算不算一个bug。

5.搭建好副本集之后,查看primary节点的元信息库表,并在primary写入数据,查看数据是否可以同步。

[(none)]17:41:10>showdatabases;
+-------------------------------+
|Database|
+-------------------------------+
|information_schema|
|mysql|
|mysql_innodb_cluster_metadata|
|performance_schema|
|sys|
|zjmdmm|
+-------------------------------+
6rowsinset(0.01sec)

[(none)]17:41:29>usemysql_innodb_cluster_metadata
Databasechanged
[mysql_innodb_cluster_metadata]17:45:12>showtables;
+-----------------------------------------+
|Tables_in_mysql_innodb_cluster_metadata|
+-----------------------------------------+
|async_cluster_members|
|async_cluster_views|
|clusters|
|instances|
|router_rest_accounts|
|routers|
|schema_version|
|v2_ar_clusters|
|v2_ar_members|
|v2_clusters|
|v2_gr_clusters|
|v2_instances|
|v2_router_rest_accounts|
|v2_routers|
|v2_this_instance|
+-----------------------------------------+
15rowsinset(0.00sec)

[mysql_innodb_cluster_metadata]17:45:45>select*fromrouters;
Emptyset(0.00sec)

[(none)]17:45:52>createdatabaseyeyazhou;
QueryOK,1rowaffected(0.00sec)

可以看到,Primary节点上有一个元信息数据库mysql_innodb_cluster_metadata,里面保存了一些原信息,我们查看了router表,发现里面没有数据,原因是我们没有配置MySQL Router。后面的文章中会写到MySQL Router的配置过程。

在Primary上创建一个数据库yeyazhou,可以发现,在从库上也已经出现了对应的DB,

192.168.1.20[(none)]17:41:41>showdatabases;
+-------------------------------+
|Database|
+-------------------------------+
|information_schema|
|mysql|
|mysql_innodb_cluster_metadata|
|performance_schema|
|sys|
|yeyazhou|
|zjmdmm|
+-------------------------------+
7rowsinset(0.00sec)

说明副本集的复制关系无误。

至此,整个MySQL Shell连接MySQL实例并创建ReplicatSet的过程搭建完毕。

下一篇文章讲述MySQL Router的搭建过程,以及如何使用MySQL Router来访问底层的数据库。

以上就是MySQLShell的介绍以及安装的详细内容,更多关于MySQL Shell的资料请关注编程宝库其它相关文章!

 01 MySQL Router介绍 前面的文章中,我们说了ReplicaSet的基本概念MySQL Shell工具以及如何使用MySQL Shell搭建Innodb Replicaset。今 ...