21章InnoDB集群

包括adminapi mysql，这是通过dba全局变量和相关的方法。这个DBA变量的方法使你的部署、配置和管理集群，InnoDB。例如，使用dba.createCluster()创建一个InnoDB聚类方法。

mysql提供在线帮助的adminapi。列出所有可用的dba命令，使用help() DBA。方法在线帮助在一个特定的方法，使用通用格式object.help('methodname')。。。。。。。例如：

MySQL的JS >dba.help('getCluster')从检索元数据store.syntax DBA群集。getcluster（[名] [选项]），名称：参数指定要返回的群集的名称。选项：字典与额外的options.returns没有指定的名字或默认cluster.descriptionif名称识别聚类对象或为空，默认群集将被返回。如果名字是指定的，以显示名称不群被发现，一个误差提高。选项字典接受connecttoprimary选项，默认的真实并指出内核自动连接到在以下情形下的主要成员，cluster.exceptions metadataerror：如果元数据访问。如果元数据更新操作失败。在下列情况下argumenterror：如果群集名称是空的。如果群集名无效。如果群集是不存在的。在下列情况下运行时出错：如果当前连接不能用于组复制。

如果要测试高可用性的作品，通过实例模拟意外停止杀戮。群集检测事实实例离开集群和重新配置。究竟如何集群重新配置本身取决于你使用的是单次或多主集群，和角色实例服务集群内。

在单一的基本模式：

更多信息见第18.4.1.1，“单原模式”

在多主模式：

更多信息见第18.4.1.2，“多主模式”

有不同的方法来模拟实例离开集群，例如你可以强行停止实例MySQL服务器，或使用adminapidba.killSandboxInstance()如果测试沙盒部署。在这个例子中，假设有一个单一的初级沙盒集群部署3服务器实例和实例的监听端口3310是目前主要的。模拟实例离开集群的意外：

MySQL的JS >dba.killSandboxInstance(3310)

群集检测变化和选举新发自动。假设你的会话连接到端口6446，默认的读写mysql的经典协议端口，路由器应该检测MySQL集群的拓扑结构的变化，将你的会议，新当选的原。为了验证这一点，切换到SQL模式使用mysql\sql命令并选择实例port变量检查，例如您的会话已被重定向到。注意，第一SELECT语句失败作为原始的连接丢失。这意味着当前会话已经关闭，mysql自动重新连接你和当你发出命令再次确认新的港口。

MySQL的JS >\sql切换到SQL模式…命令结束；MySQL的SQL >SELECT @@port;错误：2013（hy000）：查询全球会议期间丢失连接到MySQL服务器断开了。正在尝试重新连接到' root@localhost：6446…全球会议成功连接MySQL的SQL >。SELECT @@port;-------- | @ @港| -------- | 3330 | -------- 1行集（0秒）

在这个例子中，在端口3330的实例被选为新的主。这表明，InnoDB群为我们提供了自动故障转移，MySQL的路由器有自动重新连接我们新的主实例，和我们的高可用性。

当MySQL Router举对集群，它记录的服务器实例的配置文件的地址。如果任何额外的实例引导以后MySQL路由器添加到群集，他们不会自动检测并因此不用于连接路由

为了确保新加入的情况下被路由到正确你必须启动MySQL集群路由器对阅读更新的元数据。这意味着你必须重新启动路由器，包括MySQL--bootstrap选项

从服务器实例之前，你需要检查每个实例上的MySQL配置正确创建生产部署。除了dba.configureInstance()，检查配置的配置实例部分，您可以使用Cheeckstance配置（）功能。这确保了实例满足21.2.2节，“InnoDB集群要求”在不改变任何配置的实例。这不检查是对实例的任何数据，看检查实例的状态更多信息。下面演示了发行这一运行mysql：

mysql-js> dba.checkInstanceConfiguration('ic@ic-1:3306')
Please provide the password for 'ic@ic-1:3306': ***
Validating MySQL instance at ic-1:3306 for use in an InnoDB cluster...

This instance reports its own address as ic-1
Clients and other cluster members will communicate with it through this address by default.
If this is not correct, the report_host MySQL system variable should be changed.

Checking whether existing tables comply with Group Replication requirements...
No incompatible tables detected

Checking instance configuration...

Some configuration options need to be fixed:
+--------------------------+---------------+----------------+--------------------------------------------------+
| Variable                 | Current Value | Required Value | Note                                             |
+--------------------------+---------------+----------------+--------------------------------------------------+
| binlog_checksum          | CRC32         | NONE           | Update the server variable                       |
| enforce_gtid_consistency | OFF           | ON             | Update read-only variable and restart the server |
| gtid_mode                | OFF           | ON             | Update read-only variable and restart the server |
| server_id                | 1             |                | Update read-only variable and restart the server |
+--------------------------+---------------+----------------+--------------------------------------------------+

Please use the dba.configureInstance() command to repair these issues.

{
    "config_errors": [
        {
            "action": "server_update",
            "current": "CRC32",
            "option": "binlog_checksum",
            "required": "NONE"
        },
        {
            "action": "restart",
            "current": "OFF",
            "option": "enforce_gtid_consistency",
            "required": "ON"
        },
        {
            "action": "restart",
            "current": "OFF",
            "option": "gtid_mode",
            "required": "ON"
        },
        {
            "action": "restart",
            "current": "1",
            "option": "server_id",
            "required": ""
        }
    ],
    "errors": [],
    "status": "error"
}

重复此过程，为每个服务器实例，你打算使用你的群集的一部分。运行后产生的报告dba.checkInstanceConfiguration()提供有关任何配置信息变化之前你可以要求。这个行动场中config_error该报告的部分告诉你是否需要重启实例MySQL来检测任何更改配置文件。

实例不支持坚持配置自动改变（见保留设置）需要连接到服务器，运行mysql，连接到实例的局部问题dba.configureLocalInstance()。这使得mysql修改实例的选项文件运行以下命令后对远程实例：

推荐的方法是登录到远程机器，例如使用ssh，mysql作为root用户运行，然后连接到MySQL服务器的地方。例如，使用--uri选择连接到本地instance：

内核>sudo -i mysqlsh --uri=instance

交替使用\connect命令登录到本地实例。然后问题dba.configureinstance（instance），在那里instance是本地实例的连接信息，坚持向本地实例的选择文件的任何更改。

MySQL dba.configurelocalinstance JS >（@：3306 IC IC 2）

重复此过程，为每个实例中不支持坚持配置自动改变集群。例如，如果你添加2个实例群集不支持坚持配置自动改变，你必须连接到每台服务器，坚持配置的变化所需的InnoDB集群实例重新启动前。同样，如果你修改的集群结构，例如改变实例的数量，你需要为每个服务器实例更新innodb集群元数据因此每个实例集群中重复这一过程。

当你创建一个集群使用dba.createCluster()，操作返回一个集群对象可以赋值给一个变量。你用这个对象与集群工作，例如添加实例或检查集群的现状。如果你想找回一个集群再次在稍后的日期，例如在重启mysql，使用[ dba.getcluster（name]，[options]）功能。例如：

MySQL的JS >var cluster1 = dba.getCluster()

如果你不指定群集name然后返回默认的簇。默认情况下，mysql尝试连接到集群的主实例，当你使用dba.getcluster（）。设置connectToPrimary选择要配置的行为。如果connecttoprimary是true和积极的全球mysql会话不是初级实例，聚类查询主要构件和聚类对象连接到它。如果集群中有没有法定人数，操作失败。如果connecttoprimary是false，群集对象使用活动会话，换句话说，比如mysql的全球会议一样。如果connecttoprimary没有指定，mysql治疗connectToPrimary作为真正的，落回connectToPrimary存在假

强制连接到二时得到一个集群，建立一个集群的次要构件的连接和使用connectToPrimary备选案文：

MySQL的JS >shell.connect(secondary_member)MySQL的JS >var cluster1 = dba.getCluster(testCluster, {connectToPrimary:false})

聚类对象提供status()方法使您可以检查一个集群运行。之前，你可以检查InnoDB集群的状态，你需要通过连接到其任何情况下得到一个参考InnoDB聚类对象。然而，如果你想更改群集的配置，您必须连接到一个“跑道”的实例。发行status()检索基于该服务器实例连接到您的意识和输出状态报告的集群视角的集群状态。

有关如何运行使用InnoDB集群，集群status()方法

MySQL的JS >var cluster = dba.getCluster()MySQL的JS >cluster.status(){    "clusterName": "testcluster",     "defaultReplicaSet": {        "name": "default",         "primary": "ic-1:3306",         "ssl": "REQUIRED",         "status": "OK",         "statusText": "Cluster is ONLINE and can tolerate up to ONE failure.",         "topology": {            "ic-1:3306": {                "address": "ic-1:3306",                 "mode": "R/W",                 "readReplicas": {},                 "role": "HA",                 "status": "ONLINE"            },             "ic-2:3306": {                "address": "ic-2:3306",                 "mode": "R/O",                 "readReplicas": {},                 "role": "HA",                 "status": "ONLINE"            },             "ic-3:3306": {                "address": "ic-3:3306",                 "mode": "R/O",                 "readReplicas": {},                 "role": "HA",                 "status": "ONLINE"            }        }    },     "groupInformationSourceMember": "mysql://ic@ic-1:3306"}

信息的输出cluster.status()提供以下信息：

获得关于InnoDB集群本身的结构信息，使用cluster.describe()功能：

MySQL的JS >cluster.describe();{“clusterName”：“testcluster”、“defaultreplicaset”：{“名字”：“默认”、“拓扑”：[ {“地址”：“ic-1:3306”、“标签”：“ic-1:3306”、“角色”：“哈”}，{“地址”：“ic-2:3306”、“标签“：”ic-1:2306”、“角色”：“哈”}，{“地址”：“ic-3:3306”、“标签”：“ic-3:3306”、“角色”：“哈”} } } ]

这个输出函数显示InnoDB集群包括其所有配置信息的结构，等等。地址标签和角色价值观匹配了检查InnoDB集群的现状

组复制的停止的时候，super_read_only变量设置为打开（放）确保没有写了实例。当您尝试使用这样一个实例，下面你可以选择adminapi命令集super_read_only=OFF在实例：

当遇到一个实例，adminapisuper_read_only=ON在交互模式下，你可以选择设置super_read_only=OFF。。。。。。。例如：

MySQL的JS >var myCluster = dba.createCluster('testCluster')一个新的InnoDB集群将实例“IC”ic-1:3306 '创建。MySQL实例在IC @ ic-1:3306”目前已设置为防止无意更新应用的super_read_only系统变量。你必须先取消它能够执行任何改变这种情况。更多信息见：http：/ / dev.mysql。COM /医生/ refman / EN /服务器系统变量。HTML # sysvar_super_read_only.note：有公开的会议“IC”ic-1:3306’。你可能想杀死这些会话以防止他们表演意想不到的更新：1打开会话（S）“IC”ic-1:3306 '。你想禁用super_read_only并继续吗？【Y | n ]：

对实例的当前活动会话的数量显示。你必须确保没有任何应用程序可以写的实例不经意。通过回答y你确认adminapi可以写的实例。如果有多个打开的会话实例上市，谨慎之前允许adminapi设置super_read_only=OFF

给力的功能设置super_read_only=OFF在脚本中，通过clearreadonly选项设置为true。例如dba.configureinstance（instanceclearreadonly }，{：true）。

一旦一个沙箱实例正在运行，可以在任何时间使用下列改变其现状：

你可以在任何时候从群集删除实例，如果你想这样做。这是可以做到的Cluster.removeInstance(instance)的方法，在以下的例子：

MySQL的JS >cluster.removeInstance('root@localhost:3310')实例将从群集中删除InnoDB。根据instancebeing种子或没有，元数据的会话可能成为无效。如果是这样的话，pleasestart新会话的元数据存储的R / W的实例，试图从组复制组…离开实例的本地：3310成功从群集中删除。

您可以通过在interactive选项控制是否提示您确认从集群移除实例。在交互模式下，系统会提示您继续使用该实例的去除（或没有）的情况下是不可到达的。这个clusterremoveinstance()。操作确保实例是从所有集群成员的元数据删除在线，和实例本身

当实例被删除了，还需要应用交易，adminapi等待到mysql配置的秒数dba.gtidWaitTimeout期权交易（gtids）适用。mysqldba.gtidwaittimeout选项的缺省值为60秒，看配置mysql有关更改默认信息。如果定义的超时值dba.gtidWaitTimeout等待交易时，应与力选项false（或不确定）然后发出错误和删除操作被中止。如果定义的超时值dba.gtidwaittimeout等待交易时，应与force选项设置为真正的然后继续运行没有错误，从群集中删除实例。

当你创建一个群集添加实例，价值观等的组名称，本地地址，和种子的情况下adminapi自动配置。这些默认值是建议大多数部署，但高级用户可以通过下列选项来覆盖这些默认值dba.createCluster()和addinstance()集群。

定制的InnoDB群集创建复制组的名称，通过groupName选择的createcluster() DBA。命令。这套group_replication_group_name系统变量。名称必须是一个有效的UUID。

自定义地址，从其他实例的连接提供了一个实例，通过localAddress选择的createcluster() DBA。和cluster.addInstance()命令。指定格式的地址host：port。这套group_replication_local_address在实例变量系统。地址必须在群集的所有实例的访问，必须保留为内部群集通讯。换句话说，不要使用这个地址的通信实例。

定制作为种子在实例加入集群的情况下，通过groupSeeds选择的createcluster() DBA。和cluster.addInstance()命令。种子的实例联系时的一个新实例加入群集，用于提供数据到新的实例。地址指定为一个以逗号分隔的列表如主持：1，host2:port2。这个配置group_replication_group_seeds系统变量

更多信息见本系统变量配置这些adminapi选项文件。

如果一个实例的叶簇，例如因为它失去了联系，没有或不能自动加入集群，可能需要重新加入到群集在稍后的阶段。答辩实例聚类问题cluster.rejoinInstance()

在一个实例没有的情况下过它的配置保存，在重新启动实例不加入集群自动。解决的办法是问题cluster.rejoinInstance()这样的实例被添加到群集再次。然后连接到实例，运行mysql局部问题委托人。这确保了InnoDB群集配置保存到实例的选项文件使其重新加入集群自动。

如果一个实例（或实例）失败，然后群集失去仲裁，这是一个新的初选投票的能力。在这种情况下，你可以重新仲裁的使用方法cluster.forceQuorumUsingPartitionOf()在下面的示例中所示：mysql

/ /打开一个clustermysql JS >cluster = dba.getCluster("prodCluster")/ /群集失去仲裁，其状态显示/“身份”：“no_quorum MySQL js“>cluster.forceQuorumUsingPartitionOf("localhost:3310")恢复replicaset默认从损失的群体，由[本地分区：3310 ]请提供密码“root@localhost：3310：******恢复InnoDB集群…InnoDB集群成功恢复使用实例的root@localhost分区：3310”。警告：为避免脑裂的情况，确保所有其他成员的replicaset除去或加入到组，恢复。

如果你的集群遭受全面停电，你可以确保它被正确使用dba.rebootClusterFromCompleteOutage()。如果在一个集群已经完全停止，必须启动的情况下才能集群开始。例如，如果机器一个沙箱集群运行于已重新启动，并实例进行港口3310、3320和3330，问题：

mysql-js> dba.startSandboxInstance(3310)mysql-js> dba.startSandboxInstance(3320)mysql-js> dba.startSandboxInstance(3330)

这确保了沙盒中运行的实例。在生产部署，你将不得不启动实例MySQL内核外的情况。一旦情况开始，连接到一个实例并运行mysql。然后重新启动集群通过发行：

        
mysql-js> shell.connect('root@localhost:3310');
mysql-js> var cluster = dba.rebootClusterFromCompleteOutage();

这保证了集群是正确配置一个完整的中断后。它使用的实例，mysql连接为新种子实例恢复基于实例的现有元数据集群。

如果这个过程失败，和集群元数据已损坏严重，你可能需要把元数据和再次从头开始创建群集。你可以使用集群元数据dba.dropMetadataSchema()

如果一个实例的配置变化是没有用adminapi，你需要重新聚类更新innodb集群元数据。例如，如果你手动添加的一个新实例的组复制组，InnoDB集群元数据并不能改进的基于这种变化的集群由于没有使用mysql。在这种情况下，有必要重新审视集群cluster.rescan()更新innodb集群元数据。

命令之后cluster.rescan()已运行情况确定，新发现的实例。提示您添加这些新发现的情况下进入你的集群的要求，或者你也可以选择忽略它们。

实例不再属于群集或不可用也报道。在这种情况下，提示您删除实例，或者你可以稍后尝试添加到群集使用如下命令cluster.rejoin('ic@ic-4:3306')

这个cluster.checkInstanceState()函数可以用来验证实例的现有数据并不妨碍它加入一个集群。这个过程通过验证实例的全局事务标识符（gtid）状态相比，集群已经处理了gtids。在gtids的更多信息见第17.1.3.1”gtid格式和存储”。这个检查可以确定是否已处理的交易实例可以被添加到群集。

下面演示了发行这一运行mysql：

mysql-js> cluster.checkInstanceState('ic@ic-4:3306')

这个函数的输出可以是下列之一：

一个好的状态的情况下，可以添加到群集因为在实例的任何数据与集群一致。换句话说，实例被检查没有执行任何交易与gtids由群集执行的冲突，并可以恢复到相同的状态作为集群的其它实例。

解散InnoDB集群您连接到读写实例，例如在一个主群小学，并使用Cluster.dissolve()命令。这将删除所有元数据和配置与集群相关，并禁用组复制实例。任何数据都不会被删除的实例之间复制。有没有办法解开一个集群的溶解，因此你必须通过力：真的确认你想解散群。例如：重新创建它dba.createCluster()

MySQL的JS &#62;session<ClassicSession:root@localhost:3310>mysql-js>cluster.dissolve({force:true})集群成功溶解。复制是残疾但用户数据被原封不动。

服务器实例可以被配置为使用安全连接。一般信息使用SSL与MySQL看到6.4节，“使用加密的连接”。本节说明如何配置群集使用SSL。一个额外的安全可能是配置的服务器可以访问群集，看创建一个白名单的服务器

当使用dba.createCluster()建立一个集群，如果服务器实例提供了SSL加密，则自动启用对种子的实例。通过membersslmode选择的dba.createCluster()指定一个不同的SSL模式的方法。一个簇的SSL模式只能设置在创建时。这个membersslmode期权是一个字符串，配置SSL的方式被使用，它的默认值AUTO。允许的值禁用，REQUIRED，和汽车。这些模式被定义为：

当你的问题cluster.addInstance()和rejoininstance()集群。命令，实例上的SSL加密是启用或禁用基于设置发现种子实例。

当使用createCluster()与adoptfromgr选择采用现有的组复制组，没有SSL的设置都在采用集群改变：

mysql中始终启用或禁用SSL两组复制恢复和组通信的集群，看第18.5.2，安全套接字层（SSL）的支持”。一个验证，如果这些设置是为种子实例不同发出错误（例如作为一个结果dba.createCluster()使用adoptfromgr）添加到集群中的一个新实例时。SSL加密必须启用或禁用对集群中的所有实例。验证以确保这不变的是集群中添加一个新的实例时。

这个deploySandboxInstance()命令试图用SSL加密默认支持部署沙箱实例。如果这是不可能的，服务器实例配置不支持SSL。使用ignoresslerror选项设置为false，以确保沙箱实例部署SSL支持，发出一条错误如果不能提供SSL支持。什么时候ignoreSslError是真的，这是默认的，没有错误是发布在操作过程中如果不能提供SSL支持的服务器实例部署没有SSL的支持。

当使用一个集群createCluster()，addinstance()，和rejoinInstance()方法，您可以选择指定认可的服务器，属于集群，被称为“白名单”。通过指定的白名单，明确这样你可以增加你的集群的安全因为在白名单中唯一的服务器可以连接到群集。默认情况下，如果没有显式指定的白名单，自动设置为私网地址，服务器的网络接口。配置白名单，指定要添加的服务器ipwhitelist在应用这种方法时的选择。通过服务器作为一个逗号分隔的列表，用引号括起。使用ipWhitelist选项配置group_replication_ip_whitelist在实例变量系统。例如:

MySQL的JS > cluster.addInstance("ic@ic-3:3306", {ipWhitelist: "203.0.113.0/24, 198.51.100.110"})

这个配置实例只接受来自服务器的连接地址203.0.113.0/24和198.51.100.110。白名单还包括主机名，这是解决只有当一个连接请求是由另一个服务器。

你可以自动配置脚本。例如:

shell> mysqlsh -f setup-innodb-cluster.jss

一个脚本文件的内容显示在这里：

print('MySQL InnoDB cluster sandbox set up\n');
print('==================================\n');
print('Setting up a MySQL InnoDB cluster with 3 MySQL Server sandbox instances.\n');
print('The instances will be installed in ~/mysql-sandboxes.\n');
print('They will run on ports 3310, 3320 and 3330.\n\n');

var dbPass = shell.prompt('Please enter a password for the MySQL root account: ', {type:"password"});

try {
   print('\nDeploying the sandbox instances.');
   dba.deploySandboxInstance(3310, {password: dbPass});
   print('.');
   dba.deploySandboxInstance(3320, {password: dbPass});
   print('.');
   dba.deploySandboxInstance(3330, {password: dbPass});
   print('.\nSandbox instances deployed successfully.\n\n');

   print('Setting up InnoDB cluster...\n');
   shell.connect('root@localhost:3310', dbPass);

   var cluster = dba.createCluster("prodCluster");

   print('Adding instances to the cluster.');
   cluster.addInstance({user: "root", host: "localhost", port: 3320, password: dbPass});
   print('.');
   cluster.addInstance({user: "root", host: "localhost", port: 3330, password: dbPass});
   print('.\nInstances successfully added to the cluster.');

   print('\nInnoDB cluster deployed successfully.\n');
} catch(e) {
   print('\nThe InnoDB cluster could not be created.\n\nError: ' +
   + e.message + '\n');
}