SeaSQL DRDS在2.5.3.1及以上版本时提供基于MySQL原生复制功能解决SeaSQL DRDS跨机房容灾问题的解决方案，能够实现跨机房数据同步以及解决跨机房分布式事务数据库服务容灾的问题。此标准文档仅详细介绍SeaSQL DRDS在单机房模式的功能与特性，若要了解容灾模式下的功能与特性，请参考《H3C SeaSQL DRDS 跨机房容灾功能使用手册》。

部分截图的版本细节差异无需特别关注，以文档描述的版本号为准。文档内容较多，建议开启文档结构图，方便阅读。

1.1 计算节点简述

SeaSQL DRDS是一款实现数据容量和性能横向扩展的分布式事务数据库产品，可解决实时交易业务系统的“两大三高”（即大规模用户、大规模数据、高可用、高并发、高吞吐）问题。

SeaSQL DRDS能在数据存储分布式化的环境下为应用提供集中式数据库的操作体验，同时提供数据安全、数据容灾、数据恢复、不停机在线扩容、集群监控、智能拓扑、智能大屏等整套解决方案。

SeaSQL DRDS支持将一张表水平切分成多份，分别存入不同的数据库来实现数据的水平分片，此外也支持垂直拆分和全局表。SeaSQL DRDS提供多种表数据分片规则，用户可根据业务需要，使用合适的数据分片规则。

SeaSQL DRDS基于Java NIO、MySQL协议研发，支持数据库连接的多路复用，具有更好的并发性能。

SeaSQL DRDS提供数据库服务自动切换功能，可有效地解决数据库单点故障问题。

与计算节点配套使用的管理平台（也称为SeaSQL Management）也是产品重要组成部分。

1.1.1 SeaSQL DRDS组件架构

图1-1 SeaSQL DRDS的功能组件架构图

图1-2 SeaSQL DRDS的组件架构图

· 分布式事务数据库SeaSQL DRDS集群是由一组计算节点、存储节点、管理平台、配置库组成的数据库管理系统。

· 计算节点：计算节点是分布式事务数据库SeaSQL DRDS集群体系的核心，主要提供SQL解析、路由分发、结果集合并等分布式事务数据库的核心控制功能,是整个分布式服务的命脉所在。

· 存储节点：存储节点依赖MySQL数据库提供数据的存储功能，一个MySQL实例(IP+端口+物理库)即为一个存储节点。为了实现高可用和数据多副本功能，DRDS中将具有相同数据副本的一组（多个）存储节点称为一个数据节点。

· 数据节点：数据节点是一组具有相同数据副本的存储节点的统称。数据节点可以是一个MySQL MGR集群，也可以是一个MySQL主从复制集群。数据节点管理一组存储节点（具有相同数据副本）的复制关系。数据节点在DRDS中作为一个分片数据存在，所有的数据节点一起构成DRDS的全量数据。

· 管理平台：分布式事务数据库管理平台（以下简称管理平台）又称为SeaSQL Management，可实现对计算节点数据库用户、数据节点、表类型、分片规则等信息的易用性配置，同时可提供计算节点服务状态监控、异常事件提醒、报表查看、任务管理等智能运维相关服务。

· 配置库：负责存储计算节点与管理平台相关配置信息。配置库可通过主从或MGR进行高可用配置。

· 高可用：SeaSQL DRDS的计算节点可通过Keepalived实现高可用。Keepalived负责计算节点的主、备切换和VIP漂移。

· 负载均衡：SeaSQL DRDS的计算节点集群模式可通过LVS/F5实现高可用和负载均衡。应用通过LVS的VIP访问SeaSQL DRDS的分布式事务数据库服务，分布式事务数据库服务对应用程序透明，计算节点集群中单个或多个节点故障对应用程序无影响。

· DRDS Backup：自研的分布式事务数据库备份程序，负责业务数据的备份。

· SeaSQL Listener：自研的一个可拔插组件，需要单独进行部署，并以独立的进程运行，从而解决集群强一致（XA）模式下的性能线性扩展问题。

1.1.2 专业名词解释

若想要了解SeaSQL DRDS集群体系相关术语及关系，请参考《H3C SeaSQL DRDS 管理平台名词解释手册》。

1.1.3 计算节点

计算节点是数据服务提供端，默认服务端口为3323，登录命令如下：

#mysql -uroot -proot -h127.0.0.1 -P3323

登陆后使用方法与使用MySQL数据库一致，例如：

root> mysql -uroot -proot -h127.0.0.1 -P3323

mysql: [Warning] Using a password on the command line interface can be insecure.

Welcome to the MySQL monitor. Commands end with ; or \g.

Your MySQL connection id is 515

Server version: 5.7.35 SeaSQL DRDS 2.5.7 by H3C Tech

Oracle is a registered trademark of Oracle Corporation and/or its

affiliates. Other names may be trademarks of their respective

owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> show databases;

+-----------------+

| DATABASE |

+-----------------+

| CLASSIC_LOGICDB |

| HotDB |

+-----------------+

2 rows in set (0.01 sec)

mysql> use CLASSIC_LOGICDB

Database changed

mysql> show tables;

+---------------------------+

| Tables_in_CLASSIC_LOGICDB |

+---------------------------+

| customer |

+---------------------------+

1 row in set (0.03 sec)

应用程序连接计算节点与连接MySQL一致，只需修改应用中数据库配置文件的host、port、database、user、password信息即可。SeaSQL DRDS支持不同开发平台下的MySQL数据库驱动、连接池，比如JAVA开发平台的JDBC，c3p0、DHCP、DRUID连接池。下面是c3p0连接池的配置举例：

<bean id="dataSource1" class="com.mchange.v2.c3p0.ComboPooledDataSource"

destroy-method="close">

<property name="jdbcUrl" value="jdbc:mysql://192.168.137.101:3323/cloth?useLocalSessionState=true" /> 其中3323端口位置要修改为计算节点服务端口

同时，计算节点默认管理端口为3325，在管理端口中可使用命令对当前服务进行监控与管理。若需要了解更多信息，请参考管理端信息监控。

1.1.4 管理平台

管理平台为计算节点提供用户信息、节点信息、表信息、分片等信息的配置，默认端口为3324，在浏览器中输入HTTP链接地址，即可访问管理平台（建议使用Chrome或者FireFox浏览器），如：http://192.168.200.191:3324/login，访问页面如下所示：

管理员用户名与密码都默认为：admin，其他用户账号由管理员创建，初始密码为[email protected]。

如果需要了解管理平台详细使用方法，请参考《H3C SeaSQL DRDS 管理平台用户手册》。

1.2 版本2.5.7新功能与新特性

本章节将简单介绍在SeaSQL DRDS V2.5.7中新增、禁止或完善的功能概要，详细功能使用方法可点击超链接查看详情：

· 支持DROP DATABASE 语法功能

· 支持只读计算节点实例，开启计算节点只读模式来平衡当前主计算节点的压力或使用只读计算节点实例抽取数据做数据分析

· 完善EXPLAIN功能，展示具体的SQL的路由计划

· 支持EXPLAINDN 功能，展示下发到路由数据节点上的SQL语句的执行计划

· 完善计算节点对字符集的支持，增加gb18030字符集和gb18030_chinese_ci校对集

· 支持多计算节点集群模式下提供仅参与选举状态的模式配置，以提高集群可用性

· 完善引入Calcite后SQL语法的支持程度，并增加 FETCH ROWS、FOR UPDATE WAIT xx、ROWNUM语法的支持，同步调整NDB使用限制说明

· 优化读写分离功能，增加读写分离控制从机的读取优先级到用户级别

· 支持mydumper备份、myloader恢复功能

1.3 版本2.5.7新计算节点参数

此小节将介绍在计算节点– V2.5.7中优化与新增的计算节点参数，列举如下：

计算节点参数名	计算节点参数说明	默认值	动态加载是否生效	支持版本
enableRownum	控制是否开启rownum功能	0	Y	向下同步至2.5.6
enableDropDatabase	是否支持Drop database语法	0	Y
instanceReadOnly	是否开启实例级别只读	0	重启或执行特殊命令生效
allowReadConsistentInReadOnly	开启实例级别只读后，是否保证读一致性	0	Y
maxLatencyForReadOnly	开启实例级别只读后，可读从库允许的最大延迟时间	1000ms	Y
ddlForDbNeedSuper	DATABASE的DDL语句是否需要额外的SUPER权限	False	Y	向下同步至2.5.6
columnPrivilegeDenied	控制表中的列拒绝权限，优先级高于其他权限	（空）	Y	向下同步至2.5.5
clusterRole	计算节点集群当前角色	0	N	向下同步至2.5.6

2 计算节点部署升级

2.1 服务授权

SeaSQL DRDS需要获取正规的授权许可证，方能正常提供服务。如果需要了解如何获取服务授权，请参考《H3C SeaSQL DRDS 服务授权功能使用手册》。

2.2 安装部署与升级

部署SeaSQL DRDS，需要安装JDK（JAVA运行环境）、MySQL数据库软件、USB KEY驱动包、计算节点、管理平台，并配置一个MySQL实例作为计算节点的配置库。部署用的服务器，操作系统，推荐使用64位的H3Linux K310 V113-x86_64(64bit)。若需要了解SeaSQL DRDS的安装、部署与升级，请参考《H3C SeaSQL DRDS 管理平台安装手册》。

2.3 配置文件

计算节点的配置文件位于安装目录下的conf目录，文件名称为server.xml。如果需要了解SeaSQL DRDS参数，请参考计算节点参数说明。

server.xml的部分参数修改后需要重新启动计算节点才能生效，部分参数修改后可通过“动态加载”生效。

如果14 计算节点参数说明中所列参数在server.xml中不存在，则说明该参数使用了默认值；如果想要调整某个参数值或增加某个参数，请在server.xml中增加如下代码，也可以通过管理平台的“配置”->“计算节点参数”页面添加。

3 计算节点快速配置

本节将描述快速配置分布式事务数据SeaSQL DRDS的方法。本节仅介绍必要的配置功能，用于达到快速入门的目的。如果需要了解更多的配置功能，请参考《H3C SeaSQL DRDS 管理平台用户手册》。

在下面的例子中，将配置一个3个节点的数据分片，该分片使用名称为“test”的逻辑库，分片表名称为“customer”，分片字段为“provinceid”，自动分片表。

在配置SeaSQL DRDS前，请确保管理平台与计算节点已经正常启动，并且已经准备好了6个MySQL数据库实例（此例子中，将以配置双主类型的数据节点为例，若只需要单库的数据节点，只需要准备3个实例即可）。

若需要了解更多关于SeaSQL DRDS与管理平台的安装部署，请参考《H3C SeaSQL DRDS 管理平台安装手册》。

3.1 登录管理平台

在浏览器中输入管理平台的HTTP链接地址，并登录到管理平台；HTTP链接地址通常为部署管理平台的服务器IP，端口默认为3324，如http://192.168.200.89:3324/login.html。

管理平台提供了两类用户角色：超级管理员与普通用户，超级管理员默认初始用户名和密码都为：admin；普通用户由超级管理员创建，默认密码为：[email protected]。

超级管理员登录后主要有“计算节点集群管理”、“用户管理”功能，管理员可以创建、编辑计算节点集群，并配置计算节点连接信息，添加管理平台用户以及为用户添加权限等。

3.2 添加计算节点集群

计算节点集群为一组具有高可用关系的计算节点服务，添加计算节点集群是为了将已经部署好的计算节点添加到管理平台进行管理，若要从头部署一套计算节点集群需要使用集群部署功能，请参考《H3C SeaSQL DRDS 管理平台安装手册》。

在计算节点集群管理页面点击“集群部署与配置”->“添加计算节点集群”，输入计算节点所在的服务器IP 服务端口、管理端口、连接管理端口的用户名、密码即可创建单计算节点，选择主备节点或多节点后可添加一组高可用的计算节点。

输入完成后，点击测试，连接成功后则可以将此计算节点集群分配给管理平台用户来配置管理。

3.3 添加管理平台用户

管理平台用户是管理、配置、监控、检测计算节点集群的用户,它有两种权限，一种为访问权限（只能查看部分页面），一种为控制权限（可编辑操作）。

管理员在创建管理平台用户时将计算节点集群分配给管理平台用户，同时分配控制权限，创建成功后，以管理平台用户登录，就可以管理、配置、监控计算节点集群了。

(1) 登录管理平台，在管理平台用户页面点击“添加新用户”，输入用户名称，分配计算节点集群的控制权限。

(2) 添加完成后，该用户登录后可以对计算节点进行管理。

3.4 创建MySQL数据库与存储节点用户

分别在6个MySQL 数据库实例上（存储节点）创建数据库与用户，登录MySQL，执行以下语句：

set session sql_log_bin=0;

//执行此语句是为了防止创建物理库和用户时同时操作了主备存储节点，如果开启gtid，然后后续又搭建复制，操作不当的情况下可能导致一定的复制中断或主从不一致的风险。

CREATE DATABASE db01 CHARACTER SET 'utf8' COLLATE 'utf8_general_ci';

GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER,PROCESS,REFERENCES,SUPER,LOCK TABLES,REPLICATION SLAVE,REPLICATION CLIENT,TRIGGER,SHOW VIEW,CREATE VIEW,CREATE ROUTINE,ALTER ROUTINE,EXECUTE,EVENT,RELOAD,CREATE TEMPORARY TABLES ON *.* TO 'hotdb_datasource'@'%' IDENTIFIED BY 'hotdb_datasource';

set session sql_log_bin=1;

注意：

如果存储节点是MySQL8.0版本，授权语句需要增加XA_RECOVER_ADMIN权限。

hotdb_datasource账户是DRDS连接各个MySQL实例的唯一账户，所有添加的平台用户都是通过映射到hotdb_datasource账户来连接MySQL实例，各平台用户只作用在前端业务连接和用户访问控制。

通常在MySQL中create database 创建的数据库称为“逻辑库”，但是在分布式事务数据库系统中称呼有所区别，一般因为其是实际保存数据的原因称为“物理库”，或者称为“某个分片数据库”。

为了配置方便，6个MySQL 数据库实例上创建的数据库和用户需要保持一致。

3.5 添加逻辑库

通常在MySQL中create database 创建的数据库称为“逻辑库”，一个“逻辑库”可以为一个应用或一个微服务提供数据库服务。

为了保持一致性，分布式事务数据库系统同样通过“逻辑库”为一个应用或一个微服务提供数据库服务，但是分布式事务数据库系统由多套MySQL实例组成（本例是6套），所以在SeaSQL DRDS中“逻辑库”是“全局逻辑库”，即6套MySQL实例中“逻辑库”的集合，在SeaSQL DRDS中仍称为逻辑库。

逻辑库是计算节点中的虚拟数据库，用MySQL命令登录计算节点后，通过如下语句显示逻辑库列表：

show databases;

(1) 登录管理平台页面，选择“配置”->“逻辑库”->“添加逻辑库”，输入”test”逻辑库名称，点击“√”，保存配置，逻辑库即添加成功。

3.6 赋予用户逻辑库权限

管理平台安装后，系统默认创建一个平台用户root（密码root）。

只有被赋予逻辑库权限的用户才能使用逻辑库。

(1) 登录管理平台页面，选择“配置”->“数据库用户管理”，选择root用户，并点击“编辑”按钮。

(2) 跳转到“编辑用户权限”页面，在下拉框中勾选创建好的逻辑库“test”，点击“保存”，权限赋予成功。

3.7 添加存储节点组

添加存储节点组可以更方便地添加或修改一组具有相同参数值的存储节点。

(1) 登录分布式事务数据库可视化管理平台页面，选择“配置”->“节点管理”->“存储节点组”->“添加组”。

参数包括：

¡ 组名：输入存储节点组命名；

¡ 连接用户：有权限访问该物理库的用户名（上节添加的用户名）；

¡ 连接用户密码：有权限访问该物理库的用户密码；

¡ 物理库名：存储节点中可引用的数据库名称，例如“db01”（3.4节添加的物理库）；

¡ 备份用户：（选填）用于备份该物理库的用户名；

¡ 备份用户密码：（选填）用于备份该物理库的用户密码；

¡ 字符集：被连接的物理库字符集，默认utf8mb4；

¡ 最大连接数：MySQL物理库最大连接数，默认4200；

¡ 初始连接数：MySQL物理库初始连接数，默认32；

¡ 最大空闲连接数：MySQL物理库最大空闲连接数，默认512；

¡ 最小空闲连接数：MySQL物理库最小空闲连接数，默认32；

¡ 空闲检查周期（秒）：MySQL物理库空闲检查周期，默认600。当连接长时间没有向服务器发请求的时候，定时断开这个连接，避免对数据库连接的浪费；

(2) 根据业务场景选择相同参数值设置为一个存储节点组，例如在本例中，下图中勾并输入的参数值组成一个存储节点组。

在添加节点时应用在若干个存储节点上，会自动填充组内预设的参数值；修改组内某一参数时，组内所有存储节点的该条参数被批量修改。

3.8 添加数据节点与存储节点

在本案例中，将6个MySQL实例分成3组(3分片)，每组两个MySQL实例（一主一备）。上述描述对应到分布式事务数据库系统为：全量数据由3个数据节点组成，每个数据节点下各有2个存储节点。

我们需要在平台做如下操作：添加3个数据节点，并为这3个数据节点分别添加2个存储节点。

(1) 登录管理平台页面，选择“配置”->“节点管理”->“添加节点”:

可以批量添加新的数据节点与其对应存储节点，也可以为已有的数据节点添加存储节点，此处仅介绍批量添加新的数据节点和存储节点，操作演示如下：

(2) 填写数据节点参数：在此例子中，需要添加数据节点个数为3个，数据节点类型为双主（也可以选择其他类型）。此例子中，存储节点组选择不使用组，你也可以在下拉菜单中选择使用上小节添加的存储节点组，以此批量添加或修改相似参数。没有特殊要求时，节点前缀、编码位数、起始编码可使用默认值。

(3) 填入参数后点击【生成】。

(4) 根据提示信息填写存储节点配置参数

参数包括：

¡ 数据节点：默认根据之前填写的参数生成，可修改

¡ 存储节点类型：默认根据之前填写的参数生成，可修改

¡ 存储节点组：默认根据之前填写的参数生成，可修改

¡ 存储节点名称：默认勾选自动生成，也可以取消勾选后在文本框中输入存储节点命名，例如“ds_01”；

¡ 主机名：输入MySQL数据库的主机IP。

¡ 端口号：输入MySQL数据库端口。

¡ 连接用户：有权限访问该物理库的用户名（3.4节添加的用户名）；

¡ 连接用户密码：有权限访问该物理库的用户密码；

¡ 物理库名：存储节点中可引用的数据库名称，例如“db01” （3.4节添加的物理库）；

¡ 备份用户：（选填）用于备份该物理库的用户名；

¡ 备份用户密码：（选填）用于备份该物理库的用户密码；

¡ 监听程序主机名：（选填）即SeaSQL Listener。安装监听程序可用于解决计算节点集群模式的性能线性扩展问题。默认存储节点所在服务器的主机名；

¡ 监听端口：（选填）用于设置监听程序启动端口；

¡ 监听程序服务端口：（选填）监听程序服务端口是计算节点通过监听程序连接存储节点的端口，若一个监听程序需要监听多个存储节点，则需要为其分别填写不同的服务端口；

¡ 自动主从搭建：选择后，管理平台会自动根据配置信息为相应的存储节点搭建复制关系。

¡ 主存储节点：仅在需要搭建双主带从或多级从的复制关系时才需要填写此参数。可将当前存储节点需要搭建复制关系的主存储节点名称复制后粘贴于此。默认时为系统根据配置自动判断。

点击【…】展开更多参数，如下图：

(5) 填写完参数后，点击【测试连接】验证输入无误且所有存储节点连接成功后，点击【保存并返回】，成功添加3个数据节点及其分别对应的6个存储节点。

3.9 添加分片规则

添加分片规则的目的是为表的水平拆分提供手动设置的路由方法及算法，如果希望使用自动分片方式创建表信息，则可跳过此步骤。

(1) 登录管理平台页面，选择“配置”->“分片规则”->“添加分片规则”。

(2) 根据业务场景，输入配置参数，包括：

¡ 分片规则名称：默认生成，取消勾选后可修改

¡ 分片类型：包括ROUTE，RANGE，MATCH，SIMPLE_MOD，CRC32_MOD。以RANGE为例，若要了解更多分片规则可以查看更详细的功能说明文档，请参考《H3C SeaSQL DRDS 管理平台用户手册》。

¡ 设置方式：包括自动设置和手动设置，以自动设置为例。选择自动设置，管理平台根据配置参数自动计算值范围并自动划分数据节点；选择手动设置可以手动输入数据节点对应落入的值范围。

¡ 数据节点：选择分片的数据节点

¡ 值范围：输入分片字段的全部值范围，管理平台结合选择的节点数自动计算步长

(3) 点击【预览】查看生成结果，点击【修改】可修改值范围或数据节点，以解决数据倾斜问题。

(4) 点击【保存并返回】添加分片规则。

3.10 添加表信息

(1) 登录管理平台页面，选择“配置”->“表信息”->“添加表信息”

(2) 根据业务场景，选择表类型后输入配置参数，在此例子中，在水平分片表页面下，添加参数配置如下：

¡ 逻辑库：下拉菜单中选择上节添加的逻辑库test。

¡ 默认分片字段：在填写表名称时，表名称与其对应的分片字段应使用英文冒号间隔，若未填写分片字段，则取默认分片字段。所以此处填写“provinceid”

¡ 分片方式：在此例子中，选择自动分片，也可以选择上节添加的分片规则应用于此

¡ 数据节点：选择分片的数据节点，此例子中，选择3.8节添加的数据节点

¡ 请填写表名称：输入“customer”，添加多表但不同分片字段时，可以输入“customer:provinceid”表示。

(3) 点击【保存】，成功添加customer自动分片表。注：该表引用的分片规则是AUTO_CRC32类型(AUTO_MOD 与 AUTO_CRC32分片类型区别可查看页面中的“方式说明”)。

3.11 校验并动态加载配置信息

登录管理平台页面，对计算节点数据库用户，逻辑库，数据节点，存储节点，故障切换，分片规则，表信息，子表信息做的任何修改，都需要进行“动态加载”，新的配置信息才能生效。

若计算节点未启动，将不能执行动态加载，因此需先启动计算节点。

(1) 登录管理平台页面，选择“配置”->“配置校验”，在页面中点击“开始校验”，若没有出现配置错误的提示，则表示配置信息无误。

(2) 在页面中点击“动态加载”，若页面提示“动态加载成功”，则配置信息在计算节点中已经成功生效：

3.12 登录计算节点并开始使用

(1) 使用MySQL命令行，指定实际的IP地址，登录到计算节点：

mysql -uroot -proot -h127.0.0.1 -P3323 -Dtest

例如：

root> mysql -h127.0.0.1 -uroot -proot -P3323 -Dtest

mysql: [Warning] Using a password on the command line interface can be insecure.

Welcome to the MySQL monitor. Commands end with ; or \g.

Your MySQL connection id is 100728

Server version: 5.7.35 SeaSQL DRDS 2.5.7 by H3C Tech

Oracle is a registered trademark of Oracle Corporation and/or its

affiliates. Other names may be trademarks of their respective

owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

(2) 执行customer的建表语句：

REATE TABLE `customer`(

`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,

`name` VARCHAR(32) NOT NULL,

`telephone` VARCHAR(16) NOT NULL,

`provinceid` TINYINT UNSIGNED NOT NULL DEFAULT 0,

`province` ENUM ('Anhui','Aomen','Beijing','Chongqing','Fujian','Gansu','Guangdong','Guangxi','Guizhou','Hainan','Hebei','Heilongjiang','Henan','Hubei','Hunan','Jiangsu','Jiangxi','Jilin','Liaoning','Neimenggu','Ningxia','Qinghai','Shaanxi','Shandong','Shanghai','Shanxi','Sichuan','','Tianjin','Xianggang','Xinjiang','Xizang','Yunnan','Zhejiang') NULL,

`city` VARCHAR(16) NULL default '',

`address` VARCHAR(64) NULL,

PRIMARY KEY(`id`),

UNIQUE KEY(`telephone`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8;

(3) 计算节点将在各个数据节点创建customer表。可以登录到各个MySQL存储节点上，验证customer是否已经被创建。

(4) 或在管理平台“配置”->“表信息”页面，找到上节添加的表配置，在表结构一列中点击【未创建】跳转到普通DDL页面。

(5) 输入数据库用户名密码，并选择test逻辑库后，输入建表语句，点击【执行】添加表结构。

(6) 分片表customer创建成功后，可以连接计算节点执行下面的SQL语句，操作数据：

INSERT INTO customer VALUES (21,'何重庆','13912340021',4,'Chongqing','重庆','某某街某某号');

INSERT INTO customer VALUES (22,'吕重庆','13912340022',4,'Chongqing','重庆','某某街某某号');

INSERT INTO customer VALUES (25,'孔福州','13912340025',5,'Fujian','福州','某某街某某号');

INSERT INTO customer VALUES (26,'曹兰州','13912340026',6,'Gansu','兰州','某某街某某号');

INSERT INTO customer VALUES (67,'岑南昌','13912340067',17,'Jiangxi','南昌','某某街某某号');

INSERT INTO customer VALUES (68,'薛长春','13912340068',18,'Jilin','长春','某某街某某号');

INSERT INTO customer VALUES (69,'雷沈阳','13912340069',19,'Liaoning','沈阳','某某街某某号');

INSERT INTO customer VALUES (70,'贺呼和浩特','13912340070',20,'Neimenggu','呼和浩特','某某街某某号');

INSERT INTO customer VALUES (71,'倪银川','13912340071',21,'Ningxia','银川','某某街某某号');

INSERT INTO customer VALUES (72,'汤西宁','13912340072',22,'Qinghai','西宁','某某街某某号');

INSERT INTO customer VALUES (73,'滕西安','13912340073',23,'Shaanxi','西安','某某街某某号');

INSERT INTO customer VALUES (74,'殷济南','13912340074',24,'Shandong','济南','某某街某某号');

INSERT INTO customer VALUES (93,'顾台北','13912340093',28,'','台北','某某街某某号');

INSERT INTO customer VALUES (94,'孟天津','13912340094',29,'Tianjin','天津','某某街某某号');

INSERT INTO customer VALUES (95,'平香港','13912340095',30,'Xianggang','香港','某某街某某号');

INSERT INTO customer VALUES (96,'黄乌鲁木齐','13912340096',31,'Xinjiang','乌鲁木齐','某某街某某号');

INSERT INTO customer VALUES (99,'萧杭州','13912340099',34,'Zhejiang','杭州','某某街某某号');

INSERT INTO customer VALUES (100,'尹杭州','13912340100',34,'Zhejiang','杭州','某某街某某号');

(7) 也可对customer分片表执行DELETE、UPDATE、SELECT等操作。

4 计算节点运行相关

4.1 计算节点启动说明

· 启动计算节点，可以切换到/usr/local/hotdb/hotdb-server/bin目录下，再运行启动脚本，或者直接加上路径: sh /usr/local/hotdb/hotdb-server/bin/hotdb_server start；

· 配置库复制同步状态会影响计算节点启动，计算节点启动或者发生高可用切换Online时配置库必须保证复制追上；

· 存储节点复制同步状态会影响计算节点启动，通过在server.xml中配置参数waitSyncFinishAtStartup 的true/false属性控制计算节点启动时是否等待存储节点复制追上，默认需等待；

· 启动计算节点时,若存储节点连接状态异常，可通过修改server.xml中的配置参数masterSourceInitWaitTimeout ，控制数据节点中主存储节点是否重新初始化及初始化超时时间，具体控制逻辑参考计算节点启动时对逻辑库可用的判断。

· 影响计算节点启动失败的原因可能是多种多样的，包括但不限于：

¡ 软硬件环境异常：例如脚本校验无法通过，磁盘空间不足，可用内存不足，Java版本不匹配等

¡ 配置库异常：例如配置库无法连接，配置错误等

¡ 节点异常：例如数据节点无法正常连接或无法正常初始化等

¡ 授权异常：例如USB-Key服务异常，授权节点超出限制，授权过期等

¡ XA异常：例如XA RECOVER失败等

¡ 端口被占用：例如端口已被其他程序占用，或者启动了多个计算节点服务等

¡ 复制异常：例如配置了启动时等待复制追上，实际数据节点的复制一直存在延迟，无法追上等

¡ 集群异常：例如集群无法达成共识，启动时存在网络分区，各节点时间不同步等

4.1.1 计算节点启动时对逻辑库可用的判断

为保证垂直拆分场景下，出现数据节点不可用状态时，与之不相关的不同逻辑库之间的业务场景不受影响，计算节点在启动时，对所有逻辑库的可用状态做了特殊判断处理，说明如下：

· 若配置的主存储节点为可用状态，实际该存储节点无法连接，则计算节点启动时，会等待masterSourceInitWaitTimeout配置的时间（默认：300s）,判断该存储节点是否真实不可连接，若在此期间，该存储节点重连无异常，则该节点初始化成功；

· 如果数据节点初始化失败且无可用逻辑库，或数据节点下无存储节点，则计算节点无法启动，日志提示：04/13 10:50:54.644 ERROR [main] (HotdbServer.java:436) -datanodes:[3] init failed. System exit.

· 只要存在某个逻辑库对应的数据节点均可用，则可以启动计算节点，对应逻辑下的表可以正常操作。如果其他逻辑库下有不可用的节点，则该逻辑库下的表不能正常读写，客户端提示：ERROR 1003 (HY000): DATABASE is unavailable when datanodes:[datanode_id ] unavailable.

· 例如：A逻辑库包含1,2两个节点，B逻辑库包含3,4两个节点。如果1、2节点不可用，3、4节点可用，则计算节点可以启动，B逻辑库下的表可以正常操作，A逻辑库下的表无法进行读写；如果1、3节点不可用，则计算节点无法启动。

· 判断某个节点是否可用，跟存储节点在配置库的状态以及存储节点实际可用状态有关，要求配置状态与存储节点状态要一致，否则会影响计算节点的启动。计算节点启动时连接配置库配置的可用存储节点，如果均能连接，则视为可用。如果某个配置为可用的存储节点无法连接，且该数据节点下所有其他存储节点都配置为不可用或配置为可用但实则无法连接，则视为该数据节点不可用。每个节点至少应配置一个可用存储节点，否则无法启动计算节点。具体情况如下：

¡ 主从存储节点均配置为可用

如果主从存储节点均可以连接，则该节点可用。如果主库无法连接，从库可连接，则会发生切换，将主库置为不可用，并且使用从库。如果主库可以连接，从库无法连接，则使用主库，从库会置为不可用。如果主从数据库均无法连接，则该节点不可用。

¡ 主库配置不可用，从库配置可用

如果从库可以连接，则使用从库，此节点可用。如果从库无法连接，则该节点不可用

¡ 主库配置可用，从库配置不可用

如果主库可以连接，则使用主库，此节点可用。如果主库无法连接，则该节点不可用

4.2 存储节点服务端参数校验

为了保证数据的一致性，计算节点在启动的时候，将对MySQL存储节点实例的参数进行校验。针对不同的参数，如果参数配置不符合校验规则，计算节点将报告警告信息，或者不能启动。计算节点对MySQL存储节点实例的参数要求有两种：一种是所有的存储节点实例的参数需一致；另一种是所有的存储节点实例的参数必须为固定值。

1. 要求设置为固定值的参数

对于下列MySQL存储节点实例的参数，计算节点要求设置为统一的固定值：

· completion_type必须为NO_CHAN,如果出现该参数不符合规范，则动态加载失败；

· innodb_rollback_on_timeout 需要为ON，且任何时候SHOW [GLOBAL|SESSION] VARIABLES显示出来的innodb_rollback_on_timeout参数都为on，说明如下：

¡ 如果innodb_rollback_on_timeout参数全为off，则计算节点允许加载成功，但计算节点的行为将等同于innodb_rollback_on_timeout参数为on时的事务回滚方式，且配置校验时给出如下提示：

且动态加载时日志输出：innodb_rollback_on_timeout=off is not supported, HotDB behavior will be equivalent to innodb_rollback_on_timeout = on.

¡ 如果innodb_rollback_on_timeout参数存储节点间不一致，动态加载失败，且配置校验时提示如下:

{8D2D9EDD-F3B4-009E-BBF3-235E2589A9EC}

且动态加载时，为off的存储节点日志输出，MySQL variables 'innodb_rollback_on_timeout' is not consistent,the current value is OFF ,neet to bu changed to ON , 为on的存储节点日志输出MySQL variables 'innodb_rollback_on_timeout' is not consistent,the current value is ON

· read_only，参数说明如下：

¡ 如果主存储节点的参数read_only=1，计算节点将拒绝启动，动态加载失败。

¡ 如果从机的参数read_only=1且配置了切换到该从机的配置规则，计算节点可以启动，RELOAD失败。

¡ 如果从机的参数read_only=1且没有配置切换到该从机的配置规则，计算节点可以启动，reload如果无其它错误则成功。

2. 要求所有节点配置一致的参数

对于下列MySQL存储节点实例的参数，计算节点要求存储节点间的参数值设置为一致：

· autocommit

· transaction_isolation

· div_precision_increment

若以上参数在存储节点间配置不一致，计算节点将给出警告信息。对于transaction_isolation参数，计算节点以设置的最高隔离级别为准，若最高配置的值高于REPEATABLE-READ，将使用SERIALIZABLE；若最低配置的值低于REPEATABLE-READ，计算节点将使用REPEATABLE-READ模式。

3. 要求不能超过计算节点配置的参数

考虑到客户端发送超大SQL会有威胁到SeaSQL DRDS的可能（目前尚未发现实际案例），SeaSQL DRDS可以同MySQL一样配置MAX_ALLOWED_PACKET，控制客户端发送给计算节点的SQL最大包大小，该参数可在server.xml中通过参数名maxAllowedPacket预置，如果计算节点的maxAllowedPacket默认值比MySQL大，日志会给warning提示，且管理平台配置校验会给出提示：

4.3 管理端信息监控

SeaSQL DRDS为客户提供了一套功能完善、操作便捷的信息监控、统计与服务管理功能。用户可以通过MySQL Client登录计算节点的监控管理端查看详细信息，详细说明请参考《H3C SeaSQL DRDS 管理端命令手册》。

4.3.1 管理端命令

用户可以登录管理端（默认端口：3325）使用show @@help命令查看支持的管理端命令和相应的作用。

root> mysql -uroot -proot -P3325 -h192.168.200.201

mysql: [Warning] Using a password on the command line interface can be insecure.

Welcome to the MySQL monitor. Commands end with ; or \g.

Your MySQL connection id is 992081

Server version: 5.7.35 SeaSQL DRDS 2.5.7 by H3C Tech

Oracle is a registered trademark of Oracle Corporation and/or its

affiliates. Other names may be trademarks of their respective

owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> show @@help;

+-------------------------------------------+--------------------------------------------------------------------+

| statement | description |

+-------------------------------------------+--------------------------------------------------------------------+

| check @@datasource_config | 检查MySQL参数配置信息 |

| check @@route [db_name.tb_name | tb_name] | 检测分片表数据路由正确性 |

| kill @@connection [connection_id] | 将某个指定的连接关闭 |

| onlineddl "[DDLSTATEMENT]" | 执行onlineddl |

| rebuild @@pool | 重建所有节点当前可用存储节点 |

| reload @@config | 重新读取配置信息 |

…省略更多内容，可自行登陆查看…

4.3.2 管理端操作

用户可以输入相应的命令以监控计算节点的服务情况，如显示存储节点信息：

mysql> show @@datasource;

+------+------+-----------------------+------+--------+-------------+------+--------------+--------+------+------+--------------------+--------------+--------+-------------+-----------------+

+------+------+-----------------------+------+--------+-------------+------+--------------+--------+------+------+--------------------+--------------+--------+-------------+-----------------+

| 17 | 17 | 10.10.0.140_3313_db01 | 1 | 1 | 10.10.0.140 | 3313 | db01 | 0 | 45 | 45 | NULL | 0/64 | 1 | 8 | 1 |

…省略更多内容，可自行登陆查看…

show@@命令后接的为一个表的表名，例如上个例子中，“show @@datasource;”，datasource为一个表的表名。

用户也可以对show @@命令后的表名进行DESC操作以查看该表各个字段的含义，如查看存储节点信息中各个字段的含义：

mysql> desc datasource;

+--------------------+------------------------------------------------------------------+

| filedname | description |

+--------------------+------------------------------------------------------------------+

| dn | 数据节点号(Datanode) |

| ds | 数据源号(Datasource) |

| name | 数据源名称(Datasource name) |

| type | 数据源类型(Datasource type) |

| status | 数据源状态(Datasource status) |

| host | 主机地址(Host) |

| port | 主机端口(Port) |

| schema | 物理数据库名(Physical database name) |

| active | 活动连接数(Active connections) |

| idle | 空闲连接数(Idle connections) |

| size | 总连接数(Total connections) |

| unavailable_reason | 数据源不可用原因(Reason for datasource unavailable) |

| flow_control | 剩余可用计数(Remaining available quantity in flow control) |

| idc_id | 机房ID(ID of IDC) |

| listener_id | LISTENER ID(ID of LISTENER) |

| listener_status | LISTENER STATUS(STATUS of LISTENER) |

+--------------------+------------------------------------------------------------------+

16 rows in set (0.00 sec)

用户还可以对show @@命令后的表名进行SELECT操作以进行任意条件的SQL查询，如查看11号数据节点上的存储节点：

mysql> select * from datasource where dn=11;

+------+------+-----------------------+------+--------+-------------+------+--------+--------+------+------+--------------------+--------------+--------+-------------+-----------------+

+------+------+-----------------------+------+--------+-------------+------+--------+--------+------+------+--------------------+--------------+--------+-------------+-----------------+

| 11 | 11 | 10.10.0.125_3311_db01 | 1 | 1 | 10.10.0.125 | 3311 | db01 | 0 | 43 | 43 | NULL | 0/64 | 1 | 2 | 1 |

+------+------+-----------------------+------+--------+-------------+------+--------+--------+------+------+--------------------+--------------+--------+-------------+-----------------+

1 row in set (0.00 sec)

4.4 前端连接数限制

计算节点支持限制前端连接数功能，出现访问过载时可辅助限制流量，功能同MySQL。使用方法为：在server.xml中进行配置：

maxConnections为前端最大连接数，默认5000；

maxUserConnections为前端最大用户连接数，默认0为不限制；

同时支持具有super权限的用户在服务端口set global max_connections=1; set global max_user_connections=0; 进行修改。

可以用SHOW VARIABLES来查看当前的连接数限制情况。

4.5 后端连接池管理

计算节点启动及运行过程中会与存储节点之间建立连接，在添加存储节点时，可通过四个配置控制连接数：

· 最大连接数：计算节点与存储节点（即MySQL物理库）之间可建立的最大连接数，超过即SQL无法正常执行；

· 初始连接数：计算节点与存储节点之间建立的初始连接数；

· 最小空闲连接数：计算节点与存储节点之间建立的最小空闲连接数；

· 最大空闲连接数：计算节点与存储节点之间建立的最大空闲连接数。

当定时检测线程发现连接池里面空闲连接小于最小空闲，创建连接；大于最大空闲，关闭连接。即：最小空闲≤连接池的空闲连接个数≤最大空闲，最大、最小空闲连接数主要控制连接池内的空闲连接数在一定范围内。

例如：

(1) 以单个计算节点举例（多计算节点服务各自限制连接数，也即极端情况下，存储节点连接数可能达到N倍），SeaSQL DRDS 存储节点配置：最大连接数4200，初始化连接数是32，最小空闲连接数64 ，最大空闲连接数：512

(2) 那么SeaSQL DRDS 计算节点在启动的时候，会与每个存储节点建立32个后端连接，定时检测线程检测时发现当前连接数不够最小空闲即增加到最小空闲连接64个；

(3) 此时若有一个2048并发的场景对计算节点压测，会发现连接池可用连接数不够用，计算节点会自动增加与存储节点的连接数。

(4) 当压测结束后，这些连接不会立即销毁，会等到空闲检测周期检测：如果空闲状态（即管理端show @@backend标记为Idle状态）的连接大于512 ，则销毁多余的连接到512个；如果小于512 就保持原样。

(5) 若需要空闲连接状态回到初始化状态，可以在计算节点运行过程中，参考《H3C SeaSQL DRDS 管理端命令手册》重建连接池rebuild @@pool 相关章节重建连接池，即恢复到初始连接状态。

4.6 磁盘空间使用限制

因磁盘空间不足会导致计算节点无法正常运行等诸多问题，计算节点在自动部署时会检测SeaSQL DRDS安装目录所在磁盘的剩余空间是否大于10G，同时，在写临时文件时也会检测磁盘的剩余空间，具体如下：

用户创建会话后执行例如复杂跨库JOIN等操作时，必要时会在SeaSQL DRDS安装目录下写入临时文件。写入临时文件的同时，计算节点若检测发现安装目录所在磁盘的剩余空间不足，则终止当前会话并报错与记录日志。

计算节点日志记录error级别日志如下，终止会话时提示信息与之相同：

2019-06-10 18:03:24.423 [ERROR] [DISKSPACE] [Employee-2] cn.hotpu.hotdb.mysql.nio.handler.MultiNodeHandler(88) - session[1606] was killed,due to less than 1G space left on device,and the size of temp-file is larger than the usable space.

4.7 错误码

若要了解管理平台错误码详情，可以点击“帮助中心”>>“API接口说明”页面中的【状态码】查看错误码详情。

4.8 动态加载（RELOAD）

计算节点可在不重启服务的情况下，在线加载配置信息。通过“动态加载”功能可立即生效的参数请参考计算节点参数说明。

动态加载有两种方式，一种是登录管理端（3325）执行：reload @@config命令；一种是登录管理平台，点击菜单栏右上角“动态加载”按钮，将新增配置项目动态加载到计算节点中进行使用。如下图所示：

为了保证计算节点正确加载配置信息，在执行动态加载前，可先校验配置信息。动态加载过程中，若遇到主备配置库、主备存储节点切换，提示用户并提供强制停止切换并动态加载和取消动态加载两种选择方案。

4.9 配置校验

(1) 登录管理平台，选择“配置”->“配置校验”进入配置校验面板，点击“开始校验”按钮，将校验分布式事务数据库可视化管理平台中“配置校验”菜单中的配置项。如下图所示：

(2) 上图显示，所有配置都正常通过。

(3) 若有配置项不正确，可根据错误提示，修改相应的配置：

(4) 通过计算节点管理端执行reload @@config命令动态加载时，默认也会先进行配置校验，校验通过后才允许动态加载。

4.10 死锁检测

在分布式事务数据库系统中，若死锁发生在两个数据节点下的存储节点间，MySQL的死锁检测机制将无法检测到死锁。

下面表格中的操作，描述了在分布式系统中，两个数据节点产生死锁的过程。会话一与会话二分别在两个数据节点上执行DELETE操作：

	会话一	会话二
会话一开启事务	start transaction;
会话二开启事务		start transaction
会话一在DNID为15的数据节点上执行DELETE语句	delete from customer where dnid=15 and id=1;
会话二在DNID为13的数据节点上执行DELETE 语句		delete from customer where dnid=13 and id=4;
会话一在DNID为13的数据节点上执行DELETE语句；DELETE操作将被会话二阻塞	delete from customer where dnid=13 and id=4;
会话二在DNID为15的数据节点上执行DELETE语句；此操作将被会话一阻塞；因会话一被会话二阻塞，会话二也被会话一阻塞，此时将产生死锁		delete from customer where dnid=15 and id=1;

上述情况中，会话一与会话二互相被阻塞，将产生死锁。因是在两个数据节点下的存储节点间，MySQL无法检测到死锁的存在。

在SeaSQL DRDS分布式事务数据库系统中，计算节点可检测到多个数据节点下的存储节点间的死锁，并回滚开销最少的事务。

在计算节点的配置文件server.xml中，将死锁检测周期设置为大于0的值，将开启死锁的自动检测功能。默认情况下，死锁检测是开启状态，检测周期为3000ms。

当deadlockCheckPeriod值设置为0时，将不启动死锁检测功能。

在开启计算节点的死锁检测时，再次执行上述的DELETE操作：

会话一，开启事务：

mysql> start transaction;

Query OK, 0 rows affected (0.00 sec)

会话二，开启事务：

mysql> start transaction;

Query OK, 0 rows affected (0.00 sec)

会话一，在DNID为15的数据节点上执行DELETE语句：

mysql> delete from customer where dnid=15 and id=1;

Query OK, 1 row affected (0.00 sec)

会话二，在DNID为13的数据节点上执行DELETE 语句

mysql> delete from customer where dnid=13 and id=4;

Query OK, 1 row affected (0.00 sec)

会话一，在DNID为13的数据节点上执行DELETE语句；DELETE操作将被会话二阻塞：

mysql> delete from customer where dnid=13 and id=4;

会话二，在DNID为15的数据节点上执行DELETE语句；此操作将被会话一阻塞；因会话一被会话二阻塞，会话二也被会话一阻塞，此时将产生死锁。

mysql> delete from customer where dnid=15 and id=1;

Query OK, 1 row affected (1.59 sec)

计算节点检测到死锁，回滚了会话一的事务：

mysql> delete from customer where dnid=13 and id=4;

ERROR 1213 (HY000): Deadlock found when trying to get lock; try restarting transaction

由于MySQL5.7及以上版本，事务中出现死锁回滚后，不会立即开启新事务。参考官方BUG链接：https://bugs.mysql.com/bug.php?id=98133。SeaSQL DRDS针对上述BUG做了兼容处理：对锁超时、死锁检测、后端连接断开，MySQL5.7及以上版本会根据前端连接autocommit判断是否要开启新事务。

4.11 SQL报错日志记录

若执行SQL时返回以下情况的报错信息，计算节点会将其记录到计算节点日志（hotdb-unusualsql.log）中：

· 主键\唯一键冲突或外键约束不满足导致的ERROR信息（即MySQL错误码1062、1216、1217、1451、1452、1557、1761、1762、3008）

· 数据溢出（即MySQL错误码1264、1690、3155、3669）和数据类型转换或隐式转换导致数据截断（即MySQL错误码1265、1292、1366）的情况

· 涉及binlog不安全语句（即MySQL错误码1418、1592、1663、1668、1669、1671、1673、1674、1675、1693、1714、1715、1716、1719、1722、1724、1727、1785、3006、3199、3570、3571、MY-010908、MY-013098）

· 对分片字段不是自增字段的分片表做INSERT操作时，由外部指定自增值的INSERT的情况

· UPDATE语句中出现MATCH和AFFECT不相符的情况

· DELETE出现删除0行的情况

· UPDATE或DELETE AFFECT超过10000行的情况

· 在HINT语句中使用了INSERT、UPDATE、DELETE和DDL语句的情况

· DDL语句执行出现报错信息的情况以及CREATE TABLE或ALTER TABLE分片表，主键或唯一键不包含分片字段，且没有使用全局唯一约束来保证字段唯一性时也会记录

· 发生部分提交的情况，即部分节点已经发出COMMIT后，其余节点没有发出COMMIT但连接断开的情况，或其余部分后端连接发出COMMIT后无响应且连接断开的情况，会记录整个事务到计算节点日志

· 发生语法错误的情况

· 执行因缺少路由规则无法路由的SQL的情况，例如INSERT不存在的ROUTE规则

· 执行被SQL防火墙拦截的SQL的情况

· 执行超时的SQL的情况

· 发生死锁被杀的事务的情况

· 发生因存储节点切换等原因被杀掉的事务的情况

· 执行锁超时回滚的SQL的情况

· 执行KILL命令后KILL掉的SQL的情况

· 发生被ROLLBACK的SQL的情况

· 前端连接异常断开回滚的SQL的情况

· 后端连接异常断开或其它异常导致回滚的情况

· 计算节点意外抛异常的情况

· 如果上述记录的SQL过长导致SQL语句被截取，还会额外记录WARNING信息

例如，执行一条出现主键冲突的SQL如下：

mysql> insert into table01 (id,title,author,submission_date) values (3,"apple", "apple pie", '2019-10-11-20-05');

ERROR 1062 (23000): Duplicate entry '3' for key 'PRIMARY'

查看计算节点日志（hotdb-unusualsql.log）：

2019-10-12 15:27:45.051 [INFO] [UNUSUALSQL] [$NIOREACTOR-7-RW] cn.hotpu.hotdb.mysql.nio.MySQLConnection(415) - ERROR 1062:Duplicate entry '3' for key 'PRIMARY' [frontend:[thread=$NIOREACTOR-7-RW,id=453,user=root,host=192.168.210.225,port=3323,localport=65442,schema=DBY]; backend:null; frontend_sql:insert into table01 (id,title,author,submission_date) values (3,"apple", "apple pie", '2019-10-11-20-05');backend_sql:null]

又如，执行一条被SQL防火墙拦截SQL如下：

mysql> select * from test;

ERROR 1064 (HY000): Intercepted by sql firewall, because: not allowed to execute select without where expression

查看计算节点日志（hotdb-unusualsql.log）：

2019-10-14 15:41:42.246 [INFO] [UNUSUALSQL] [$NIOExecutor-1-2] cn.hotpu.hotdb.route.RouteService(415) - ERROR 10029:not pass sql firewall [frontend:[thread=$NIOExecutor-1-2,id=1433,user=root,host=192.168.210.225,port=3323,localport=64658,schema=DBY]; backend:null; frontend_sql:null; backend_sql:null] [DBY.count]=33

· 以上日志类型的记录可通过unusualSQLMode来控制日志的输出频率，详情可参考unusualSQLMode章节。

· MySQL错误码解释可参考官方文档：https://dev.mysql.com/doc/refman/8.0/en/server-error-reference.html

该类日志信息默认保存在SeaSQL DRDS安装目录/logs/extra/unusualsql/目录下的hotdb_unusualsql.log文件中。若日志未记录至文件，可检查SeaSQL DRDS安装目录/conf目录下的log4j2.xml下，是否存在以下配置：

</RollingFile>

<RollingFile

name="Unusualsql"

filename="${sys:HOTDB_HOME}/logs/extra/unusualsql/hotdb-unusualsql.log"

filepattern="${sys:HOTDB_HOME}/logs/extra/unusualsql/hotdb-unusualsql-%d{yyyy-MM-dd-HH-mm-ss}.log">

<PatternLayout

pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%-4p] [%marker] [%t] %c(%L) - %msg%n"/>

</Policies>

</filters>

</RollingFile>

</Appenders>

4.12 只读计算节点实例

计算节点支持开启只读模式（instanceReadOnly）来平衡当前主计算节点的压力，或使用只读计算节点实例抽取数据做数据分析，一般适用于备计算节点或灾备模式下的灾备机房计算节点。

· 计算节点开启只读方式

¡ 修改server.xml中的instanceReadOnly为1开启只读计算节点，重启计算节点后生效

¡ 管理端执行online_readonly直接开启计算节点只读模式，online_readwrite可直接关闭计算节点只读模式

[email protected]:(none) 5.7.32 03:50:51> online_readonly;

Query OK, 1 row affected, 1 warning (0.03 sec)

Info (Code 10260): Online_readOnly command executed successfully and the instanceReadOnly parameter has been set to 1.

· 可通过show @@server接口中的mode字段查看是否开启了只读

· 开启只读的计算节点服务端只可执行DQL语句、SET会话级参数、show语句等；管理端涉及写操作的命令都不能执行，如全局表一致性修复、kill @@connection、stop @@heartbeat等操作，如：

¡ 服务端操作：

[email protected]:hotdb 5.7.32 04:24:51> create database test;

ERROR 1289 (HY000): Command CREATE_DATABASE not allowed in Read-Only mode.

[email protected]:hotdb 5.7.32 04:24:56> create table test(id int);

ERROR 1289 (HY000): Command CREATE_TABLE not allowed in Read-Only mode.

[email protected]:hotdb 5.7.32 04:25:02> insert into test values(1);

ERROR 1289 (HY000): Command INSERT not allowed in Read-Only mode.

¡ 管理端操作：

[email protected]:(none) 5.7.32 04:27:24> reload @@config;

ERROR 10234 (HY000): Not allowed to execute non-query command in readonly instance.

[email protected]:(none) 5.7.32 04:27:27> stop @@heartbeat;

ERROR 10234 (HY000): Not allowed to execute non-query command in readonly instance.

[email protected]:(none) 5.7.32 04:27:40> kill @@connection 11;

ERROR 10234 (HY000): Not allowed to execute non-query command in readonly instance.

· 普通模式下（含灾备模式的中心机房）只读计算节点默认读优先级最高的从库，优先级最高的从库不可用或从库复制延迟大于maxLatencyForReadOnly的值时，读次优先级的从库，从库都不可用则读主库

· 灾备模式的灾备机房只读计算节点读灾备机房的主库，主库不可用时拒绝读取

· 特定场景下的只读模式释放

¡ HA模式下，计算节点发生高可用切换会释放备的只读属性

¡ 灾备模式下，发生机房切换后，灾备机房当前主会释放只读属性

· 事务内开启只读，未结束的事务依旧可以读写，直到事务提交/回滚/超时

· 多计算节点集群只读模式下，开启参数allowReadConsistentInReadOnly、enableListener和enableXA且部署了监听组件后，可保证读一致性

· 计算节点实例级别的只读模式读从库的优先级高于用户级别的读写分离

· 主备模式下备计算节点若开启只读，则每10秒去主上同步最新配置信息；也可通过配置计算节点的集群参数实时同步配置（serverId、clusterSize、clusterNetwork、clusterHost、clusterPort）

· 集群模式下，只读计算节点不参与选主。如：备计算节点均开启了只读，主计算节点故障后会因无法选主导致集群不可用（仅管理端口可连接）

· HA模式下开启只读计算节点需要手动将keepalived脚本check_hotdb_process.sh中的online改为online_readwrite，否则高可用切换后，不会释放只读属性。

$70ZGAP$H{TVAI3VLM{_@}CJ$

· 主计算节点不建议设置为只读模式，reload会跳过只读计算节点实例，主计算节点开启只读可能会对业务造成影响

5 访问安全

5.1 权限体系

SeaSQL DRDS有两类用户，一类是计算节点数据库用户，用于操作数据，执行SELECT，UPDATE，DELETE，INSERT等SQL语句。另一类是分布式事务数据库可视化管理平台用户，用于管理配置信息。此章节将着重介绍计算节点用户相关内容。

计算节点数据库用户必须被赋予逻辑库的权限，才能访问逻辑库。计算节点提供了类似于MySQL的操作权限，如下：

权限类型	可执行的SQL语句
CREATE	CREATE TABLE,CREATE INDEX
DROP	DROP TABLE,DROP INDEX,TRUNCATE TABLE,RENAME TABLE
ALTER	ALTER TABLE,RENAME TABLE
SELECT	SELECT,INSERT…SELECT
UPDATE	UPDATE
DELETE	DELETE,REPLACE
INSERT	INSERT,REPLACE,INSERT…SELECT
SUPER	管理端的语句, /!HotDB:dnid=?/
FILE	SELECT…INTO OUTFILE,LOAD DATA

1. SUPER权限说明

具有SUPER权限的user，可以登录计算节点的3325端口，可执行管理端的所有SQL语句；否则，不能登录管理端与执行管理端的SQL语句。

拥有SUPER权限的user，可在3323端口执行HINT语句。如:

/*!hotdb:dnid=1*/select * from table

2. 权限范围

为计算节点数据库用户赋予权限时，除SUPER权限外，可指定user对逻辑库或表的操作权限。权限范围分为全局权限、逻辑库权限及表权限：

· 全局权限：拥有全局权限的user对所有逻辑库下的所有对象都拥有指定的权限。例如：勾选全局权限：SELECT，UPDATE，INSERT，CREATE，点击保存则当前用户可对所有逻辑库及表进行S/U/I/C操作。

· 逻辑库权限：拥有逻辑库权限的user对该逻辑库下的所有对象拥有指定权限。

· 表权限：表权限又分为表允许权限和表拒绝权限。拥有表允许权限的用户对该表拥有勾选的权限；拥有表拒绝权限的用户将拒绝勾选的权限，对于没有勾选的权限，需要在表允许权限下勾选后方能拥有。拥有表拒绝权限的用户对该表拥有除了勾选的权限以外的其他所有权限；例如：勾选表拒绝权限：SELECT，UPDATE，INSERT，CREATE，点击保存则当前用户不可对该表进行S/U/I/C操作，若该用户勾选了表允许权限：DELETE,DROP，则当前用户拥有DELETE和DROP权限。

SUPER权限不指定特定逻辑库。只有持有SUPER权限的user可以执行管理端的语句，管理端具体功能可参考管理端信息监控章节。

权限之间相互独立，拥有表的UPDATE权限，并不代表拥有该表的SELECT权限；拥有SUPER权限，并不代表拥有表的操作权限。另，TRIGGER相关的权限目前未单独维护，遵循权限规则为：CREATE TRIGGER 需要 CREATE 权限、DROP TRIGGER 需要 DROP权限、TRIGGER内部语句不验证权限、DEFINER 相关全去除、SHOW TRIGGERS时相关字段为当前用户。

5.2 通信认证

SSL（Secure Socket Layer安全套接层）是HTTPS下的一个协议加密层，有1、2、3三个版本，目前只使用SSL 3.0。IETF对SSL进行标准化后，在3.0版本的基础上发布了TLS1.0（Transport Layer Security 安全传输层协议）。TLS协议目前有1.0、1.1、1.2、1.3四个版本。

SeaSQL DRDS 2.5.5版本开始支持SSL加密连接方式登录计算节点。

5.2.1 生成TLS秘钥

1. 生成证书和密钥文件

可参考MySQL官方文档生成自签名的秘钥。例如：可以用MySQL自带的命令mysql_ssl_rsa_setup来生成证书和密钥文件。

mysql_ssl_rsa_setup --datadir=/usr/local/crt/

其中：

· 客户端需要的秘钥有：ca.pem、client-cert.pem、client-key.pem；

· 服务端需要的秘钥有：ca.pem、server-cert.pem、server-key.pem；

MySQL自带命令生成的证书无法进行CA认证，参考链接：https://dev.mysql.com/doc/refman/5.7/en/using-encrypted-connections.html

如果需要生成能够进行CA认证的自签名证书，需要使用openssl工具，可参考下列步骤进行：

(1) 生成CA根证书私钥：openssl genrsa 2048 > ca-key.pem

(2) 生成CA根证书：openssl req -new -x509 -nodes -days 3600 -key ca-key.pem -out ca.pem，注意信息填写步骤中Common Name最好填入有效域名，并且不能与签发的证书中的Common Name一样，这里我们填写127.0.0.1

(3) 生成服务器证书请求文件：openssl req -newkey rsa:2048 -days 3600 -nodes -keyout server-key.pem -out server-req.pem，注意信息填写步骤中Common Name需要填入SeaSQL DRDS所监听的IP地址/域名，客户端将用此IP进行服务的连接，注意不能和CA证书中的信息一样

(4) 用openssl rsa命令处理秘钥以删除密码：openssl rsa -in server-key.pem -out server-key.pem

(5) 为服务端生成自签名证书：openssl x509 -req -in server-req.pem -days 3600 -CA ca.pem -CAkey ca-key.pem -set_serial 01 -out server-cert.pem

(6) 生成客户端证书请求文件：openssl req -newkey rsa:2048 -days 3600 -nodes -keyout client-key.pem -out client-req.pem，注意信息填写步骤中Common Name不能和CA证书中的信息一样

(7) 用openssl rsa命令处理秘钥以删除密码：openssl rsa -in client-key.pem -out client-key.pem

(8) 为客户端生成自签名证书：openssl x509 -req -in client-req.pem -days 3600 -CA ca.pem -CAkey ca-key.pem -set_serial 01 -out client-cert.pem

2. 生成server.jks文件

对于计算节点来说，需要将秘钥转为Java标准的KeyStore文件。即下文中提到的.jks。生成步骤为：

(1) 先使用openssl工具将cert和key文件合成pfx文件：

本次样例中密码输入SDcrtest（程序自带的密钥文件其密码为hotdb.com，可直接使用，此处示例为需要另外重新生成秘钥时使用）

a. openssl pkcs12 -export -out server.pfx -inkey server-key.pem -in server-cert.pem -CAfile ca.pem

b. 输入密码SDcrtest

(2) 用Java提供的keytool工具将pfx转换为jks文件：

a. keytool -importkeystore -srckeystore server.pfx -destkeystore server.jks -srcstoretype PKCS12

b. 输入密码SDcrtest

5.2.2 配置TLS秘钥

生成好TLS秘钥后，将相应的秘钥文件分别传输到计算节点服务端和客户端所在的服务器上，并在计算节点中按要求配置如下三个参数之后才能使用：

· <property name="enableSSL">false</property>

¡ 参数说明：true代表开启SSL功能，false代表关闭SSL功能，默认值为false

· <property name="keyStore">/server.jks</property>

¡ 参数说明：计算节点在conf目录下默认提供了一套server.jks和client相关的pem文件，其密码为hotdb.com，可用于进行简单的连接测试。当选择使用自己生成 TLS证书或者使用付费的TLS证书进行连接，需根据实际的路径和名称来填写。例如：/usr/local/crt/server.jks。

· <property name="keyStorePass">BB5A70F75DD5FEB214A5623DD171CEEB</property>

¡ 参数说明：程序自带的密钥文件中密码是hotdb.com，通过select hex(aes_encrypt('hotdb.com',unhex(md5('Hotpu@2013#shanghai#2017'))));加密得到默认keyStorePass：BB5A70F75DD5FEB214A5623DD171CEEB。若使用自己生成的密钥文件，需根据实际输入的密码来填写。例如：前文输入密码SDcrtest，通过select hex(aes_encrypt('SDcrtest',unhex(md5('Hotpu@2013#shanghai#2017'))))查询到keyStorePass值，然后填写C43BD9DDE9C908FEE7683AED7A301E33。

配置好的参数如下图：

参数的修改无需重启计算节点服务，动态加载时会重新读取server.jks文件。若SSL相关逻辑初始化失败，动态加载不会失败，但后续的SSL连接无法正常建立，非SSL连接不受影响。

1. 注意事项

· 若计算节点找不到任何可用的server.jks文件，则启动或同步加载时会输出以下报错信息

· 若keyStorePass配置错误，则启动或者同步加载时输出以下报错信息

· 若证书配置错误，登录时会输出以下报错信息

5.2.3 TLS连接登录

1. MySQL客户端方式

(1) 对于普通的错误，登录时会输出以下报错信用如下方式指定秘钥文件进行连接：

mysql -ujing01 -p123456 -h192.168.240.117 -P3323 --ssl-ca=/usr/local/crt/ca.pem --ssl-cert=/usr/local/crt/client-cert.pem --ssl-key=/usr/local/crt/client-key.pem --ssl-mode=verify_ca

(2) 查看SSl是否开启：

2. JDBC方式

对于JDBC来说，也需要相应的秘钥文件。操作方式可参考MySQL官方手册，这里可通过两种方式：

· 可通过将CA导入Java信任库的方式：

keytool -importcert -alias MySQLCACert -file ca.pem -keystore truststore

则JDBC连接时使用truststore文件，例如：

jdbc:mysql://192.168.240.117:3323/smoketest?clientCertificateKeyStoreUrl=file:/usr/local/crt/truststore&clientCertificateKeyStorePassword=hotdb.com&verifyServerCertificate=true

· 可通过使用证书的方式：

openssl pkcs12 -export -in client-cert.pem -inkey client-key.pem -name "mysqlclient" -out client-keystore.p12

keytool -importkeystore -srckeystore client-keystore.p12 -srcstoretype pkcs12 -destkeystore keystore -deststoretype JKS

则JDBC连接时使用keystore文件，例如：

jdbc:mysql://192.168.240.117:3323/smoketest?clientCertificateKeyStoreUrl=file:/usr/local/crt/keystore&clientCertificateKeyStorePassword=hotdb.com

3. Navicat等类似的客户端方式

对于Navicat等类似的客户端，可以在客户端设置中配置相关的文件位置进行连接：

注：对于某些版本的Navicat可能在勾选验证CA证书名后无法连接，比如提示错误：“2026 SSL connection error: ASN: bad other signature confirmation”，这可能是该版本的动态链接库不兼容，需要将其目录下的`libmysql.dll`替换为MySQL Workbench中的同名文件，或者更新到更高的版本，参考链接。

6 备份恢复

6.1 使用mysqldump备份

6.1.1 mysqldump - 数据库备份程序

SeaSQL DRDS支持mysqldump功能，用法同MySQL一样。

· 使用mysqldump从计算节点导出数据时，要求指定添加如下参数：

--set-gtid-purged=OFF --no-tablespaces --skip-triggers --single-transaction --default-character-set=utf8mb4 --complete-insert --compact --skip-tz-utc [--replace|--insert-ignore] [--hex-blob] [--where=xxx]

· 使用mysqldump从MySQL导出数据，再导入计算节点时，要求添加如下参数：

--no-defaults --no-tablespaces --complete-insert --default-character-set=utf8mb4 --hex-blob --master-data=2 --no-create-db --set-gtid-purged=OFF --single-transaction --skip-add-locks --skip-disable-keys --skip-triggers --skip-tz-utc [--replace|--insert-ignore] [--no-create-info|--no-data] [–where=xxx] --databases xxx

注意：default-character-set参数的值请根据实际情况填写，例如utf8或utf8mb4等。若未使用指定参数，可能会出现时间差的问题，以及对于部分不支持的功能命令会报错。

6.2 使用二进制日志（增量）恢复

6.2.1 mysqlbinlog - 处理二进制日志文件的实用程序

计算节点支持mysqlbinlog命令，mysqlbinlog命令能够解析binlog文件用于同步增量数据，从而减少了将单机MySQL数据迁移至计算节点时的停机时间。使用mysqlbinlog连接远程mysql实例获取binlog文件并解析出其中的SQL语句，然后交由计算节点执行，从而将某个数据库的增量数据导入到计算节点某个逻辑库下。

(1) 首先，登入到管理端口（默认端口为3325），执行dbremapping命令添加数据库映射关系。关于dbremapping命令用法，请参考《H3C SeaSQL DRDS 管理端命令手册》。

dbremapping @@add@期望被导入的数据库名:逻辑库名

(2) 然后使用mysqlbinlog语句执行选中部分的binlog中SQL语句，要求使用如下语法与参数：

mysqlbinlog -R -h主机名 -P端口号 -v --base64-output=decode-rows --skip-gtids --to-last-log --stop-never --database=数据库名 --start-position=binlog起始位置 binlog文件名 | mysql -u用户名 -p密码 -h服务器 -P服务端口 -c --show-warnings=false

注：--to-last-log可替换为--stop-position，指定binlog终止位置而非执行到最新的binlog位置。此命令需要跟远程连接的MySQL实例同版本。

例如希望将192.168.200.77:3306中的物理库db01导入计算节点192.168.210.30中的逻辑库logicdb01：

(3) 先至192.168.210.30登入到管理端口3325，执行：

dbremapping @@add@db01:logicdb01

(4) 然后在192.168.210.30服务器上执行如下命令：

mysqlbinlog -R -h 192.168.200.77 -P3306 -v --base64-output=decode-rows --skip-gtids --to-last-log --stop-never --database=db01 --start-position=0 mysql-bin.000009 | mysql -uroot -proot –h192.168.210.30 –P3323 -c -A

6.2.2 mysqldump与mysqlbinlog的实际应用

此小节将展示如何在实际应用场景中，结合mysqldump的完整备份与mysqlbinlog的增量备份，将数据从源端单机MySQL中迁移到SeaSQL DRDS中。

· 整个操作过程中，不建议在数据迁移的源端或计算节点执行任何的DDL、参数变更等等非常规的操作动作。

· 由于单线程操作且受网络延迟制约，此方式追数据的执行速度会慢于MySQL复制的执行速度，因此不保证计算节点的执行速度能够满足实时追上的要求，有可能存在数据延迟不断增大的现象，此时需要寻找业务低谷重试，或者另外规划方案。

场景描述：希望将源端192.168.210.45:3309（该实例为有生产数据的普通MySQL实例）中的物理库db01导入计算节点192.168.210.32中的逻辑库logicdb01，参考步骤如下：

(1) 使用mysqldump从数据迁移的源端（即192.168.210.45:3309）导出表结构，在192.168.210.45服务器上执行如下命令（必须添加如下参数）：

root> mysqldump --no-defaults -h127.0.0.1 -P3309 -uhotdb_datasource -photdb_datasource --no-data --skip-triggers --set-gtid-purged=OFF --no-tablespaces --single-transaction --default-character-set=utf8mb4 --hex-blob --no-create-db --skip-add-locks --skip-disable-keys --skip-tz-utc --databases db01 >db01.sql

(2) 将表结构的SQL文件上传至计算节点所在服务器，即192.168.210.32后，登录到计算节点上执行如下命令，导入表结构成功：

mysql> source /root/db01.sql

(3) 使用mysqldump从数据迁移的源端（即192.168.210.45:3309）导出表数据，在192.168.210.45服务器上执行如下命令（必须添加如下参数）：

root> mysqldump --no-defaults -h127.0.0.1 -P3309 -uhotdb_datasource -photdb_datasource --no-create-info --skip-triggers --set-gtid-purged=OFF --no-tablespaces --single-transaction --default-character-set=utf8mb4 --hex-blob --master-data=2 --no-create-db --skip-add-locks --skip-disable-keys --skip-tz-utc --databases db01 >db01-1.sql

(4) 打开表数据的导出文件，查看当前binlog位置，如下显示则binlog位置为2410，binlog文件为mysql-bin.000076：

CHANGE MASTER TO MASTER_LOG_FILE='mysql-bin.000076', MASTER_LOG_POS=2410;

(5) 表数据的SQL文件上传至计算节点所在服务器，即192.168.210.32后，登录到计算节点上执行如下命令，导入表数据成功：

mysql> source /root/db01.sql

(6) 特别注意，如果使用了外键，需要额外执行以下命令：

mysql> set foreign_key_checks=0

mysql> source /root/db01.sql

· 执行过程中，应密切关注是否出现警告或错误，否则可能会出现数据会不一致的问题。

· Tips：如果业务数据没有数据乱码问题，可以考虑split切分文件，并行导入计算节点以加快处理速度。

(7) 使用mysqlbinlog做增量数据同步。若源端数据库名与计算节点的逻辑库名不相同，则需要在管理端口先添加数据库映射关系，例如：

dbremapping @@add@db01:logicdb01

(8) 然后到计算节点（192.168.210.32）所在服务器上执行如下命令，binlog开始位置为第四步记录的位置（此例子中为2410，binlog文件为mysql-bin.000076）：

mysqlbinlog -R -h192.168.210.45 -P3309 -uhotdb_datasource -photdb_datasource -v --base64-output=decode-rows --skip-gtids --to-last-log --stop-never --database=db01 --start-position=2410 mysql-bin.000076 | mysql -uroot -proot –h192.168.210.32 –P3323 -c –A

为了加快追数据的速度，建议执行mysqlbinlog命令的服务器就是计算节点所在服务器，这样节省了MySQL命令行客户端执行SQL时SQL和ok包通过网络来回的时间开销，可以极大提高计算节点单线程执行SQL的速度。

(9) 核对数据同步的正确性：此时需要进行必要的短时停服，中断业务系统向数据库的写入操作。通过人工在源端执行一条特殊数据后查看该条数据是否已经同步。等到确认计算节点已经追完最新数据后，停止mysqlbinlog命令，若需要的话，取消数据库名称映射。

Tips：可以在源端都执行如下命令后，将执行结果中出现的SQL语句复制后，在源端和计算节点都执行一遍，查看执行结果是否一致来大致地判断数据是否一致。

use xxx //逻辑库名

set session group_concat_max_len=1048576;

set @mytablename='xxx'; //表名

set @mydbname=database();

select concat('select sum(crc32(concat(ifnull(',group_concat(column_name separator ',\'NULL\'),ifnull('),',\'NULL\')))) as sum from ',table_name,';') as sqltext from information_schema.columns where table_schema=@mydbname and table_name=@mytablename \G

若执行结果一致，则表数据大概率一致。

例如在源端（192.168.200.77）MySQL实例中执行如下：

mysql> use db01

Database changed

mysql> set session group_concat_max_len=1048576;

Query OK, 0 rows affected (0.00 sec)

mysql> set @mytablename='table02';

Query OK, 0 rows affected (0.00 sec)

mysql> set @mydbname=database();

Query OK, 0 rows affected (0.00 sec)

mysql> select concat('select sum(crc32(concat(ifnull(',group_concat(column_name separator ',\'NULL\'),ifnull('),',\'NULL\')))) as sum from ',table_name,';') as sqltext from information_schema.columns where table_schema=@mydbname and table_name=@mytablename \G

*************************** 1. row ***************************

sqltext: select sum(crc32(concat(ifnull(id,'NULL'),ifnull(name,'NULL')))) as sum from table02;

1 row in set (0.00 sec)

msyql> select sum(crc32(concat(ifnull(id,'NULL'),ifnull(name,'NULL')))) as sum from table02;

+------------+

| sum |

+------------+

| 1812521567 |

+------------+

1 row in set (0.00 sec)

其结果（1812521567）与在计算节点执行结果一致，则table02表数据大概率一致。

6.3 使用mydumper备份/myloader恢复

6.3.1 mydumper备份

SeaSQL DRDS支持mydumper多线程备份工具，前提需要在server.xml中新增参数并执行动态加载：

使用mydumper从计算节点导出数据前，先创建备份文件存放目录，执行命令可参考如下：

mkdir -p /usr/local/mydumper

mydumper -h 192.168.210.130 -P 3323 -u root -p root -G -E -R -t 4 -c -o /usr/local/mydumper

备份完成后，在对应存放目录下可见备份文件格式如下：

更多详细参数请参考mydumper --help

6.3.2 myloader恢复

使用myloader恢复数据，执行命令参考如下：

myloader -u root -p root -P 33236 -h 192.168.210.130 -B hotdb -d /usr/local/mydumper

更多详细参数请参考myloader --help

6.4 使用mysqlpump备份

6.4.1 mysqlpump备份

SeaSQL DRDS支持mysqlpump功能，用法同MySQL一样。前提需要在server.xml中新增参数并执行动态加载：

使用mysqlpump从计算节点导出数据时，要求指定添加如下参数：

--set-gtid-purged=OFF --skip-triggers --single-transaction --default-character-set=utf8mb4 --complete-insert --skip-tz-utc [--default-parallelism=xxx] [--replace|--insert-ignore] [--hex-blob] [--add-drop-user] [--users] [--exclude-databases|--exclude-tables] [--include-databases|--include-tables]

· default-character-set参数的值按实际情况填写，如utf8或utf8mb4等。

· 若未使用指定参数，可能会出现时间差的问题，以及对于部分不支持的功能命令会报错。

· 通过mysqlpump导出的create user语句，计算节点不支持导入，需手动创建用户并赋权。

7 数据强一致

7.1 主从数据一致性检查

SeaSQL DRDS提供数据节点中的主从存储节点一致性校验的功能。需要校验的主备存储节点属于同一个数据节点。

主从数据一致性检查，可校验主库与从库各个表的表结构是否相同，表数据是否一致，主从是否延迟。当表数据在主库与从库间仅有少量的数据不一致时，主从数据一致性检查可定位到不一致的数据行主键值。

登录计算节点的管理端(3325端口)，执行show @@masterslaveconsistency命令，即可查看表在主库和备库上是否一致：

mysql> show @@masterslaveconsistency;

+---------------------------------+---------------------------------+-------+--------+--------------+

+---------------------------------+---------------------------------+-------+--------+--------------------------------------+

| DB_T | FB_STUDENT | dn_04 | NO | 存在数据不一致, 因为存储节点: 5, 表: FB_STUDENT, MySQL错误: Table 'db252.fb_student' doesn't exist |

| DB_A | SP | dn_04 | NO | 表: SP在节点: 4存在数据不一致，列: ID, 分布区间为: 0-17;, 并且不一致行唯一键为: (ID) :(2),(1) |

| DB_T | JOIN_Z | | YES | |

+---------------------------------+---------------------------------+-------+--------+--------------+

3 row in set (0.07 sec)

结果中显示逻辑库DB_T中的JOIN_Z表，在所有节点的主备存储节点之间，数据是一致的。表结构如下：

¡ db：逻辑库名称。

¡ table：表名称。

¡ dn：数据节点名称；当表在主备存储节点不一致时，此列会显示数据节点名称；

¡ result：校验结果为YES，表示该表在主备存储节点之间是一致的；为NO，表示该表在主备存储节点之间不一致，同时会在info输出不一致的信息；UNKNOWN，表示未知错误，可能存在表结构不一致的情况，主从复制中断都可能出现UNKNOWN。

¡ info：当主从数据一致时，无信息输出；当主从数据不一致时，会有以下几种信息：

不一致情况	示例
表的大量数据不一致	Table: … in datanode: … exist a large amount of data inconsistency
表的部分数据不一致	Table : … in datanode: … exist data inconsistency where ID in range:…;and inconsistent rows' primary key (…)：
从库表不存在	exist data inconsistency, because DS: … Table '…' doesn't exist
表索引不存在	DN: … not exsit index of table:…
主从故障检测（例如从机Slave_SQL_Running: NO状态）	DN: … ERROR! Check your replication.
主从延迟超过10S	DN：… delay too much,can't check master-slave data consistency
延迟超过2S	Replication latency is more than 2s, Master-Slave consistency detection result may be incorrect or cannot be detected in datanode:

7.2 全局自增序列

全局自增序列，是指表的AUTO_INCREMENT列在整个分布式系统中的各个节点间有序自增。SeaSQL DRDS提供全局自增序列的支持，当表中包含AUTO_INCREMENT列，并且在server.xml文件中，将参数autoIncrement设置为非0（设置为1或者设置为2）时，即可以像使用MySQL的AUTO_INCRMENT一样使用计算节点的全局自增序列。配置示例如：

1. 参数设置为0

若将参数autoIncrement设置为0，则自增字段在存储节点MySQL内维护；在表类型为分片表时，表现较明显，可能存在同一分片表，不同存储节点间自增序列重复的情况。

例如：customer为auto分片表，分片字段为id，且name定义为自增序列。则name的自增特性由各个存储节点控制：

mysql> create table customer(id int ,name int auto_increment primary key);

mysql> insert into customer values (1,null),(2,null),(3,null),(4,null);

Query OK, 4 rows affected (0.01 sec)

Records: 4 Duplicates:0 Warnings: 0

mysql> select * from customer;

+------+------+------+

| id | name | DNID |

+------+------+------+

| 4 | 1 | 1001 |

| 2 | 1 | 1006 |

| 3 | 1 | 1004 |

| 1 | 1 | 1008 |

+------+------+------+

4 rows in set (0.00 sec)

2. 参数设置为1

若将参数autoIncrement设置为1，则由计算节点接管所有表的自增，可以保证全局自增。

例如：customer为auto分片表，分片字段为id，且name定义为自增序列。则name的自增特性由计算节点控制，可实现全局自增：

mysql> create table customer(id int ,name int auto_increment primary key);

mysql> insert into customer values (1,null),(2,null),(3,null),(4,null);

Query OK, 4 rows affected (0.01 sec)

Records: 4 Duplicates: 0 Warnings: 0

mysql> select * From customer order by id;

+------+------+------+

| id | name | DNID |

+------+------+------+

| 1 | 1 | 1008 |

| 2 | 2 | 1006 |

| 3 | 3 | 1004 |

| 4 | 4 | 1001 |

+------+------+------+

4 rows in set (0.00 sec)

若将参数autoIncrement设置为1，自增字段类型必须为INT或BIGINT，否则建表提示warning：

mysql> create table table_test(id tinyint auto_increment primary key);

Query OK, 0 rows affected, 1 warning (0.05 sec)

Warning (Code 10212): auto_increment column must be bigint or int

自增序列1模式可保证全局唯一且严格正向增长，但不保证自增连续性。

3. 参数设置为2

若将参数autoIncrement设置为2，则由计算节点接管所有表的自增。在此模式下，当计算节点模式为集群模式且表中包含自增序列时，仅保证自增序列全局唯一与长期看相对递增，但不保证自增的连续性（短时间内不同节点间自增值会交错）。计算节点智能控制自增特性，进而帮助提升集群模式下计算节点的性能。若计算节点模式为高可用或单节点模式，则设置为2与设置为1的结果相同。

例如：若现有Primary计算节点A，Secondary计算节点B和Secondary计算节点C，设置批次大小（prefetchBatchInit ）初始值为100，则计算节点A的自增序列预取区间为[1,100]，计算节点B的预取区间为[101,200]以及计算节点C的预取区间为[201,300]，即：

mysql> create table test(id int auto_increment primary key,num int);

在计算节点A上执行：

mysql> insert into test values(null,1),(null,2),(null,3),(null,4);

mysql> select * from test order by id;

+----+------+

| id | num |

+----+------+

| 1 | 1 |

| 2 | 2 |

| 3 | 3 |

| 4 | 4 |

+----+------+

//自增序列预取范围为[1,100]

在计算节点B上执行：

mysql> insert into test values(null,1),(null,2),(null,3),(null,4);

mysql> select * from test order by id;

+-----+------+

| id | num |

+-----+------+

| 1 | 1 |

| 2 | 2 |

| 3 | 3 |

| 4 | 4 |

| 101 | 1 |

| 102 | 2 |

| 103 | 3 |

| 104 | 4 |

+-----+------+

//自增序列预取范围为[101,200]

在计算节点C上执行：

mysql> insert into test values(null,1),(null,2),(null,3),(null,4);

mysql> select * from test order by id;

+-----+------+

| id | num |

+-----+------+

| 1 | 1 |

| 2 | 2 |

| 3 | 3 |

| 4 | 4 |

| 101 | 1 |

| 102 | 2 |

| 103 | 3 |

| 104 | 4 |

| 201 | 1 |

| 202 | 2 |

| 203 | 3 |

| 204 | 4 |

+-----+------+

//自增序列预取范围为[201,300]

在以下两种情况会判断是否重新预取批次并重新计算下一批次大小，由此来调整合适当前业务环境的批次大小：

· 若当前批次使用率达到隐藏参数generatePrefetchCostRatio 配置的已消耗比例，则开始预取下一批次。例如若已消耗比例为90%，当前批次大小为100，现自增值已经达到90，则此时开始预取下一批次。

· 从取到批次时间开始计算，若已经到达超时废弃时间prefetchValidTimeout ，则根据当前批次使用率判断是否预取下一批次。例如若设置已消耗比例为90%，当前批次大小为100，现自增值已经达到80，此时达到超时时间且当前批次使用率达到配置的已消耗比例的50%，则开始预取下一批次。

当前允许用户插入指定自增值，无论自增值的大小是否大于批次大小，都能保证自增值的全局有序递增。例如当前批次大小为100，插入小于批次大小的自增值：

在计算节点A上执行

mysql> insert into test values(null,1);

mysql> insert into test values (11,5);

mysql> insert into test values(null,1);

mysql> select * from test order by id;

+----+------+

| id | num |

+----+------+

| 1 | 1 |

| 11 | 5 |

| 12 | 1 |

+----+------+

在计算节点B上执行

mysql> insert into test values(null,1);

+----+------+

| id | num |

+----+------+

| 1 | 1 |

| 11 | 5 |

| 12 | 1 |

| 101 | 1 |

+----+------+

注意：

· 自增序列2模式可保证全局唯一且长时间范围看是大致正向增长，不保证自增连续性；

· 对于自增序列的字段类型范围计算节点也可以感知，超过范围计算节点行为同MySQL一致；

· 若将参数autoIncrement_autoIncrement设置为2，自增字段类型必须为bigint，否则建表失败：

mysql> create table table_test(id tinyint auto_increment primary key);

ERROR 10212 (HY000): auto_increment column must be bigint

4. 参数设置为3或4

在V2.5.5及以上版本新增了3和4，将参数autoIncrement设置为3或4，满足垂直表带自增的情况，自增值由MySQL处理，不由计算节点接管垂直表的自增。除垂直表带自增外，参数3和4分别与1和2处理模式一致，即autoIncrement=3时相当于autoIncrement=1+垂直表自增不进行处理；autoIncrement=4时相当于 autoIncrement=2+垂直表自增不进行处理。

7.3 数据强一致性（XA事务）

在分布式事务数据库系统中，数据被拆分后，同一个事务可能会操作多个数据节点，产生跨库事务。在跨库事务中，事务被提交后，若事务在其中一个数据节点COMMIT成功，而另一个数据节点COMMIT失败；已经完成COMMIT操作的数据节点，数据已被持久化，无法再修改；而COMMIT操作失败的数据节点，数据已丢失，这种情况会导致数据节点间的数据不一致。

SeaSQL DRDS利用MySQL提供的外部XA事务，可解决跨库事务场景中，数据的强一致性：要么所有节点的事务都COMMIT，要么所有的节点都ROLLBACK，以及提供完全正确的SERIALIZABLE和REPEATABLE-READ隔离级别支持。

7.3.1 使用XA事务

在计算节点中，默认情况下，XA事务是关闭的。要使用XA事务，需在server.xml文件中，将属性enableXA设置为TRUE：

重新启动计算节点后方能生效。若XA事务开关被修改后，未重启计算节点直接进行动态加载，修改结果不会生效且会在计算节点日志中有INFO信息：

Can't reset XA in reloading, please restart the hotdb to enable XA

计算节点在开启XA事务功能后，对于应用程序或者客户端MySQL命令操作都是透明的，SQL命令，事务流程没有任何变化，可像普通事务一样使用。用START TRANSACTION或者BEGIN，SET AUTOCOMMIT=0开启事务， COMMIT或ROLLBACK提交或者回滚事务；开启自动提交也同样支持。

在系统中使用计算节点的XA事务，为保证事务的强一致性，需注意以下几点：

· MySQL版本必须为5.7.17及以上。因为5.7.17之前的版本，MySQL在处理XA事务时，存在缺陷。因此在开启XA模式下，若计算节点启动时检测到存在任意存储节点MySQL版本低于5.7.17则计算节点启动失败；若启动计算节点后添加低于5.7.17的存储节点，动态加载将失败；若启动计算节点前低于5.7.17的存储节点无法连接，即使启动后重新连接成功，该存储节点仍然为不可用且动态加载将失败。以上情况都将输出ERROR级别的日志提示：Currently in XA mode, MySQL version is not allowed to be lower than 5.7.17.

· 存储节点及配置库需开启半同步复制（额外注意：开启XA模式时，不允许使用MySQL Group Replication复制模式），当开启半同步复制时，不建议开双1（innodb_flush_log_at_trx_commit = 1,sync_binlog = 1）模式，两者同时开启也会影响性能；

· 部署和使用XA强一致模式，需配置数据节点的高可用，并注意在主机故障切换从机后，原主机不可重用，不可直接在计算节点中标记其为可用，后续必须重新部署原主机，才可标记为可用。

· XA事务的完整支持serializable、repeatable read、read committed，暂不支持read uncommitted，但当前端隔离级别设置为read committed时，需参考参数allowRCWithoutReadConsistentInXA说明，注意避免读写强一致性的问题。

· 开启XA模式，使用HINT后，因计算节点无法控制HINT语句修改的内容，后续跟这个连接相关的任何操作计算节点都不再控制隔离级别的正确性。

特殊说明：

· XA模式下：参照SQL99标准，begin\start transaction会立即开启一个事务。也即在XA模式打开的情况下，begin\start transaction将等同于start transaction with consistent snapshot。

· 在计算节点版本高于2.5.6 （包含）时，XA模式下前端连接断开时会将事务的状态记录到日志及配置库中，也可以直接通过服务端口执行SHOW ABNORMAL_XA_TRX查看是否需要重做事务。

2020-10-30 15:42:29.857 [WARN] [MANAGER] [$NIOExecutor-2-10] cn.hotpu.hotdb.manager.response.v(39) - [thread=$NIOExecutor-2-10,id=17,user=root,host=127.0.0.1,port=3323,localport=58902,schema=TEST_CT]killed by manager

2020-10-30 15:42:29.857 [INFO] [INNER] [$NIOExecutor-2-10] cn.hotpu.hotdb.server.d.c(1066) - XATransactionSession in [thread=$NIOExecutor-2-10,id=17,user=root,host=127.0.0.1,port=3323,localport=58902,schema=TEST_CT]'s query will be killed due to a kill command, current sql:null

2020-10-30 15:42:29.859 [INFO] [CONNECTION] [$NIOExecutor-2-10] cn.hotpu.hotdb.server.b(3599) - [thread=$NIOExecutor-2-10,id=17,user=root,host=127.0.0.1,port=3323,localport=58902,schema=TEST_CT] will be closed because a kill command.

特殊说明：

· disconnect_reason：连接断开原因，如kill前端连接（kill）、TCP连接断开（program err:java.io.IOException: Connection reset by peer）、SQL执行超时（stream closed,read return -1）、空闲超时（idle timeout）等。

· trx_state：连接断开时的事务状态，包括：1.ROLLBACKED_BY_HOTDB：在事务中且事务被计算节点回滚（对应非自动提交时应用程序未发出commit命令或commit命令中途丢失）；2.COMMITED_BY_HOTDB：在事务中且事务被计算节点提交（对应非自动提交时，计算节点收到了commit并成功提交，但是在commit中途前端连接断开，因此计算节点未能成功发出ok包）。

7.3.2 XA事务与读写分离的关系

XA模式下，当开启读写分离时：只有非事务内的单节点的读请求是可分离的，且模式3退化成模式2；

XA模式下，当开启读写分离时：无法保证隔离级别正确性，但能保证数据不丢，且不出现部分提交/部分回滚；

同时使用时，计算节点日志会输出相关Warning提醒。

7.4 非确定性函数代理

非确定性函数在使用中，会带来一系列问题，尤其是全局表的数据一致性问题，为此SeaSQL DRDS提供非确定性函数代理的功能。非确定性函数大致分为两类，一类是已知值的时间类函数，如CURDATE()、CURRENT_TIMESTAMP()等，一类是未知值的随机值函数、唯一值函数，如RAND()、UUID()等。

· 对于时间类函数，计算节点进行统一代理。

¡ 当表的字段类型有DATETIME（或者TIMESTAMP）且无默认值时，由参数timestampProxy控制计算节点的代理范围（默认为自动模式，可选全局处理/自动检测），将此类函数代理为具体值插入到表中；

¡ 当SELECT/INSERT/UPDATE/DELETE语句中出现curdate()、curtime()等函数时，计算节点将函数代理为具体值插入到表中；

· 对于随机值函数，计算节点针对不同的SQL语句进行不同的代理办法。

· 对于唯一值函数，计算节点进行统一代理。

¡ 当SELECT/INSERT/UPDATE/DELETE语句中出现uuid()或uuid_short()时，计算节点按照标准的UUIDv1算法代理唯一值；

¡ 当存储节点和配置库的server_id冲突时，计算节点自动禁用uuid_short()并告知用户手动调整server_id。可参考MySQL官网说明：https://dev.mysql.com/doc/refman/5.7/en/replication-options.html。

7.5 全局时区

为保证数据的正确性，针对不同存储节点服务器存在设置不同时区，导致数据库中时间类型的数据错误的问题，SeaSQL DRDS 提供对全局时区的支持，包括：

· 当time_zone参数为具体的相同值或者全为SYSTEM并且system_time_zone全为相同的具体值时，SeaSQL DRDS不做特殊处理，否则SeaSQL DRDS会统一将time_zone设置为固定值：“+8:00”且会记录警告级别的日志（The datasources' time_zones are not consistent）；

a. 如登入服务端口后输入命令：

set time_zone = '+0:00';

show variables like '%time_zone';

b. 仍会显示time_zone为'+8:00':

mysql> set time_zone='+0:00';

mysql> show variables like '%time_zone';

+------------------+--------+

| Variable_name | Value |

+------------------+--------+

| system_time_zone | CST |

| time_zone | +08:00 |

+------------------+--------+

2 rows in set (0.09 sec)

· 备份与恢复时，SeaSQL DRDS能保证恢复后时间类型的数据与备份前一致。

7.6 全局唯一约束

若开启全局唯一约束功能，SeaSQL DRDS可以保证拥有唯一约束（UNIQUE、PRIMARY KEY）的列在所有节点都是唯一的，包括但不限于以下场景：

· 唯一约束键不是分片字段或不包含分片字段

· 父子表下，子表与父表的关联字段与子表的唯一约束键不是同一列

SeaSQL DRDS 2.5.3将全局唯一约束优化精确到表级别，默认为所有未来添加的表关闭全局唯一约束，也可以手动在添加表时为某些表单独关闭／开启全局唯一约束。

可以通过修改server.xml中的如下参数或在管理平台计算节点参数配置中修改此参数。修改参数只为未来添加的表设置全局唯一的默认值，但并不影响历史数据表的全局唯一性。

<property name="globalUniqueConstraint">false</property>

开启该功能后，可能对SQL语句INSERT、UPDATE、DELETE的执行效率有较大影响，可能导致SQL操作延迟增大；还可能导致锁等待和死锁的情况增加。请酌情考虑后注意取舍。

7.6.1 创建表时的表级别控制

添加表信息时可以为某张表单独开启／关闭全局唯一约束。

· 在管理平台上添加表信息时，根据计算节点参数默认显示全局唯一约束开关状态，可手动修改：

垂直分片表与全局表没有此入口，因为不需要对唯一约束做额外处理。添加完表配置后即可使用建表语句添加表结构后使用。

· 使用自动建表功能，可通过table option GLOBAL_UNIQUE [=] {0 | 1}设置全局唯一约束的开关。例如：

mysql> create table test02(id not null auto_increment primary key,a char(8),b decimal(4,2),c int) GLOBAL_UNIQUE=0;

mysql> create table test03(id int primary key,id1 int) GLOBAL_UNIQUE =1;

若不使用GLOBAL_UNIQUE [=] {0 | 1}，则默认根据计算节点参数配置的默认值或在管理平台上添加的表配置设置开启或关闭；若GLOBAL_UNIQUE=1则判断为开启；若GLOBAL_UNIQUE=0则判断为关闭。

· 若GLOBAL_UNIQUE设置与默认值不同，则以GLOBAL_UNIQUE为准；

· 若GLOBAL_UNIQUE设置与管理平台中此表的全局唯一约束配置不同，则会建表失败，并给出error提醒，例如管理平台添加test01时关闭了全局唯一约束：

mysql> create table test01(id int)global_unique=1;

ERROR 10172 (HY000): CREATE TABLE FAILED due to generated table config already in HotDB config datasource. You may need to check config datasource or reload HotDB config.

· 若在垂直分片表或全局表的建表语句中使用GLOBAL_UNIQUE，则会建表成功，但会给出warning信息，因为不需要对其唯一约束做额外处理，例如test03是一张垂直分片表：

mysql> create table test03(id int)global_unique=1;

Query OK, 0 rows affected, 2 warnings (0.09 sec)

Warning (Code 10032): Create table without primary key and unique key

Note (Code 10210): Global_unique is not applicable to vertical-sharding tables or global tables.

为了满足MySQL的兼容性，例如使用mysqldump时不用担心GLOBAL_UNIQUE对备份结果造成干扰，将GLOBAL_UNIQUE语法解析为注释格式，例如：

mysql> create table test02(id int) GLOBAL_UNIQUE=1;

mysql> show create table test02

+-------+----------------------------------------+

| Table | Create Table |

+-------+----------------------------------------+

| test3 | CREATE TABLE `test3` (

`id` int(11) DEFAULT NULL

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4/*hotdb:020503 global_unique=1*/ |

+-------+----------------------------------------+

1 row in set (0.00 sec)

将含有GLOBAL_UNIQUE语法的建表语句导入MySQL不会对结果有影响。在计算节点也可以直接用注释语法操作GLOBAL_UNIQUE，使用-c作为MySQL登陆参数允许执行注释。

root> mysql -c -uroot -proot -h127.0.0.1 -P3323

例如执行如下语句，表示在SeaSQL DRDS版本高于2.5.3时会执行GLOBAL_UNIQUE=0：

mysql> create table test02(id not null auto_increment primary key,a char(8),b decimal(4,2),c int) /*hotdb:020503 GLOBAL_UNIQUE=0*/;

7.6.2 修改表时的表级别控制

· 可以在管理平台的表信息管理页面修改表配置。

若表结构为已创建的表，全局唯一约束修改为开启状态后，点击动态加载并刷新页面，若出现如下图提示，说明需要到管理端口执行unique @@create，检查此表唯一约束键的历史数据，返回结果是唯一后，计算节点自动创建辅助索引，全局唯一约束方能生效，此命令详情请参考《H3C SeaSQL DRDS 管理端命令手册》：

· 在计算节点通过ALTER TABLE使用GLOBAL_UNIQUE语法，开启全局唯一，同理，出现warning信息说明需要执行unique @@create后方能生效：

mysql> alter table keevey01 global_unique=1;

Query OK, 0 rows affected, 1 warning (0.01 sec)

mysql> show warnings;

+-------+-------+---------------------------------------------------------+

| Level | Code | Message |

+-------+-------+---------------------------------------------------------+

| Note | 10210 | please go to SeaSQL DRDS manager port and execute this command: unique @@create, otherwise this global_unique setting doesn't work. |

+-------+-------+---------------------------------------------------------+

1 row in set (0.00 sec)

7.6.3 分片方案在线变更

分片方案在线变更时也可以为变更后的表手动开启或关闭全局唯一约束。

开启后，在变更方案预检会检测此表唯一约束键的历史数据是否唯一，若唯一，则通过测试。

7.6.4 查询时通过辅助索引定位

此功能还支持在SELECT查询语句中不包含分片字段但包含唯一约束字段时，通过查询辅助索引定位到固定节点，将SELECT查询语句仅下发到指定的节点而非所有节点。

<property name="routeByRelativeCol">false</property>

此项功能默认关闭，可通过修改server.xml中的routeByRelativeCol参数或在管理平台配置菜单下的计算节点参数配置中添加参数“不包含分片字段时是否开启通过辅助索引字段路由”。

此参数开启后，作用举例如下：现有一个水平分片表table01，分片字段为id，分片规则为auto_mod，执行如下查询语句时：

SELECT * FROM table01 WHERE unique_col = 100; //unique_col是唯一约束列

此查询语句将只下发到 unique_col = 100 的那一个数据节点，而不是所有数据节点

7.7 故障切换后的数据正确性保障

无论是异步复制还是半同步复制，都可能会存在这样一种情况：在故障切换全部完成后，原主库恢复，新主库（原从库）复制IO线程可能自动重连并获取到切换前没有获取到的事务，而这样的事务在切换的处理过程中，已经是被认定没有提交成功的事务，不能再继续复制，否则会有数据混乱的风险。

因此增加计算节点参数failoverAutoresetslave ，默认关闭。

<property name="failoverAutoresetslave">false</property>

故障切换后，会暂停原主从之间IO线程，并对原主库每分钟进行一次心跳检测直到原主库恢复正常。原主库恢复正常后，对比原主库的binlog位置，检测原从库（现主库）是否存在切换前没有获取到的事务，若存在，开启此参数则自动重置主从复制关系。若不存在未接收的事务，则重新开启IO线程并不再做任何处理。

注意：

· 检测是否有未接收的事务的前提是主从库都需要开启GTID，否则此参数开启时，故障切换完成会自动重置主从复制关系。

· 若原主库在心跳检测时重试超过10080次，仍然为不可用状态，此时，参数为开启状态，也会自动重置主从复制关系。

· 若发生自动重置复制关系后，计算节点记录warning级别的报警日志如下：

you should decide whether to manually execute the unexecuted part of binlog or rebuild the replication according to the actual situation.

且管理平台中的主备状态会显示异常，鼠标悬浮显示如图提示信息：

· 若故障切换完成后，主从库未开启GTID或存在未接收的事务，但此参数为关闭状态，计算节点也会记录warning级别的报警日志如下：

DBA is required to deal with the new master, which is the original slave before switching and decide whether to stop replication or continue replication regardless. In addition, there is risk of data error caused by automatic reconnection of replication after manual or unexpected restart of the new master.

7.8 注意事项

以下场景中，可能会出现数据不一致的情况，包括主从存储节点的数据不一致，和数据节点之间的数据不一致：

· 人为操作

¡ 人为或应用程序直接操作存储节点，可能导致任意类型的不一致；

¡ 使用HINT语句操作数据，可能导致任意类型的不一致；

¡ 未正确使用外键约束；在不支持的场景下使用存储过程、触发器、视图；未正确使用event等。对于计算节点来说，这些操作相当于“人为或应用程序直接操作存储节点”；

¡ 强行修改表的配置规则而没有对应调整数据路由，或使用过去遗留的有BUG的分片规则等，可能导致路由不正确；

¡ 设置server.xml 参数checkUpdate=false时，即允许更新分片字段，可能导致路由不正确，进而导致数据操作时存在与预期不一致的问题；

¡ 未use逻辑库的情况下，执行了连接绑定语句（包括HINT、set [session] foreign_key_checks=0、START TRANSACTION /*!40100 WITH CONSISTENT SNAPSHOT */、set [session] UNIQUE_CHECKS=0等），导致其SQL语句均直接下发至存储节点执行，进而可能导致任意类型的不一致；

· 环境配置

¡ 存储节点所在服务器时间不一致，在低于2.5.1版本时，会存在导致全局表timestamp类型数据不一致的问题、事务内时间不一致问题；在大于等于2.5.1版本，则参考timestampProxy设置的模式与场景；

¡ 存储节点搭建从机方法不当，例如使用extrabackup备份恢复数据的方式搭建从机；

¡ 主从存储节点MySQL发行分支、版本不一致；

¡ 不合理的存储节点MySQL参数设置、复制架构等导致不一致，包括但不限于：使用语句格式的binlog、部分复制、多主复制、配置不正确的二级从、主从或节点间字符集、时区配置不一致等；

¡ 在没有开启全局唯一约束的情况下，不含分片字段的唯一键无法保证全局唯一；

¡ 异常情况

¡ 在做DDL操作时存储节点故障、后端连接异常中断导致存储节点间表结构不一致，表结构不一致在部分时候可能带来更多不一致的数据；

¡ 故障切换后，业务上数据正确，但无法完全保证故障的主与切换到的从的数据一。同时，被标记为“不可用”的存储节点如果操作不当，例如在未校验数据一致性的情况下将其重新标记为“可用”并加入数据节点，会导致不一致；

¡ 非XA模式下：计算节点被强杀、存储节点故障、后端连接异常中断导致连接断开所产生的部分提交；

¡ 计算节点高可用（HA）模式下，多个服务端口（3323）开启提供服务；

¡ 服务器（包括计算节点、存储节点等）磁盘已满等操作系统故障；

¡ 计算节点/MySQL OOM等服务异常；

¡ 份恢复数据时出现异常，例如部分节点backup服务关闭，存储节点出现故障等，可能导致数据出现不一致；

¡ 其他

¡ MySQL自身BUG，可能导致任意类型的数据不一致。应尽量使用稳定的MySQL版本与功能，不能盲目追求MySQL新功能；

¡ 计算节点自身BUG，或者设计上还有遗漏的地方，可能导致任意类型的数据不一致。应及时更新至计算节点最新版本；

¡ 非XA模式下读到半个事务，主从读写分离读到旧数据等非永久性的不一致。

8 高可用服务

此章节主要描述了单机房模式下的计算节点集群的高可用服务，若要了解容灾模式下的高可用服务，请参考《H3C SeaSQL DRDS 跨机房容灾功能使用手册》。

8.1 高可用服务

SeaSQL DRDS提供数据节点内的MySQL高可用，当主存储节点不可用时，计算节点将自动切换到从存储节点。

若要使用数据节点高可用，需满足以下前提：

· 在数据节点内配置主从存储节点与故障切换优先级规则；

· 主从存储节点之间必须已配置主从或双主的复制关系；

· 在计算节点配置文件中开启心跳功能。

8.1.1 数据节点高可用

MySQL数据库主从的配置方式，请参考MySQL的官方网站（注意对应版本的官方文档，例如：http://dev.mysql.com/doc/refman/5.6/en/replication.html）

默认情况下，计算节点心跳功能是开启的：

假设192.168.200.202的3309实例与192.168.200.203的3313实例为一对主从复制的MySQL数据库。

配置同一个节点内的主从存储节点，可以在管理平台中的“添加节点”页面或者“存储节点更新”页面中设置。

(1) 在管理平台页面中选择“配置”->“节点管理”->“添加节点”，跳转到“添加节点”页面：

(2) 在下述操作中，生成一个数据节点“dn_08”，并为该数据节点添加了一个主存储节点“ds_failover_master”和一个从存储节点“ds_failover_slave”：

(3) 可直接勾选“自动适配切换规则”，添加节点同时自动适配故障切换优先级。或在管理平台页面中选择“配置”->“节点管理”->“高可用配置”->“切换规则”->“添加切换规则”，在数据节点下拉框中选择“dn_08”，在存储节点的下拉框中选择主存储节点“ds_failover_master，在备用存储节点下拉框中选择“ds_failover_slave”，在故障切换优先级选择高：

(4) 或点击“自动适配”，选择dn_08节点，保存即可。

主从复制关系搭建：

虽然在节点dn_08下添加了一对主从存储节点，但若这2个存储节点实际并没有搭建主从复制关系，此时可以在“配置”->“节点管理”->“高可用配置”->“主从搭建”中，选择“dn_08”节点。

点击“开始搭建”后，系统会自动对存储节点搭建主从复制关系。当搭建成功后，列表中主从状态会正常显示:

2. 手动切换

在“配置”->“节点管理”，点击某个数据节点的切换即可完成：

说明：

· 如果是主从，选择优先级最高的进行切换，切换后计算节点会将原主机和原主机的其他从机置为不可用，不能再进行切换。

· 如果是双主，切换后不会将原主库置为不可用，可以继续手动来回切换。

· 如果优先级最高从库不可用或延迟超过10s，依次选择剩余从库中优先级较高的进行切换，如果均不可用或存在延迟超过10s，则不切换，提示错误（切换失败日志提示 switch datasource datasourceid failed due to:no available backup found）

· 在计算节点版本高于2.5.6 （包含）手动切换时，会先检查当前的hotdb_datanode/hotdb_datasource/hotdb_failover表是否与running 表中一致，若不一致会提示：“当前存储节点的配置信息与内存中的配置信息不一致，无法进行切换，请动态加载后重试”；若校验通过，在新备存储节点接管前，会将被接管的存储节点更新为主库，原主库更新为双主备库或从库（注：若为主从关系，原主库及其相关的从节点均被级联置为不可用，且切换时会同步清理原复制关系，将原主库与原从库的故障切换规则进行互换，待人工进行线下的复制关系重建）

· 切换成功时，计算节点记录切换过程日志：

INFO [pool-1-thread-1064] (SwitchDataSource.java:78) -received switch datasourceid command from Manager : [连接信息]

WARN [pool-1-thread-1339] (BackendDataNode.java:263) -datanode id switch datasource:id to datasource:id in failover. due to: Manual Switch by User: username

INFO [pool-1-thread-1339] (SwitchDataSource.java:68) -switch datasource:id for datanode:id successfully by Manager.

· 在没有配置切换规则时，不会进行切换，提示错误: switch datasource id failed due to:found no backup information）

3. 故障切换

故障切换一般是因存储节点发生故障后自动产生的切换，说明如下：

· 不论是双主还是主从，主库发生故障并切换后，都会将主库置为不可用，不能再进行切换。需要人工去恢复主库，主库正常后，手动将主库置为可用，动态加载后会将主库恢复为可用状态。

· 如果从库状态为不可用，则不切换，计算节点记录日志

WARN [pool-1-thread-2614] datanode id failover failed due to found no available backup

· 在server.xml可以配置参数waitForSlaveInFailover控制切换是否等待从库追上复制，该参数默认为true等待，在切换过程中，会等待从库追上复制，如果设置为false不等待，则会立即切换。（立即切换存在数据丢失的风险，不建议设置）。

· 一主多从的情况下，计算节点选择优先级最高的从库进行切换，如果优先级最高从库不可用，依次选择剩余从库中优先级较高的进行切换，如果均不可用，则不切换，计算节点记录日志WARN [pool-1-thread-2614] -datanode id failover failed due to found no available backup；

· 在SeaSQL DRDS 版本高于2.5.6 （包含）故障切换时，在新备存储节点接管前会将被接管的存储节点更新为主库，原主库更新为双主备库或从库，并置为不可用，原主库相关的从节点均被级联置为不可用（注：若为主从关系，切换时会同步清理原复制关系，且将原主库与原从库的故障切换规则进行互换，待人工进行线下的复制关系重建）

· 故障切换过程中，主库心跳不停，如果连续两次成功，则放弃切换，计算节点记录日志

INFO [$NIOREACTOR-6-RW] (Heartbeat.java:502) -heartbeat continue success twice for datasource 5 192.168.200.52:3310/phy243_05, give up failover.

· 切换成功时，计算节点记录日志，并记录切换原因：

¡ 如果是网络故障、服务器宕机，掉电等，则记录Network is unreachable

¡ 如果网络可达，存储节点服务停止，没有响应，则记录MySQL Service Stopped

¡ 如果存储节点服务开启，但是响应出现异常，则记录MySQL Service Exception

例如：存储节点服务关掉时，整个切换过程提示如下：

02/21 15:57:29.342 INFO [HeartbeatTimer] (BackendDataNode.java:396) -start failover for datanode:5

02/21 15:57:29.344 INFO [HeartbeatTimer] (BackendDataNode.java:405) -found candidate backup for datanode 5 :[id:9,nodeId:5 192.168.200.51:331001_3310_ms status:1] in failover, start checking slave status.

02/21 15:57:29.344 WARN [$NIOREACTOR-0-RW] (HeartbeatInitHandler.java:44) -datasoruce 5 192.168.200.52:331001_3310_ms init heartbeat failed due to:MySQL Error Packet{length=36,id=1}

02/21 15:57:29.344 INFO [pool-1-thread-1020] (CheckSlaveHandler.java:241) -slave_sql_running is Yes in :[id:9,nodeId:5 192.168.200.51:331001_3310_ms status:1] during failover of datanode 5

02/21 15:57:29.424 WARN [pool-1-thread-1066] (BackendDataNode.java:847) -datanode 5 switch datasource 5 to 9 in failover. due to: MySQL Service Stopped

02/21 15:57:29.429 WARN [pool-1-thread-1066] (Heartbeat.java:416) -datasource 5 192.168.200.52:331001_3310_ms heartbeat failed and will be no longer used.

· 在没有配置切换规则时，不会进行切换，计算节点记录日志

WARN [pool-1-thread-177] (?:?) -datanode id failover failed due to found no backup information

· 在存储节点发生故障切换后，不论主从还是双主，我们统一要求，手动将存储节点置为可用的前提是操作人员必须清楚当前主从服务无异常，数据同步无异常，特别是主从模式，要保证期间备提供服务时的数据同步到了主存储节点。存储节点启用时，我们要养成习惯，不要跳过主备一致性检测。

8.1.2 配置库高可用

配置库、部分存储节点部署在同一MySQL实例或同一服务器时，若该实例出现故障，故障信息无法记入配置库，故计算节点支持配置库高可用功能，保证配置库可正常使用。

· 在server.xml里配置主从配置库的连接信息，保证主从关系正常

<property name="url">jdbc:mysql://192.168.200.191:3310/hotdb_config</property>

<property name="username">hotdb_config</property>

<property name="password">hotdb_config</property>

<property name="bakUrl">jdbc:mysql://192.168.200.190:3310/hotdb_config</property>

<property name="bakUsername">hotdb_config</property>

<property name="bakPassword">hotdb_config</property>

¡ 当主配置库发生故障时会自动切换到从配置库。切换过程中若存在延迟会等待从配置库复制延迟追上后切换成功并提供服务。

¡ 在计算节点版本高于2.5.6 （包含）时主配置库发生故障，在从配置库接管前会将被接管的从配置库更新为主库，原主配置库更新为从库，且会同步调整server.xml配置文件，如下：

<property name="url">jdbc:mysql://192.168.200.190:3310/hotdb_config</property>

<property name="username">hotdb_config</property>

<property name="password">hotdb_config</property>

<property name="bakUrl">jdbc:mysql://192.168.200.191:3310/hotdb_config</property>

<property name="bakUsername">hotdb_config</property>

<property name="bakPassword">hotdb_config</property>

¡ 若计算节点高可用服务涉及配置库的主从关系，需保证server.xml中一组计算节点高可用的主从配置库的配置完全相同，不能交错配置。

· 配置库同时支持MGR配置库(MySQL必须是5.7以上，配置库MGR暂时只支持三个节点)，在server.xml中配置具有MGR关系的配置库信息，并且保证MGR关系正常。MGR关系不正确的情况下，配置库可能会无法正常提供服务，以及可能造成启动不成功。

<property name="url">jdbc:mysql://192.168.210.22:3308/hotdb_config_test250</property>

<property name="username">hotdb_config</property>

<property name="password">hotdb_config</property>

<property name="bakUrl">jdbc:mysql://192.168.210.23:3308/hotdb_config_test250</property>

<property name="bakUsername">hotdb_config</property>

<property name="bakPassword">hotdb_config</property>

<property name="bak1Url">jdbc:mysql://192.168.210.24:3308/hotdb_config_test250</property>

<property name="bak1Username">hotdb_config</property>

<property name="bak1Password">hotdb_config</property>

MGR配置库在主库发生故障时，根据实际MySQL的重新选主逻辑，在选出新的主库时，会及时切换到新的主配置库。

8.1.3 计算节点高可用

SeaSQL DRDS支持高可用架构部署，利用keepalived高可用服务原理搭建主备服务关系，可保证在主计算节点(即Active计算节点) 服务故障后，自动切换到备计算节点 (即Standby计算节点)，应用层面可借助Keepalived的VIP 访问数据库服务，保证服务不间断。

1. 启动说明

在启动高可用架构下的主备计算节点服务时，需要注意启动的顺序问题，如下为标准启动顺序：

(1) 先启动主计算节点，再启动主计算节点所在服务器上的Keepalived：

¡ 查看计算节点日志：

2018-06-13 09:40:04.408 [INFO] [INIT] [Labor-3] j(-1) – HotDB-Manager listening on 3325

2018-06-13 09:40:04.412 [INFO] [INIT] [Labor-3] j(-1) – SeaSQL DRDS listening on 3323

¡ 查看端口监听状态：

root> ss -npl | grep 3323

LISTEN 0 1000 *:3323 *:* users:(("java",12639,87))

root> ps -aux |grep hotdb

root 11903 35.0 6.4 18254948900 653428 ? Sl Jun18 2133:14 /usr/local/jdk11/jdk-11.0.11+9/bin/java -DHOTDB_HOME=/usr/local/hotdb/hotdb-server -classpath /usr/local/hotdb/hotdb-server/conf: …省略更多…-Djava.net.preferIPv4Stack=true cn.hotpu.hotdb.HotdbStartup

(2) 使用命令“ip a”可查看当前主计算节点的Keepalived VIP是否已绑定成功，如下例子中，192.168.200.190为主计算节点所在服务器地址；192.168.200.140为配置的VIP地址

root> ip a

1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN

link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00

inet 127.0.0.1/8 scope host lo

inet6 ::1/128 scope host

valid_lft forever preferred_lft forever

2: eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UNKNOWN qlen 1000

link/ether 00:1d:0f:14:8b:fa brd ff:ff:ff:ff:ff:ff

inet 192.168.200.190/24 brd 192.168.200.255 scope global eth1

inet 192.168.200.140/24 scope global secondary eth1:1

inet6 fe80::21d:ff:fe14:8bfa/64 scope link

valid_lft forever preferred_lft forever

(3) 再启动备计算节点，再启动备计算节点所在服务器上的Keepalived：

¡ 查看计算节点日志：

2018-06-04 18:14:32:321 [INFO] [INIT] [main] j(-1) – Using nio network handler

2018-06-04 18:14:32:356 [INFO] [INIT] [main] j(-1) – HotDB-Manager listening on 3325

2018-06-04 18:14:32:356 [INFO] [AUTHORITY] [checker] Z(-1) – Thanks for choosing HotDB

¡ 查看端口监听状态：

root> ss -npl | grep 3325

LISTEN 0 1000 *:3325 *:* users:(("java",11603,83))

root> ps -aux |grep hotdb

root 11903 35.0 6.4 18254948900 653428 ? Sl Jun18 2133:14 /usr/local/jdk11/jdk-11.0.11+9/bin/java -DHOTDB_HOME=/usr/local/hotdb/hotdb-server -classpath /usr/local/hotdb/hotdb-server/conf: …省略更多… -Djava.net.preferIPv4Stack=true cn.hotpu.hotdb.HotdbStartup

2. 高可用切换说明

当主计算节点（以192.168.200.190为例）服务故障时，检测脚本(vrrp_scripts)检测到主计算节点服务端口不可访问或hacheck连续失败超过3次，优先级会进行调整，变成 90(weight -10)。

备计算节点（以192.168.200.191为例）服务上的keepalived收到比自己优先级低的 vrrp 包(192.168.200.191上优先级为 95)后，将切换到 master 状态，抢占 vip(以192.168.200.140为例)。同时在进入 master 状态后，执行 notify_master 脚本，访问192.168.200.191上的计算节点管理端口执行 online 命令启动并初始化192.168.200.191上的计算节点服务端口。若该计算节点启动成功，则主备切换成功继续提供服务。192.168.200.191上的计算节点日志如下：

2018-06-12 21:54:45.128 [INFO] [INIT] [Labor-3] j(-1) – SeaSQL DRDS listening on 3323

2018-06-12 21:54:45.128 [INFO] [INIT] [Labor-3] j(-1) – =============================================

2018-06-12 21:54:45.141 [INFO] [MANAGER] [Labor-4] q(-1) – Failed to offline master Because mysql: [Warning] Using a password on the command line interface can be insecure.

ERROR 2003 (HY000): Can't connect to MySQL server on '192.168.200.190' (111)

2018-06-12 21:54:45.141 [INFO] [RESPONSE] [$NIOREACTOR-8-RW] af(-1) – connection killed for HotDB backup startup

…省略更多…

Keepalived的VIP已在192.168.200.191服务器上:

root> ip a

1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN

link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00

inet 127.0.0.1/8 scope host lo

inet6 ::1/128 scope host

valid_lft forever preferred_lft forever

2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000

link/ether 18:a9:05:1b:0f:a8 brd ff:ff:ff:ff:ff:ff

inet 192.168.200.191/24 brd 192.168.200.255 scope global eth0

inet 192.168.200.140/24 scope global secondary eth0:1

inet6 fe80::1aa9:5ff:fe1b:fa8/64 scope link

valid_lft forever preferred_lft forever

注：若通过管理平台手动切换，切换成功的会修改server.xml中的（haState、haNodeHost）的配置，将主备的信息互换，故障切换不会修改配置。

3. 高可用重建

主备模式的计算节点主要通过server.xml以及keepalived.conf配置文件来标识主备的角色。高可用切换只能从主服务切换至备服务，当计算节点发生过故障切换或手动切换后，为保证下次计算节点故障还能顺利回切，需要通过高可用重建操作配置主备计算节点的相应。

例如，通过该功能可实现：当主计算节点（以192.168.200.190为例）发生故障切换，切换到备计算节点（以192.168.200.191为例）后，手动触发计算节点高可用重建功能，可重新配置两台服务器上计算节点服务的主备关系，其中192.168.200.191为主，192.168.200.190为备。当192.168.200.191服务器上计算节点再发生故障时，可自动进行回切到192.168.200.190。关于高可用重建详情请参考《H3C SeaSQL DRDS 管理平台用户手册》。

8.1.4 计算节点负载均衡

SeaSQL DRDS支持多计算节点集群的节点自治。以下简称计算节点集群中Primary状态的计算节点为Primary计算节点；计算节点集群中Secondary状态的计算节点为Secondary计算节点。Primary和Secondary计算节点的数据服务完全对等，均支持所有类型的数据操作且保证数据的一致性。集群中一个或多个（不支持多数计算节点同一时间故障）节点发生故障后，只要还有一个或更多节点可用，则整体数据服务依旧可用。

SeaSQL DRDS支持负载均衡：可选择使用LVS等方式，进行SQL请求的分发。应用端可借助LVS的VIP访问SeaSQL DRDS的数据库服务，同时保证使用透明与服务不间断。也可使用其余负载均衡方案进行处理，例如F5加自定义检测；应用直连计算节点，但发生异常时更换节点等方式。

1. 启动说明

(1) 在计算节点集群环境部署成功后，启动计算节点：

#cd /usr/local/hotdb/hotdb-server/bin

#sh hotdb_server start

(2) 查看SeaSQL DRDS启动状态：

计算节点启动后不开放服务端口，会暂时将自己的角色状态设置为Started。

当集群中所有计算节点都启动后，有一个计算节点会变为Primary,其余计算节点变为Secondary，且所有计算节点均开放数据服务端口，整个集群进入正常运行状态，示例：

· Primary节点：

· Secondary节点：

· 管理端3325状态查看：

当Primary服务异常时，剩余Secondary中的一个会变为新的Primary，原Primary会被踢出集群。

· 原Primary：

#cd /usr/local/hotdb/hotdb-server/bin

#sh hotdb_server stop

· 新Primary：

· 管理端状态查看：

若原Primary服务重新启动（相当于新节点加入），当前Primary发现Started的节点，新节点会加入该集群变为Secondary。

· 原Primary：

#cd /usr/local/hotdb/hotdb-server/bin

#sh hotdb_server start

· 管理端状态查看：

多计算节点集群启动后通过VIP访问数据库服务，即可实现透明的负载均衡，可保证服务不间断。

多计算节点集群注意事项：

· 计算节点集群启动时Primary具有随机性，但主配置库所在的服务器上的计算节点不会成为Primary；

· 故障的计算节点经过一段时间，会自行关闭服务端口变为Started状态；

· Secondary发现Primary失去响应且自己不在主配置库服务器上，会发起新选举，收到多数投票变为新Primary；

· 新节点加入，Primary发现新Started的节点加入，会添加新发现的节点；Primary发现Secondary失去响应，则会剔除该节点；

· 集群环境升级版本，如果不影响业务，建议关闭集群升级后再启动；

· 集群中各节点的server.xml配置，除集群相关的参数都必须一致；

· 各计算节点服务器时间差异需小于1s；

· 计算节点服务器之间要求任何时候网络延迟均小于1s；建议计算节点间\计算节点与存储节点间\存储节点间的延迟均低于1ms，以便使用时获得良好的响应时间性能；

· 建议一个局域网网段内，只部署一套多计算节点集群（只是建议，不是强制要求，建议的理由是为以后扩容预留较大空间）；

· 配置库IP需配置实际IP。

2. 线性扩展

在多计算节点集群模式下，若想要实现强一致（XA）模式下的性能吞吐量随计算节点个数的扩展性能实现线性增长，可使用SeaSQL Listener组件。

SeaSQL Listener是SeaSQL DRDS的一个可拔插组件，使用JAVA语言开发，它需要单独进行部署，并以独立的进程运行。SeaSQL Listener作为Agent，部署在每个存储节点实例的本地环境中，代理相关存储节点服务的连接和请求。

部署Listener

可参考《H3C SeaSQL DRDS 管理平台安装手册》进行Listener组件的部署。

使用Listener

使用Listener需要计算节点满足必要条件：

· 计算节点版本为2.5.5及以上

· 计算节点为多计算节点集群模式

· 开启XA模式

· 将server.xml中enableListener参数设置为true。

添加节点配置Listener

当Listener部署完成后，可在数据节点页面引入Listener的配置信息。

以添加1组双主类型的数据节点为例：

(1) 步骤1~4按照以往规则填写存储节点的主机名和端口号，连接用户和密码，物理库等。若该组存储节点需要绑定Listener，在步骤5中，填写好监听程序相关信息（Listener中文为监听程序）。

填写规则如下：

¡ 监听程序主机名：默认填写“默认”，无需修改

¡ 监听端口：即Listener的启动端口，默认3330

¡ 监听程序服务端口：即Listener向SeaSQL DRDS提供服务的端口，默认4001。若同一台存储节点服务器上有多个MySQL实例需要绑定Listener，服务端口需要保持唯一。

(2) 填写完毕后，点击测试连接，测试通过后点击保存并返回。

(3) 执行动态加载，若节点管理列表的状态列为绿色可用，代表监听程序可以连接；若状态为橙色可用，代表监听程序无法连接，需检查：enableXA是否为true，enableListener是否为true。

(4) 验证Listener服务是否被启用：在3325端口执行show @@datasource即可查看。

编辑存储节点配置Listener

此方法适用于在已有数据节点的基础上添加Listener的配置信息。

在节点管理页面，以dn_26数据节点为例：

(1) 点击操作栏中的i图标，即详情，进入该存储节点管理页。

(2) 点击编辑，添加监听程序相关信息。

对于未绑定监听程序的存储节点，最后三项信息默认为空。

填写规则如下：

¡ 监听程序主机名：填写该存储节点的主机名

¡ 监听端口：即Listener的启动端口，默认3330

¡ 监听程序服务端口：即Listener向SeaSQL DRDS提供服务的端口，默认4001。若同一台存储节点服务器上有多个MySQL实例需要绑定Listener，服务端口需要保持唯一

(3) 填写完毕后，点击测试连接，测试通过后点击保存并返回。

执行动态加载，若节点管理列表的状态列为绿色可用，代表监听程序可以连接；若状态为橙色可用，代表监听程序无法连接，需检查：enableXA是否为true，enableListener是否为true。

验证Listener服务是否被启用：在3325端口执行show @@datasource即可查看。

注意事项

· Listener只需部署完成并正确识别即可，日常计算节点操作过程中可无需关注。

· Listener组件尽可能和存储节点安装在同一台服务器上；

· 若一个监听程序需要监听多个存储节点，则需要为其分别填写不同的服务端口；

· 当某个存储节点取消被Listener监听时，已分配的监听程序服务端口会一直存在，原存储节点可再次使用该监听程序服务端口绑定Listener。

· 当某个存储节点取消被Listener监听时，已分配的监听程序服务端口会一直存在，此时其他存储节点使用该监听程序服务端口，Listener日志会报错：端口冲突，端口已存在。因此需要重启Listener后才能使用该监听程序服务端口。

· 当集群需要重启时，建议Listener组件也一同重启，重启顺序为：先重启Listener，后重启集群，以便集群更快的识别Listener；

· Listener作为可插拔组件，当Listener不可用时，集群和存储节点仍然可以正常提供服务。

· 若Listener单独重启，则需至少等待2分钟，计算节点会自动与Listener再次重连。

8.1.5 计算节点水平弹性伸缩

为满足业务发展和应用数据增长的需求，SeaSQL DRDS V2.5.6版本支持计算节点在线水平扩容/缩容功能，通过手动调整计算节点server.xml相关参数并动态加载的方式实现计算节点扩容/缩容。例如单节点模式，可以扩展到 HA模式，也可以扩展到集群模式，同时集群模式可以缩减到HA或单节点模式。

1. 计算节点扩容

参数介绍

涉及的参数如下：

参数值	参数说明	参考值	动态加载是否生效
haMode	高可用模式：0：主备；1：集群	集群环境下参数值为1	是
serverId	集群节点编号1-N（节点数)，集群内唯一且N<=集群节点总数	serverID要从1开始，且集群内连续不重复	是
clusterName	集群组名称	Group-Cluster	是
clusterSize	集群节点总数	默认值3，根据实际节点数配置	是
clusterNetwork	集群所在网段	192.168.200.0/24，跟集群IP同网段	是
clusterHost	本节点所在IP	192.168.200.1，根据具体IP匹配	是
clusterPort	集群通信端口	默认3326	是

HA模式扩展集群多节点

HA模式扩展到集群多节点，主要在于如何将keepalived切换到LVS，此小节将主要描述HA到集群的扩容操作，涉及的组件信息如下：

角色	连接信息	名称
主计算节点	192.168.210.67_3323_3325	HotDB_01
备计算节点	192.168.210.68_3325	HotDB_02
LVS服务	192.168.210.136	VIP:192.168.210.218
新计算节点	192.168.210.134	HotDB_03

(1) 第一步：停备计算节点/备keepalived服务

停止HotDB_02的keepalived和计算节点服务。

(2) 第二步：部署并启动LVS

此处以单LVS服务为例，选定192.168.210.136做LVS服务器，VIP使用192.68.210.218。

a. LVS服务器部署LVS服务

cd /usr/local/hotdb/Install_Package

sh hotdbinstall_v*.sh --dry-run=no --install-lvs=master --lvs-vip-with-perfix=192.168.210.218/24 --lvs-port=3323 --lvs-virtual-router-id=44 --lvs-net-interface-name=eth0:1 --lvs-real-server-list=192.168.210.134:3323:3325,192.168.210.67:3323:3325,192.168.210.68:3323:3325 --ntpdate-server-ip=182.92.12.11

b. 计算节点服务器（HotDB_01/HotDB_02/HotDB_03）配置LVS服务

HotDB_01/HotDB_02/HotDB_03服务器分别执行脚本：

cd /usr/local/hotdb/Install_Package

sh hotdbinstall_v*.sh --dry-run=no --lvs-real-server-startup-type=service --lvs-vip-with-perfix=192.168.210.218/24 --install-ntpd=yes --ntpdate-server-host=182.92.12.11

c. LVS服务器启动LVS服务

service keepalived start

(3) 第三步：调整参数并启动集群服务

a. 计算节点（HotDB_01/HotDB_02/HotDB_03）的server.xml依据相关参数进行调整，如下图：

- HotDB_01的参数参考框选区域的配置：

- HotDB_02的参数参考框选区域的配置：

- HotDB_03的参数参考框选区域的配置：

b. HotDB_01管理端执行reload @@config操作，show @@cluster可看到HotDB_01作为PRIMARY角色加入集群。

c. 停止HotDB_01服务器keepalived服务

service keepalived stop

$ITI$CWB{(O1__N_A}4PCD`A$

d. 启动HotDB_02、HotDB_03，然后在HotDB_01管理端执行show @@cluster;可看到集群成员全部加入。

(4) 第四步：管理平台适配调整

适配方式同“集群模式扩展计算节点”一致，编辑计算节点集群将新引入的计算节点纳入管理，使其HA模式转换成集群模式，如下图：

集群模式扩展更多计算节点

此小节将描述集群模式下进行计算节点扩容相关操作，涉及的组件信息如下:

角色	连接信息	名称
主计算节点	192.168.210.157_3323_3325	HotDB_01
备计算节点	192.168.210.156_3323_3325	HotDB_02
备计算节点	192.168.210.155_3323_3325	HotDB_03
主/备LVS	192.168.210.135/137	VIP:192.168.210.216
新计算节点	192.168.210.134	HotDB_04

(1) 第一步：LVS服务器添加新计算节点

a. 主/备 LVS服务器上添加HotDB_04的虚拟服务

ipvsadm -a -t 192.168.210.216:3323 -r 192.168.210.134

b. 主备LVS配置文件keepalived.conf中添加HotDB_04的服务信息，如下图：

(2) 第二步：新计算节点服务器配置LVS

在HotDB_04服务器执行部署脚本，配置LVS：

cd /usr/local/hotdb/Install_Package/

sh hotdbinstall_v*.sh --dry-run=no --lvs-real-server-startup-type=service --lvs-vip-with-perfix=192.168.210.216/24 --install-ntpd=no --ntpdate-server-host=182.92.12.11

--lvs-vip-with-perfix：当前集群的VIP

(3) 第三步：调整参数并启动新集群成员

a. 修改所有计算节点服务器（HotDB_01/HotDB_02/HotDB_03/HotDB_04）server.xml的ClusterSize参数值，保证ClusterSize等于实际集群成员个数（此处为4）。其他参数无需调整，但需注意clusterName、clusterSize、clusterNetwork、clusterPort在同一集群内参数值一致。

b. 新计算节点服务器（HotDB_04）调整server.xml中其他集群参数并启动服务，如下图：

(4) 第四步：Reload操作使配置生效

主计算节点（HotDB_01）管理端执行reload @@config，可看到HotDB_04加入集群：

(5) 第五步：管理平台适配调整

a. 进入“集群管理”->“计算节点集群”页面，将新引入的计算节点纳入管理。

b. 编辑计算节点集群，通过计算节点右侧操作栏的“+”按钮可添加新引入的计算节点，保存后管理平台会根据计算节点个数自动识别计算节点模式，如下图：

· 若集群继续引入新计算节点，按第一步开始重复操作；

· 若计算节点的clusterSize、haMode值与实际配置的集群不匹配，第四步reload @@config会失败，需保证配置与实际情况吻合；

· 新计算节点的参数serverId需保证编号唯一不重复且跟原集群连续不间断，否则会导致启动异常；

2. 计算节点缩容

通过计算节点缩容功能，可以完成计算节点数量的缩减。计算节点停止后，可直接通过修改集群内其他多计算节点相关配置，动态加载后即可根据新配置缩减计算节点个数。

参数介绍

涉及的参数配置如下：

参数值	参数说明	参考值	动态加载是否生效
haMode	高可用模式：0：主备；1：集群	集群环境下参数值为1	是
HaState	计算节点HA模式下的主备角色配置	主计算节点配置：master，备计算节点配置：backup	是
haNodeHost	计算节点高可用模式下对应的当前主计算节点连接信息	配置格式为IP:PORT 192.168.200.1:3325	是

集群模式缩容为HA模式

本小节主要描述正常提供服务的集群缩减为HA的操作，涉及的组件同HA模式扩展集群多节点一致。

(1) 第一步：关闭集群备计算节点服务

依次关闭HotDB_02、HotDB_03计算节点服务，此过程会触发集群选举，若此时有压测任务，将出现闪断，几秒后恢复正常。

(2) 第二步：部署keepalived并调整计算节点配置

a. HotDB_01、HotDB_02服务器分别部署主备keepalived（对应VIP与LVS的VIP可相同，但virtual_router_id不能相同）

- HotDB_01服务器执行脚本：

/usr/local/hotdb/Install_Package

sh hotdbinstall_v*.sh --dry-run=no --install-keepalived=master --keepalived-vip-with-prefix=192.168.210.218/24 --keepalived-virtual-router-id=218 --keepalived-net-interface-name=eth0:1 --ntpdate-server-host=182.92.12.11 --install-ntpd=yes

- HotDB_02服务器执行脚本：

cd /usr/local/hotdb/Install_Package

sh hotdbinstall_v*.sh --dry-run=no --install-keepalived=backup --keepalived-vip-with-prefix=192.168.210.218/24 --keepalived-virtual-router-id=218 --keepalived-net-interface-name=eth0:1 --ntpdate-server-host=182.92.12.11 --install-ntpd=yes

b. 修改HotDB_01、HotDB_02服务器的keepalived.conf配置，内容参考《H3C SeaSQL DRDS 管理平台安装手册》文档相关章节。

c. 修改HotDB_01、HotDB_02计算节点的server.xml，相关参数配置成HA模式，如下图：

d. 启动HotDB_01服务器的keepalived，直到keepalived的VIP挂载好。

e. HotDB_01服务器管理端执行reload @@config操作，使当前剩余的计算节点成为HA主计算节点。

此时若有压测任务，会出现闪断，几秒后恢复正常。

(3) 第三步：停掉LVS服务器的LVS服务

a. LVS服务器停止LVS服务：systemctl stop keepalived.service

(4) 第四步：清理计算节点服务器LVS配置

a. HotDB_01、HotDB_02、HotDB_03停止lvsrs

/etc/init.d/lvsrs stop

b. HotDB_01、HotDB_02、HotDB_03删除lvsrs

cd /etc/init.d

rm -rf lvsrs

(5) 第五步：启动备计算节点/备keepalived服务

a. 启动HotDB_02计算节点和keepalived服务

(6) 第六步：管理平台适配调整

适配方式同“集群模式扩展计算节点”一致，编辑计算节点集群将缩容的计算节点进行删除，使其集群模式转换成HA模式，如下图：

若需要做集群计算节点在线缩减，需先关闭待关闭的计算节点，再修改集群成员总数和成员serverId后动态加载。

8.2 读写分离

SeaSQL DRDS支持读写分离功能，并且支持配置读写分离权重。

8.2.1 读写分离功能说明

要使用读写分离功能，需在数据节点中配置主备存储节点。

读写分离功能默认设置为关闭。开启读写分离功能，可在计算节点的配置文件server.xml中，将strategyForRWSplit属性设置为大于0的值。

例如：<property name="strategyForRWSplit">1</property>

strategyForRWSplit允许设置的值为0，1，2，3。

· 当设置为0时，读写操作都在主存储节点，也即关闭读写分离。

· 当设置为1时，代表可分离的读请求发往所有可用存储节点（包含主存储节点），写操作与不可分离的读请求在主存储节点上进行。

· 当设置为2时，代表可分离的读请求发往可用的备存储节点，写操作与不可分离的读请求在主存储节点上进行。

· 当设置为3时，代表事务（非XA模式）中发生写前的读请求与自动提交的读请求发往可用的备存储节点。其余请求在主存储节点上进行。

server.xml中可以配置读写分离中可读从库最大延迟时间，参数名：maxLatencyForRWSplit，单位ms，默认配置的延迟时间为1秒。当存储节点数据同步延迟大于设置的延迟时间或者出现故障时计算节点会摘除该存储节点并阻止参与读操作，此时由其他正常存储节点承担可分离的读任务，直至延迟重新追上才将摘除的存储节点加回读集群。

当开启读写分离时，即使心跳未开启，也会强制进行延迟检测。延迟检测周期可在server.xml中通过参数latencyCheckPeriod配置。

SeaSQL DRDS读写分离对应用研发者和数据库管理员完全透明，不要求研发者在SQL执行时添加HINT或某些注解；当然，也支持使用HINT的方式显式指定读取主机或从机。

· 指定SQL语句在主存储节点上执行：

/*!hotdb:rw=master*/select * from customer;

· 指定SQL语句在从库存储节点上执行：

/*!hotdb:rw=slave*/select * from customer;

8.2.2 读写分离权重配置

计算节点支持读写分离的同时，可以通过server.xml中配置参数控制主从读的比例。进入计算节点的安装目录的conf目录下，并编辑server.xml，修改如下相关设置：

说明：

· 读写分离策略strategyForRWSplit参数为0时读写操作都在主存储节点，也即关闭读写分离。

· 读写分离策略strategyForRWSplit参数设置为1时，代表可分离的读请求发往所有可用存储节点（包含主存储节点），写操作与不可分离的读请求在主存储节点上进行。

· strategyForRWSplit参数为1时可设置主备存储节点的读比例，设置备存储节点读比例后数据节点下的所有备存储节点均分该比例的读任务。例如：设置weightForSlaveRWSplit值为60%，假设节点为一主两从架构，则可分离的读中，主机读40%，剩余两从机各读30%；

· 读写分离策略strategyForRWSplit参数为2时，代表可分离的读请求发往可用的备存储节点，写操作与不可分离的读请求在主存储节点上进行。

· strategyForRWSplit参数为2时数据节点上的所有可分离的读任务会自动均分至该数据节点下的所有备存储节点上，若无备存储节点则由主存储节点全部承担。

· 读写分离策略strategyForRWSplit参数为3时，代表事务（非XA模式）中发生写前的读请求与自动提交的读请求发往可用的备存储节点。其余请求在主存储节点上进行。

注：在未使用HINT做读写分离的情况下，“可分离的读请求”主要指：自动提交的读请求与显式只读事务中的读请求。其余读请求均为“不可分离的读请求”。例如非自动提交事务中的读请求。

8.2.3 用户级别的读写分离

可通过管理平台创建数据库用户管理页面添加用户或编辑用户开启用户级别的读写分离。请参考《H3C SeaSQL DRDS 管理平台用户手册》14.8.2添加新用户章节。

使用用户级别的读写分离功能，需确保计算节点连接用户开启了用户级别的读写分离。

1. 从库复制延迟不大于配置值

异常处理策略选择任意项，用户根据从机读取优先级设置的值读所有数据节点对应优先级的从库

如：自动分片表rw_b_yds分布于以下节点：

dn_01	dn_02
主库：192.168.210.136:3311	主库：192.168.210.136:3310
从库1：192.168.210.137:3311	双主备库：192.168.210.137:3310
从库2：192.168.210.137:3312
从库3：192.168.210.137:3313
从库优先级：从库1>从库2>从库3

从机读取优先级设置的值为1，执行SQL：

[email protected]:hotdb 5.7.25 10:08:24> select * from rw_b_yds;

+----+------+-----------+

| id | cid | a |

+----+------+-----------+

| 4 | 4 | chongqing |

| 5 | 5 | nanjing |

| 6 | 6 | zhengzhou |

| 1 | 1 | shanghai |

| 2 | 2 | beijign |

| 3 | 3 | tianjin |

+----+------+-----------+

6 rows in set (0.00 sec)

则读dn_01的从库1和dn_02的双主备库，dn_01从库1和dn_02备库

的general.log如下：

2. 从库不可用

从机读取优先级的值为1时，当从库不可用时，会根据异常处理策略设置的值匹配对应结果，以上述自动分片表rw_b_yds为例：

· 异常处理策略配置为拒绝访问：

dn_01的从库1或dn_02的备库有一个不可用或都不可用均会拒绝访问

[email protected]:hotdb 5.7.25 02:16:07> select * from rw_c_yds;

ERROR 10254 (HY000): No matched readable datasource in node:1 for current user

· 异常处理策略配置为读当前主机：

异常情况	读取策略
只有dn_01从库1不可用	读dn_01主库，dn_02备库
只有dn_02备库不可用	读dn_01从库1，dn_02主库
dn_01从库1和dn_02的备库都不可用	读dn_01和dn_02主库

· 异常处理策略配置为读其他可用从机，其次读当前主机：

异常情况	读取策略
只有dn_01从库1不可用	读dn_01从库2，dn_02备库
只有dn_02备库不可用	读dn_01从库1，dn_02主库
dn_01的从库1和从库2都不可用	读dn_01从库3，dn_02备库
dn_01所有从库和dn_02的备库都不可用	读dn_01和dn_02主库

· 异常处理策略配置为读其他可用从机，从机不可用时拒绝访问：

异常情况	读取策略
只有dn_02备库不可用	拒绝访问
dn_01下所有从库均不可用	拒绝访问
dn_01的从库1和从库2都不可用	读dn_01从库3，dn_02备库

3. 从库复制延迟大于配置值

从库复制延迟大于配置时，跟上述中从库不可用的匹配结果一致，此处不再赘述

4. 从库数量小于从机读取优先级的值

根据异常处理策略设置的值输出对应结果，以上述自动分片表rw_b_yds为例，假设从机读取优先级设置为10：

· 异常处理策略配置为拒绝访问时：拒绝访问

· 异常处理策略配置为读当前主机：读所有节点主库

· 异常处理策略配置为读其他可用从机，其次读当前主机：读dn_01优先级最高的可用从库和dn_02备库，若dn_01和dn_02下都没有可用从库，则读dn_01和dn_02主库

· 异常处理策略配置为读其他可用从机，从机不可用时拒绝访问：读dn_01优先级最高的可用从库和dn_02备库，若dn_01下没有可用从库或dn_02下备库不可用或dn_01、dn_02都没有可用从库/备库，拒绝访问

5. 注意事项

· 用户级别的读写分离参数配置完成后，需要reload并重建session连接。

· 从机读取优先级设置为0时，默认均读当前主库。

· 从机读取优先级设置的值小于等于当前实际从库数量，读对应优先级的从库，对应优先级的从库不可用或复制延迟超出设置的值时，按异常处理策略选择项处理。

· 从机读取优先级设置的值大于当前实际从库数量，按异常处理策略选择项处理。

· 用户读写分离优先级高于全局的读写分离优先级。即用户开启读写分离的同时计算节点strategyForRWSplit参数也为开启状态，则以用户级的读写分离策略为准。

· 多个从库优先级一致时，dsid最小的优先级最高。

· 事务内写之前的读可正常分离，写之后的读全部发往主库。

· 开启XA后的XA事务全部读主库，非XA事务可正常分离。

· 单库开启用户级别的读写分离，按照从库全部不可用处理，即按异常处理策略选择项处理。

9 SeaSQL DRDS 计算节点特性功能

SeaSQL DRDS在基于分布式事务数据库设计的基础上，提供了一些扩展的功能，方便进行使用和管理。

9.1 DNID

DNID是数据节点DATANODE_ID的缩写

在计算节点上可以使用DNID作为WHERE子句中的过滤条件，以及在SELECT语句中作为查询项；也可以在结果集中显示每行结果的DNID（数据节点）。

1. 在SELECT、UPDATE、DELETE子句中，使用DNID字段

· SELECT * FROM customer WHERE dnid=1;

执行该SELECT语句，计算节点将会返回分片表customer在数据节点ID为1上的数据。

· DELETE FROM customer WHERE dnid=1 AND id=3;

执行该DELETE语句，计算节点将会删除分片表customer在数据节点ID为1，字段ID等于3的数据。

· UPDATE customer SET id=4 WHERE dnid=1 AND name='a';

执行该UPDATE语句，计算节点将会修改分片表customer在数据节点ID为1，字段name等于'a'的数据。

2. 执行SELECT语句使用DNID作为查询项

SELECT *,dnid FROM tab_name;

执行该SELECT语句，计算节点将会在结果集里显示所有结果的dnid值／

3. 在结果集中显示DNID

登录到计算节点以后，执行SET SHOW_DNID=1语句，计算节点将会在SELECT语句中返回每一行结果的DNID（数据节点ID）。

mysql> set show_dnid=1;

Query OK, 0 rows affected (0.00 sec)

mysql> select * from customer where id in (77,67,52,20);

+----+---------+------------+------------+------------+------+-------------+------+

+----+---------+------------+------------+------------+------+-------------+------+

| 52 | 马深圳 | 13912340052 | 7 | Guangdong | 深圳 | 某某街某某号| 13 |

| 77 | 郝上海 | 13912340077 | 25 | Shanghai | 上海 | 某某街某某号| 14 |

| 20 | 许重庆 | 13912340020 | 4 | Chongqing | 重庆 | 某某街某某号| 12 |

| 67 | 岑南昌 | 13912340067 | 17 | Jiangxi | 南昌 | 某某街某某号| 15 |

+----+---------+------------+------------+------------+------+-------------+------+

4 rows in set (0.00 sec)

图中结果分别显示了数据节点ID为12，13，14，15的数据行。

执行SET SHOW_DNID=1语句，查询全局表时，计算节点将会在SELECT语句中返回每一行结果的DNID（GLOBAL）。

mysql> set show_dnid=1;

Query OK, 0 rows affected (0.00 sec)

mysql> select * from tb_quan;

+------+-----+-------+----------+

| id | a | b | DNID |

+------+-----+-------+----------+

| 1 | 1 | 1.10 | GLOBAL |

| 2 | 2 | 1.20 | GLOBAL |

| 3 | 3 | 1.30 | GLOBAL |

+------+-----+-------+----------+

SET SHOW_DNID=0，将取消在结果集中显示DNID列。

mysql> set show_dnid=0;

Query OK, 0 rows affected (0.00 sec)

mysql> select * from customer where id in (77,67,52,20);

+----+---------+------------+------------+------------+------+-------------+

+----+---------+------------+------------+------------+------+-------------+

| 52 | 马深圳 | 13912340052 | 7 | Guangdong | 深圳 | 某某街某某号|

| 77 | 郝上海 | 13912340077 | 25 | Shanghai | 上海 | 某某街某某号|

| 20 | 许重庆 | 13912340020 | 4 | Chongqing | 重庆 | 某某街某某号|

| 67 | 岑南昌 | 13912340067 | 17 | Jiangxi | 南昌 | 某某街某某号|

+----+---------+------------+------------+------------+------+-------------+

4 rows in set (0.00 sec)

4. DNID的限制

· DNID字段为计算节点的保留字段，禁止在业务表中使用DNID字段，在SQL语句中使用DNID作为别名。

· DNID只适用于SELECT，UPDATE，DELETE的简单单表语句；并且，DNID只能作为WHERE子句的过滤条件，不能在ORDER BY，GROUP BY，HAVING中使用DNID字段；同样，不支持在JOIN语句、UNION/UNION ALL、子查询中使用DNID；不支持在函数，表达式中使用DNID字段。

· 执行set show_dnid=1之后，不支持where 条件带dnid。

9.2 HINT

在计算节点使用HINT语法，可绕过SeaSQL DRDS解析器，直接在指定数据节点上执行MySQL的任意SQL语句。计算节点支持两种方式的HINT语法：

1. 在HINT中使用DNID(数据节点ID)

语法：

/*!hotdb:dnid = dnid_value*/ 要执行的SQL

dnid_value的值为某个数据节点的ID号。用户可以替换dnid_value的值来指定具体的分片节点。

例如：

/*!hotdb:dnid = 1*/select * from customer where age > 20;

该语句将在数据库节点1上执行。用户可以通过分布式事务数据库可视化管理平台中的”数据节点”页面，找到数据节点ID为1的存储节点名称，并在”存储节点”页面中搜索指定的存储节点名称，即可定位到实际的MySQL数据库。

2. 在HINT中使用DSID(存储节点ID)

HINT语句支持指定datasource_id跳过计算节点直接向存储节点发送语句。可利用服务端口命令查看存储节点datasource_id：

语法：

SHOW [full] HOTDB ｛datasources｝ [LIKE 'pattern' | WHERE expr]

示例：

hotdb> show hotdb datasources where datasource_id like '22';

+-------------+---------------+---------------------------+-----------------+--------------

+-------------+---------------+---------------------------+-----------------+---------------

| 23 | 22 | 192.168.210.41_3308_hotdb157 | 1 | 1 | 192.168.210.41 | 3308 | hotdb157 | 1 |

· 指定具体datasource_id且不写binlog：

/*!hotdb:dsid=nobinlog:datasource_id*/要执行的SQL

datasource_id的值为某个存储节点的ID，可以指定多个节点用英文“,”隔开。此语法不会将执行的语句记入存储节点二进制日志文件binlog中，若使用不当，可能存在导致双主数据不一致、GTID位置错乱的情况，使用时需谨慎。

示例：

a. 在datasource_id=22的存储节点上创建用户hpt，并且不写binlog

hotdb> /*!hotdb:dsid=nobinlog:22*/create user 'hpt'@'%' identified by '123456';

Query OK, 0 rows affected (0.00 sec)

b. 在datasource_id=22的存储节点上设置参数

hotdb> /*!hotdb:dsid=nobinlog:22*/set wait_timeout=1200;

Query OK, 0 rows affected (0.01 sec)

hotdb> /*!hotdb:dsid=nobinlog:22*/show variables like 'wait_timeout';

+---------------+-------+

| Variable_name | Value |

+---------------+-------+

| wait_timeout | 1200 |

+---------------+-------+

1 row in set (0.01 sec)

· 指定所有datasource_id且不写binlog：

/*!hotdb:dsid=nobinlog:all*/要执行的SQL

all为所有存储节点(包括容灾模式下容灾机房存储节点)，此语法不会将执行的语句记入二进制日志文件binlog中。

示例：

a. 在所有存储节点上更新table1表且不写binlog：

/*!hotdb:dsid=nobinlog:all*/update table1 set name=’hotdb’ where id=100;

b. 在所有存储节点上设置参数。

hotdb> /*!hotdb:dsid=nobinlog:all*/set wait_timeout=1200;

Query OK, 0 rows affected (0.00 sec)

hotdb> /*!hotdb:dsid=nobinlog:all*/show variables like 'wait_timeout';

+---------------+-------+

| Variable_name | Value |

+---------------+-------+

| wait_timeout | 1200 |

8 rows in set (0.00 sec)

· 指定具体datasource_id且写binlog的语法：

/*!hotdb:dsid=datasource_id*/要执行的SQL

此语法会将执行的语句记入对应存储节点的二进制日志文件binlog中。同时操作具有复制关系的存储节点时需要谨慎处理，以免导致主从复制同步异常。

· 指定所有datasource_id且写binlog的语法：

/*!hotdb:dsid=all*/要执行的SQL

· all为所有存储节点(包括容灾模式下容灾机房存储节点)，此语法会将执行的语句记入二进制日志文件binlog中，同时写binlog可能存在导致具有复制关系的存储节点复制异常、GTID位置错乱的情况，使用时需谨慎。

· 若多个存储节点分布在同实例上，使用HINT中datasource_id也需单独指定存储节点执行。

3. 在HINT中使用分片字段

语法：

/!hotdb:table = table_name:column_value*/ 要执行的SQL

table_name即某个分片表的表名；column_value即该表上分片字段某个值。用户可以替换table_name的值指定相应的拆分规则，通过替换column_value的值来指定使用该分片字段的值对应的分片节点。

例如：

/*!hotdb: table = customer:10001*/select * from customer where age > 20;

使用方法：

连接计算节点(参考登录计算节点并开始使用)，选择设置的逻辑库（这里使用`test`逻辑库），然后使用上述方式执行指定的语句(这里举例说明,使用时可以按需编写SQL)。

(1) 在dn_id=2的分片节点上查找cutomer表

mysql> /*!hotdb: dnid=2*/ select count(*) from customer;

+------------+

| count(*) |

+------------+

| 50 |

+------------+

1 row in set (0.00 sec)

(2) 查找customer表上provinceid为1的分片节点的customer表

mysql> /*!hotdb: table=customer:1*/ select count(*) from customer;

+------------+

| count(*) |

+------------+

| 11 |

+------------+

1 row in set (0.00 sec)

业务层面不建议HINT直接操作存储节点，因为使用HINT之后，存储节点的数据和状态将不受计算节点控制。同时使用HINT操作后，计算节点会自动进行连接绑定操作，需要注意连接绑定后的使用说明。

9.3 连接绑定

为了防止连接池被污染，当使用HINT操作后，计算节点会绑定当前HINT查询使用的逻辑库关联的后端连接（即计算节点与存储节点的连接），所有涉及到后端的操作均在绑定的连接范围内被允许。故当HINT使用完毕后，建议重建新的前端连接以保证新的会话连接状态干净稳定。若不重建连接，当HINT使用后，有其他操作涉及到与原逻辑库绑定的后端连接之外的新的数据节点时，之前绑定的后端连接会失效，前端连接会被自动重建。

涉及到连接绑定的语句除了HINT，还包括如下语句：

set [session] foreign_key_checks=0;

START TRANSACTION /*!40100 WITH CONSISTENT SNAPSHOT */

set [session] UNIQUE_CHECKS=0;

计算节点在这种连接被绑定的SQL执行后，会输出Warning及日志提醒：

如执行如下语句时会有warning提示：

mysql> use db_a

Database changed

mysql> /*!hotdb:dnid=all*/select * From tba;

+------+-----+

| id | a |

+------+-----+

| 1 | 1 |

| 2 | 2 |

| 3 | 3 |

| 4 | 4 |

| 5 | 5 |

+------+-----+

5 rows in set, 1 warning (0.01 sec)

Warning (Code 10041): The current session has been bound to the backend connection associated with the current LogicDB. It is recommended to rebuild the session after use.

同时日志会有info信息：

2019-04-01 19:11:29.662 [INFO] [CONNECTION] [$NIOEecutor-3-1] ServerConnection(1565) – 31 has been bound to the backend connection:[2,1]

当操作涉及到与原逻辑库绑定的后端连接之外的新的数据节点时,SHOW WARNINGS会有如下提示且连接会断开：

mysql> use db_b

Database changed

mysql> show warnings;

+-------+-------+----------------------------------------------------------------------------------------------------------------+

| Level | Code | Message

+-------+-------+----------------------------------------------------------------------------------------------------------------+

| Note | 10042 | The connection in current LogicDB was a binded connection, operations under current LogicDB may cause connect abort. |

+-------+-------+----------------------------------------------------------------------------------------------------------------+

1 row in set (0.00 sec)

mysql> select * from tbb;

ERROR 2013 (HY000): Lost connection to MySQL server during query

ERROR 2016 (HY000): MySQL server has gone away

No connection. Trying to reconnect…

Connection id: 63

Current database: db_b

在SeaSQL DRDS版本低于2.5.5（不包含）版本时，在没有USE逻辑库的情况下，计算节点默认绑定所有后端存储节点连接，执行了连接绑定的语句后的其他SQL语句均直接下发执行，可能导致原存储节点的历史数据被修改或覆盖的问题。

例如：登录服务端口，未use逻辑库，执行连接绑定语句：set [session] foreign_key_checks=0;

之后直接执行：DROP TABLE IF EXISTS table_test;

此时DROP语句会直接下发到所有存储节点执行，进而删除原本不相关的数据。

故使用连接绑定的语句时，需要额外注意：INSERT/REPLACE/UPDATE/DELETE/LOAD DATA/CREATE TABLE /ALTER TABLE/DROP TABLE/TRUNCATE TABLE/RENAME TABLE等会修改数据的操作需要提前use逻辑库。

在SeaSQL DRDS 版本高于2.5.5 （包含）时，对该类场景做了进一步优化，支持对连接绑定中的内容进行解析。

连接绑定中，无论是否USE逻辑库，都不允许执行对存储节点存在破坏性的SQL（注意HINT本身对如下类型的SQL是不做限制的）：

例如：执行绑定连接语句，再执行DROP DATABASE操作：

> set foreign_key_checks=0;

Query OK, 0 rows affected, 1 warning (0.02 sec)

Warning (Code 10195): The current session has been bound to the backend connection associated with the current LogicDB. It is recommended to rebuild the session after use.

> drop database TEST_DB;

ERROR 1289 (HY000): Command '{CREATE | ALTER | DROP} {DATABASE | SCHEMA}' is forbidden

在没有USE逻辑库的情况下，执行绑定连接语句后，可以执行带逻辑库.且限定单一逻辑库的SQL:SELECT/INSERT/REPLACE/UPDATE/DELETE/LOAD/CREATE TABLE/ALTER TABLE/DROP TABLE/TRUNCATE TABLE/RENAME TABLE/PREPARE/EXECUTE/DEALLOCATE，也可执行：SET SESSION（不包括SQL_LOG_BIN|GTID_NEXT）、SHOW 、非XA模式下开启事务的语句、SAVEPOINT、提交事务、回滚事务等语句。

例如：执行绑定连接语句不USE逻辑库，再执行带逻辑库名的CREATE TABLE语句，将被允许；执行不带逻辑库名的CREATE TABLE语句，将被拒绝：

> set foreign_key_checks=0;

Query OK, 0 rows affected, 1 warning (0.02 sec)

Warning (Code 10195): The current session has been bound to the backend connection associated with the current LogicDB. It is recommended to rebuild the session after use.

>create table logic_db1.table_test (id int);

Query OK, 0 rows affected, 1 warning (0.18 sec)

> create table table_test2 (id int);

ERROR 1289 (HY000): Command 'create table table_test2 (id int)' is forbidden when sql don't use database with table or use multi database, because he current session has been bound to the backend connection.

9.4 EXPLAIN

在计算节点中，EXPLAIN语句用于显示SQL语句的路由计划。

mysql> explain select a.adnid,count(*) from join_cross_a_jwy a right join join_quan_jwy b on a.adnid=b.adnid group by a.adnid order by a.adnid;

+----------+--------------------------------+-------------------------------------------+

| datanode | type | sql |

+----------+--------------------------------+-------------------------------------------+

| 4 | PUSHDOWN_RANDOM_QUERY:::_$1 | SELECT b.adnid FROM JOIN_QUAN_JWY AS B |

| 0 | JOIN_SUB::_$1 | |

| 1 | PUSHDOWN_MULTINODE_QUERY:::_$1 | SELECT a.adnid FROM JOIN_CROSS_A_JWY AS A |

| 2 | PUSHDOWN_MULTINODE_QUERY:::_$1 | SELECT a.adnid FROM JOIN_CROSS_A_JWY AS A |

| 3 | PUSHDOWN_MULTINODE_QUERY:::_$1 | SELECT a.adnid FROM JOIN_CROSS_A_JWY AS A |

| 4 | PUSHDOWN_MULTINODE_QUERY:::_$1 | SELECT a.adnid FROM JOIN_CROSS_A_JWY AS A |

| 0 | JOIN_SUB::_$2 | LEFT_JOIN |

| 0 | JOIN_SUB:_$1_$2 | |

| 9 | CONSTANT_RANDOM_QUERY::_$1 | SELECT COUNT(*) FROM DUAL |

| 0 | JOIN_SUB:_$2 | |

| 0 | JOIN_$1_$2 | |

| 0 | AGGREGATION_$1 | |

+----------+--------------------------------+-------------------------------------------+5 r

从计算节点2.5.7版本开始，EXPLAIN支持显示JOIN语句、UNION/UNION ALL、子查询语句的路由计划。其中：

· DATANODE列为数据节点ID，0表示不会实际下发到存储节点。

· SQL列则是在对应节点上会实际执行的SQL。

· TYPE列为SQL下发的执行动作类型。

TYPE类型包括：

¡ RESPONSE_DIRECT：直接返回的查询

¡ FORWARD_PRIMARY：转发到PRIMARY执行

¡ CONSTANT_RANDOM_QUERY：下发到随机节点的常量查询

¡ PUSHDOWN_ONENODE_QUERY：直接下发的单节点普通查询

¡ PUSHDOWN_MULTINODE_QUERY：直接下发的多节点普通查询

¡ PUSHDOWN_RANDOM_QUERY：下发到随机节点的普通查询

¡ PUSHDOWN_AGGREGATION_QUERY：直接下发的聚合查询

¡ COMMON_QUERY：普通查询

¡ AGGREGATION：结果集需要简单的聚合处理，一次SQL就能返回结果

¡ HAVING_FILTER：结果集过滤

¡ BIG_OFFSET_LIMIT：超大offset的limit查询语句

¡ SUBQUERY：子查询

¡ GLOBAL_LOCK_SELECT：涉及全局表锁的查询

¡ GLOBAL_RANDOM_IUD：涉及全局表随机函数的IUD语句

¡ USER_VAR_FETCH：更新用户变量的值

¡ UPDATE_DELETE_SUBQUERY：UPDATE/DELETE 子查询

¡ ROUTE_BY_GLOBAL_INDEX：根据全局索引路由

¡ LOAD_DATA：导入数据

¡ INTO_OUT_FILE：导出数据

¡ ONE_NODE_IUD：单节点IUD语句

¡ MULTI_NODE_IUD：多节点IUD语句

¡ INNER_TEMP_TABLE：内部临时表

¡ UPDATE_SHARDING_KEY：更新分片字段的值

¡ RELATIVE_IUD：父子表相关的IUD语句

¡ INFORMATION_SCHEMA：information_schema相关查询

¡ DAL_SHOW：show 命令聚合

¡ IUD_TRIGGER：会触发操作的IUD语句

¡ GLOBAL_IUD：全局表的IUD

¡ 其他类型，还包括：SUM_DISTINCT、COUNT_DISTINCT、AVG_DISTINCT、GROUP_CONCAT、JOIN、JOIN_SUB、BNL_JOIN、BNL_JOIN_SUB、UNION、UPDATE_DELETE_JOIN、UPDATE_DELETE_LIMIT、DDL、ORACLE_SEQUENCE、FORWARD_CALCITE、HINT、CALL、EXCEPT、MINUS、INTERSECT、、ROWNUM、DROP_DATABASE

EXPLAIN的注意点：

· 对于直接下发的SQL，EXPLAIN显示的SQL，和存储节点general_log中显示的会在格式上存在差异，EXPLAIN显示的是格式化的SQL；

· EXPLAIN显示SQL需要执行多个DATANODE，在实际查询时，会根据上条子SQL的返回结果，进行二次路由，后执行的SQL最终可能只会在部分节点执行；

· 部分SQL（即计算节点本身不支持）转发到第三方库解析的，EXPLAIN可能会显示不完全。

9.5 EXPLAINDN

在计算节点中，EXPLAINDN语句可直接下发到路由的数据节点上执行MySQL的SQL语句执行计划,作用等同于MySQL中的EXPLAIN。

语法:

EXPLAINDN[=dnid_value] 要执行的SQL

dnid_value的值为某个数据节点的ID号。用户可以替换dnid_value的值来指定具体的分片节点。

例如：

[email protected]:cara 5.7.25 04:37:57> explaindn=1 select * from hotdb_tableinfo;

+----+-------------+-----------------+------------+------+---------------+------+---------+------+------+----------+-------+

+----+-------------+-----------------+------------+------+---------------+------+---------+------+------+----------+-------+

+----+-------------+-----------------+------------+------+---------------+------+---------+------+------+----------+-------+

1 row in set, 1 warning (0.14 sec)

[email protected]:cara 5.7.25 05:06:38> explaindn=all select * from hotdb_logic_db;

+----+-------------+----------------+------------+------+---------------+------+---------+------+------+----------+-------+

+----+-------------+----------------+------------+------+---------------+------+---------+------+------+----------+-------+

+----+-------------+----------------+------------+------+---------------+------+---------+------+------+----------+-------+

4 rows in set, 1 warning (0.01 sec)

EXPLAINDN的注意点：

· 仅支持SELECT语句的执行计划；

· 不支持跨分片复杂查询、跨逻辑库的执行计划；

· 实际路由节点与指定查询节点不一致时，会有相应的错误提示；

[email protected]:cara 5.7.25 05:04:47> select * from hotdb_logic_db where logic_dbid=45;

+------------+--------------+---------------------------+-----------------+--------------------+------+

+------------+--------------+---------------------------+-----------------+--------------------+------+

| 45 | EZOFFICE | 1,2,3,5,94,95,96,97,98,99 | utf8mb4 | utf8mb4_general_ci | 44 |

+------------+--------------+---------------------------+-----------------+--------------------+------+

1 row in set (0.00 sec)

[email protected]:cara 5.7.25 05:06:32> explaindn=1 select * from hotdb_logic_db where logic_dbid=45;

ERROR 10010 (HY000): unsupported explaindn statement

9.6 OnlineDDL

计算节点管理端（3325）支持OnlineDDL功能，保证了在进行表变更时，不会阻塞线上业务读写，库依然能正常对外提供访问，具体使用方法如下：

(1) 登录3325端管理端口，使用onlineddl "[DDLSTATEMENT]"语法可以执行onlineddl语句，例如：onlineddl "alter table customer add column testddl varchar(20) default '测试onlineddl'";

(2) 执行show @@onlineddl语句，即可显示当前正在运行的OnlineDDL语句及语句执行速度，progress显示当前DDL执行进度（单位：%），speed显示为当前DDL运行速度（单位：行/ms），例如：

mysql> show @@onlineddl;

+--------------+-------------------------------------------------------------------------------+----------+---------+

| schema | onlineddl

| progress | speed |

+--------------+-------------------------------------------------------------------------------+----------+---------+

| TEST_DML_JWY | ALTER TABLE CUSTOMER ADD COLUMN TESTDDL VARCHAR(20) DEFAULT '测试ONLINEDDL' | 0.2300 | 23.3561 |

+--------------+-------------------------------------------------------------------------------+----------+---------+

特殊说明：

onlineddl 语句不是执行下去就代表DDL完成，返回了“Query OK, 0 rows affected ”仅代表DDL语句可以执行，如果想看是否执行完成，要查看 show @@onlineddl中progress 显示的进度。show @@onlineddl结果为空时，代表所有DDL执行完毕且当前无其他DDL任务，如果中途因为网络或其他异常DDL中断，会回滚整个DDL。

9.7 NDB Cluster SQL节点服务

计算节点V2.5.2以下的版本对SELECT 查询类型的SQL语句支持不完全，特别是子查询类型的SQL，故引入NDB Cluster SQL节点服务（以下简称NDB SQL）。该服务利用NDB Cluster的SQL节点对计算节点不支持的SQL做兼容，用于在分布式环境下完成相对复杂的查询语句的计算。若要了解如何安装部署NDB Cluster SQL节点服务，请参考《H3C SeaSQL DRDS 管理平台安装手册》的NDB Cluster SQL节点服务部署章节。

9.7.1 NDB使用限制

在NDB SQL模式开启时，需要同时满足以下条件才会走NDB SQL逻辑：

· 全局唯一不开启的情况下，必须有主键或者唯一键，主键和唯一键必须为分片字段或自增；

· 全局唯一开启的情况下，必须有主键或者唯一键；

· 上述两条中的主键，唯一键必须是单字段数值类型；

· 执行计算节点原不支持的查询语句。

· 表结构中若有非geometry类型的空间类型字段、json类型的字段，原不支持的查询SQL依旧无法支持；

· 原不支持的查询SQL的WHERE条件中字段类型仅支持：所有整形、DECIMAL、CHAR、ENUM、VARCHAR类型。

9.8 在线修改分片字段

计算节点版本高于2.5.6 （包含）支持在服务端口直接使用SQL语句进行在线修改分片字段的操作，业务表在变更期间不会锁表，业务可对原表进行正常的SIUD操作。

9.8.1 使用方法

alter修改分片字段语法：alter table table_name change shard column new_column；

例如将源表sbtest1分片字段id修改为k，执行：

[email protected]:hotdb 5.7.25 06:44:26> alter table sbtest1 change shard column k;

Query OK, 0 rows affected (2 min 2.27 sec)

9.8.2 使用限制

· 源表必须具有主键或者唯一键，且表名长度不能超过45个字符。

· 源表上不能有触发器，或源表不能被其他触发器关联。

· 源表不能有外键约束。

· 新的分片字段必须是表结构包含的字段，且不能是表当前正在使用的分片字段。

· 新的分片字段数据类型不能是BIT、TINYTEXT、TEXT、MEDIUMTEXT、LONGTEXT、TINYBLOB、BLOB、MEDIUMBLOB、LONGBLOB、GEOMETRY、POINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRYCOLLECTION、JSON。

· 不支持全局表、垂直分片表、父表、子表，仅支持对水平分片表使用alter修改分片字段。

· 水平分片表中，不支持RANGE、MATCH、ROUTE分片规则的源表进行alter修改分片字段。

· 进行alter修改分片字段时，源表不能有正在进行的分片方案变更任务。

· 若源表出现主备数据不一致情况，使用alter修改分片字段时会直接跳过检测依旧执行（建议执行前人工通过管理平台进行主备数据一致性检测）。

· 源表开启全局唯一约束后，使用alter修改分片字段时要求源表唯一约束字段的历史数据必须唯一。

10 数据类型与字符集

10.1 计算节点对数据类型的支持

10.1.1 数值类型

MySQL数据类型	支持状态	说明
BIT	限制支持	DDL语句中可支持BIT类型，不支持在跨库的DML语句中对BIT类型的操作
TINYINT	支持
SMALLINT	支持
MEDIUMINT	支持
INT	支持
INTEGER	支持
BIGINT	支持
SERIAL	支持	与BIGINT UNSIGNED NOT NULL AUTO_INCREMENT UNIQUE 同义
SERIAL DEFAULT VALUE	支持	与NOT NULL AUTO_INCREMENT UNIQUE同义
REAL	不支持	禁止设置为分片字段与父子表关联字段类型
DOUBLE	不支持	禁止设置为分片字段与父子表关联字段类型
FLOAT	不支持	禁止设置为分片字段与父子表关联字段类型
DECIMAL	支持
NUMERIC	支持

10.1.2 日期与时间类型

MySQL数据类型	支持状态	说明
DATE	支持
TIME	支持
TIMESTAMP	支持
TIMESTAMP	支持
DATETIME	支持
DATETIME	支持
YEAR	支持

10.1.3 字符串类型

MySQL数据类型	支持状态	说明
CHAR	支持
VARCHAR	支持
BINARY	支持
VARBINARY	支持
TINYBLOB	支持	禁止设置为分片字段与父子表关联字段类型
BLOB	支持	禁止设置为分片字段与父子表关联字段类型
MEDIUMBLOB	支持	禁止设置为分片字段与父子表关联字段类型
LONGBLOB	支持	禁止设置为分片字段与父子表关联字段类型
TINYTEXT	支持	禁止设置为分片字段与父子表关联字段类型
TEXT	支持	禁止设置为分片字段与父子表关联字段类型
MEDIUMTEXT	支持	禁止设置为分片字段与父子表关联字段类型
LONGTEXT	支持	禁止设置为分片字段与父子表关联字段类型
ENUM	支持
SET	支持

10.1.4 空间类型

计算节点支持在创建表时，使用空间类型spatial_type；支持在单库的SQL语句中使用spatial_type；不支持在跨库的SQL语句中，对spatial_type的二次计算。

10.1.5 其他类型

MySQL数据类型	支持状态	说明
JSON	支持	禁止使用其作为分片字段、父子表关联字段，禁止使用其作为JOIN字段

10.2 计算节点对字符集的支持

计算节点支持字符集相关设置，目前可支持的字符集及校对集如下：

+--------------------+---------+

| Collation | Charset |

+--------------------+---------+

| big5_chinese_ci | big5 |

| big5_bin | big5 |

| latin1_swedish_ci | latin1 |

| latin1_bin | latin1 |

| ascii_general_ci | ascii |

| ascii_bin | ascii |

| gb2312_chinese_ci | gb2312 |

| gb2312_bin | gb2312 |

| gbk_chinese_ci | gbk |

| gbk_bin | gbk |

| utf8_general_ci | utf8 |

| utf8_bin | utf8 |

| utf8mb4_general_ci | utf8mb4 |

| utf8mb4_bin | utf8mb4 |

| binary | binary |

| gb18030_chinese_ci | gb18030 |

| gb18030_bin | gb18030 |

+--------------------+---------+

与字符集相关的语法如下，SeaSQL DRDS也可同步支持，功能同MySQL一致：

功能分类	语法相关
CREATE DATABASE	CREATE DATABASE db_name [DEFAULT] { CHARACTER SET [=] charset_name \| COLLATE [=] collation_name }
ALTER DATABASE	ALTER DATABASE db_name [DEFAULT] CHARACTER SET [=] charset_name \| [DEFAULT] COLLATE [=] collation_name
CREATE TABLE	col_name {CHAR \| VARCHAR \| TEXT} (col_length) [CHARACTER SET charset_name] [COLLATE collation_name] col_name {ENUM \| SET} (val_list) [CHARACTER SET charset_name] [COLLATE collation_name]
ALTER TABLE	ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name [COLLATE collation_name];
	ALTER TABLE tbl_name DEFAULT CHARACTER SET charset_name [COLLATE collation_name];
	ALTER TABLE tbl_name MODIFY col_name column_definition CHARACTER SET charset_name [COLLATE collation_name];
SET	SET NAMES 'charset_name' [COLLATE 'collation_name']
	SET CHARACTER SET charset_name
	set [session] {character_set_client\|character_set_results\|character_set_connection\|collation_connection} = xxx;
WITH	With ORDER BY: SELECT k FROM t1 ORDER BY k COLLATE latin1_swedish_ci;
	With AS: SELECT k COLLATE latin1_swedish_ci AS k1 FROM t1 ORDER BY k1;
	With GROUP BY: SELECT k FROM t1 GROUP BY k COLLATE latin1_swedish_ci;
	With aggregate functions: SELECT MAX(k COLLATE latin1_swedish_ci) FROM t1;
	With DISTINCT: SELECT DISTINCT k COLLATE latin1_swedish_ci FROM t1;
	With WHERE: SELECT * FROM k WHERE a='a' COLLATE utf8_bin;
	With HAVING: SELECT * FROM k WHERE a='a' having a='a' COLLATE utf8_bin order by id;

特殊情况说明：已有历史数据，且历史数据中其分片字段为非数值或者纯字母类型的数据，修改其表或分片字段的字符集，可能导致数据查询结果错误的情况。主要由于原路由算法中没有兼容这类情况，例如需要对字符串类型的存入数据做先转小写再转字符集utf8mb4存储的逻辑会遇到这类问题。故我们针对字符集转换功能做了相关优化处理。

执行如下修改字符集语句对分片字段所包含的内容进行字符集变更时，会进行进行校验：

ALTER TABLE tablename CONVERT TO CHARACTER SET charset_name [COLLATE collation_name]

ALTER TABLE 表名 CHANGE 分片字段列名分片字段列名 ... [DEFAULT] CHARACTER SET [=] charset_name COLLATE collation_name]

· 若修改的字符集同已有表、已有分片字段的字符集一致，则允许修改；

· 若修改字符集同已有表、已有分片字段的字符集不一致，则校验：

¡ 被修改的目标表其分片字段是否为数值类型，若是数值类型，则目标新字符集可以修改为其他类型的字符集；

¡ 原有字符集是否为latin1 , 若是latin1则目标新字符集可以直接修改为其他类型的字符集；

¡ 原有字符集是否为utf8，若是utf8则校验目标新字符集是否为utf8mb4，若是则可以直接修改，若不是则继续进行下一条校验：

¡ 原有字符集是否为utf8mb4，若是utf8mb4则校验目标新字符集是否为utf8，若是，则判断：select 1 from tablexx where length(shard_key)/char_length(shard_key)>3 limit 1; 是否有数据返回，若没有数据返回则可以进行字符集修改，若有数据返回，则给到第（5）条一样的ERROR提示进行拦截；

¡ 若以上场景均不包含，则继续验证其分片字段已有数据的length属性和char_length属性是否相等，若相等则可以进行字符集修改，若不相等，则给到ERROR拦截提示：

“当前字符集转换可能导致路由错误，推荐使用分片方案在线变更功能修改数值类型的字段作为分片字段后，再进行字符集转换操作”。

The current conversion operation of character sets may cause routing errors.It is recommended to modify the numerical fields as sharding key through the Sharding Plan Online Modification function before the modification of character sets.

· 2.4.9版本（不包含）以下，不支持在线修改分片规则。当遇到该类情况时，会给到另外的ERROR提醒：

“当前字符集转换可能导致路由错误，建议将原表数据备份后清空表数据，再进行字符集转换操作并将备份数据导入”The current conversion operation of character sets may cause routing errors. It is recommended to clear the table data after backup, then convert the character sets and import the backup data.

· 若仅对非分片字段进行字符集变更，则可以执行。主要对涉及到分片字段变更的范围进行校验控制并拦截；

· 如下这类语句字符集只会对表的默认字符集产生影响，不会影响已有数据的字符集，故可以执行修改语句；

ALTER TABLE tablename [DEFAULT] CHARACTER SET [=] charset_name [COLLATE [=] collation_name]

· 历史版本（20210308之前的版本）建议用户遇到该类情况需自行查看历史数据的详情内容（必须是纯数字、纯字母类型）以判断是否可以直接进行字符集变更，若分片字段不是纯数字、纯字母类型，则需要进行分片方案变更，选择纯数字、纯字母类型字段作为新的分片字段，之后再进行字符集的变更。

11 函数与操作符

11.1 计算节点对函数的支持

此文档仅列出部分经特殊处理的函数，若需要了解所有计算节点支持的函数，请向官方获取《H3C SeaSQL DRDS 功能清单》。

函数名称	支持状态	是否拦截	说明
ABS()	支持	否
ACOS()	支持	否
ADDDATE()	支持	否
ADDTIME()	支持	否
AES_DECRYPT()	支持	否
AES_ENCRYPT()	支持	否
AND, &&	支持	否
Area()	支持	否
AsBinary(), AsWKB()	支持	否
ASCII()	支持	否
ASIN()	支持	否
=	支持	否
:=	不支持	是
AsText(), AsWKT()	支持	否
ATAN2(), ATAN()	支持	否
ATAN()	支持	否
AVG()	支持	否
BENCHMARK()	不支持	是
BETWEEN ... AND ...	支持	否
BIN()	支持	否
BINARY	支持	否
BIT_AND()	不支持	是
BIT_COUNT()	支持	否
BIT_LENGTH()	支持	否
BIT_OR()	不支持	是
BIT_XOR()	不支持	是
&	支持	否
~	支持	否
\|	支持	否
^	支持	否
Buffer()	支持	否
CASE	支持	否
CAST()	支持	否
CEIL()	支持	否
CEILING()	支持	否
Centroid()	支持	否
CHAR_LENGTH()	支持	否
CHAR()	支持	否
CHARACTER_LENGTH()	支持	否
CHARSET()	支持	否
COALESCE()	支持	否
COERCIBILITY()	支持	否
COLLATION()	支持	否
COMPRESS()	支持	否
CONCAT_WS()	支持	否
CONCAT()	支持	否
CONNECTION_ID()	支持	否	前端session连接计算节点的connection_id
Contains()	支持	否
CONV()	支持	否
CONVERT_TZ()	支持	否
CONVERT()	支持	否	计算节点不论分片表或全局表，都不支持CONVERT(value, type)写法，只支持CONVERT(value using 字符集);
COS()	支持	否
COT()	支持	否
COUNT()	支持	否
COUNT(DISTINCT)	支持	否
CRC32()	支持	否
Crosses()	支持	否
CURDATE()	支持	否
CURDATE(), CURRENT_DATE	支持	否
CURRENT_ROLE()	不支持	是	计算节点不支持MySQL8.0新增角色功能
CURRENT_TIME(), CURRENT_TIME	支持	否
CURRENT_TIMESTAMP(),CURRENT_TIMESTAMP	支持	否
CURRENT_USER(), CURRENT_USER	支持	否	返回当前计算节点数据库用户
CURTIME()	支持	否
DATABASE()	支持	否	返回当前逻辑库名称
DATE_ADD()	支持	否
DATE_FORMAT()	支持	否
DATE_SUB()	支持	否
DATE()	支持	否
DATEDIFF()	支持	否
DAY()	支持	否
DAYNAME()	支持	否
DAYOFMONTH()	支持	否
DAYOFWEEK()	支持	否
DAYOFYEAR()	支持	否
DECODE()	支持	否
DEFAULT()	支持	否
DEGREES()	支持	否
DES_DECRYPT() (deprecated 5.7.6)	支持	否
DES_ENCRYPT() (deprecated 5.7.6)	支持	否
Dimension()	支持	否
Disjoint()	支持	否
DIV	支持	否
/	支持	否
ELT()	支持	否
ENCODE()	支持	否
ENCRYPT() (deprecated 5.7.6)	支持	否
EndPoint()	支持	否
Envelope()	支持	否
<=>	限制支持	是
=	支持	否
Equals()	支持	否
EXP()	支持	否
EXPORT_SET()	支持	否
ExteriorRing()	支持	否
EXTRACT()	支持	否
ExtractValue()	支持	否
FIELD()	支持	否
FIND_IN_SET()	支持	否
FLOOR()	支持	否
FORMAT()	支持	否
FOUND_ROWS()	不支持	是
FROM_BASE64()	支持	否
FROM_DAYS()	支持	否
FROM_UNIXTIME()	支持	否
GeomCollFromText(),GeometryCollectionFromText()	支持	否
GeomCollFromWKB(),GeometryCollectionFromWKB()	支持	否
GeometryCollection()	支持	否
GeometryN()	支持	否
GeometryType()	支持	否
GeomFromText(), GeometryFromText()	支持	否
GeomFromWKB()	支持	否
GET_FORMAT()	支持	否
GET_LOCK()	不支持	是
GLength()	支持	否
>=	支持	否
>	支持	否
GREATEST()	支持	否
GROUP_CONCAT()	支持	否
GROUPING()	不支持	是	MySQL8.0新增功能
GTID_SUBSET()	支持	否
GTID_SUBTRACT()	支持	否
HEX()	支持	否
HOUR()	支持	否
IF()	支持	否
IFNULL()	支持	否
IN()	支持	否
INET_ATON()	支持	否
INET_NTOA()	支持	否
INET6_ATON()	支持	否
INET6_NTOA()	支持	否
INSERT()	支持	否
INSTR()	支持	否
InteriorRingN()	支持	否
Intersects()	支持	否
INTERVAL()	支持	否
IS_FREE_LOCK()	不支持	是
IS_IPV4_COMPAT()	支持	否
IS_IPV4_MAPPED()	支持	否
IS_IPV4()	支持	否
IS_IPV6()	支持	否
IS NOT NULL	支持	否
IS NOT	支持	否
IS NULL	支持	否
IS_USED_LOCK()	不支持	是
IS	支持	否
IsClosed()	支持	否
IsEmpty()	支持	否
ISNULL()	支持	否
IsSimple()	支持	否
JSON_ARRAYAGG(col_or_expr) [over_clause]	不支持	是	MySQL8.0与5.7新增功能
JSON_OBJECTAGG(key, value) [over_clause]	不支持	是	MySQL8.0与5.7新增功能
JSON_PRETTY(json_val)	不支持	是	MySQL8.0与5.7新增功能
JSON_STORAGE_FREE(json_val)	不支持	是	MySQL8.0新增功能
JSON_STORAGE_SIZE(json_val)	不支持	是	MySQL8.0与5.7新增功能
JSON_MERGE_PATCH(json_doc, json_doc[, json_doc] ...)	不支持	是	MySQL8.0与5.7新增功能
JSON_TABLE(expr, path COLUMNS (column_list) [AS] alias)	不支持	是	MySQL8.0新增功能
LAST_DAY	支持	否
LAST_INSERT_ID()	支持	否
LCASE()	支持	否
LEAST()	支持	否
<<	支持	否
LEFT()	支持	否
LENGTH()	支持	否
<=	支持	否
<	支持	否
LIKE	支持	否
LineFromText()	支持	否
LineFromWKB(), LineStringFromWKB()	支持	否
LineString()	支持	否
LN()	支持	否
LOAD_FILE()	不支持	是
LOCALTIME(), LOCALTIME	支持	否
LOCALTIMESTAMP, LOCALTIMESTAMP()	支持	否
LOCATE()	支持	否
LOG10()	支持	否
LOG2()	支持	否
LOG()	支持	否
LOWER()	支持	否
LPAD()	支持	否
LTRIM()	支持	否
MAKE_SET()	支持	否
MAKEDATE()	支持	否
MAKETIME()	支持	否
MASTER_POS_WAIT()	不支持	是
MATCH	支持	否
MAX()	支持	否
MBRContains()	支持	否
MBRDisjoint()	支持	否
MBREqual() (deprecated 5.7.6)	支持	否
MBRIntersects()	支持	否
MBROverlaps()	支持	否
MBRTouches()	支持	否
MBRWithin()	支持	否
MD5()	支持	否
MICROSECOND()	支持	否
MID()	支持	否
-	支持	否
MIN()	支持	否
MINUTE()	支持	否
MLineFromText(),MultiLineStringFromText()	支持	否
MLineFromWKB(),MultiLineStringFromWKB()	支持	否
MOD()	支持	否
% or MOD	支持	否
MONTH()	支持	否
MONTHNAME()	支持	否
MPointFromText(),MultiPointFromText()	支持	否
MPointFromWKB(), MultiPointFromWKB()	支持	否
MPolyFromText(),MultiPolygonFromText()	支持	否
MPolyFromWKB(),MultiPolygonFromWKB()	支持	否
MultiLineString()	支持	否
MultiPoint()	支持	否
MultiPolygon()	支持	否
NAME_CONST()	支持	否
NOT BETWEEN ... AND ...	支持	否
!=, <>	支持	否
NOT IN()	支持	否
NOT LIKE	支持	否
NOT REGEXP	支持	否
NOT, !	支持	否
NOW()	支持	否
NULLIF()	支持	否
NumGeometries()	支持	否
NumInteriorRings()	支持	否
NumPoints()	支持	否
OCT()	支持	否
OCTET_LENGTH()	支持	否
OLD_PASSWORD() (deprecated 5.6.5)	支持	否
\|\|, OR	支持	否
ORD()	支持	否
Overlaps()	支持	否
PASSWORD()	支持	否
PERIOD_ADD()	支持	否
PERIOD_DIFF()	支持	否
PI()	支持	否
+	支持	否
Point()	支持	否
PointFromText()	支持	否
PointFromWKB()	支持	否
PointN()	支持	否
PolyFromText(), PolygonFromText()	支持	否
PolyFromWKB(), PolygonFromWKB()	支持	否
Polygon()	支持	否
POSITION()	支持	否
POW()	支持	否
POWER()	支持	否
PROCEDURE ANALYSE()	不支持	是
PS_CURRENT_THREAD_ID()	不支持	是	MySQL8.0新增功能
PS_THREAD_ID(connection_id)	不支持	是	MySQL8.0新增功能
QUARTER()	支持	否
QUOTE()	支持	否
RADIANS()	支持	否
RAND()	支持	否	JOIN查询中分片表不支持RAND任何语法
RANDOM_BYTES()	支持	否
REGEXP	支持	否
RELEASE_LOCK()	不支持	是
REPEAT()	支持	否
REPLACE()	支持	否
REVERSE()	支持	否
>>	支持	否
RIGHT()	支持	否
RLIKE	支持	否
ROLES_GRAPHML()	不支持	是	MySQL8.0新增功能
ROUND()	支持	否
ROW_COUNT()	不支持	是
RPAD()	支持	否
RTRIM()	支持	否
SCHEMA()	支持	否	1、select schema()返回逻辑库名称；
SEC_TO_TIME()	支持	否
SECOND()	支持	否
SESSION_USER()	支持	否	select session_user();显示为当前登录的计算节点数据库用户信息
SHA1(), SHA()	支持	否
SHA2()	支持	否
SIGN()	支持	否
SIN()	支持	否
SLEEP()	不支持	是	可配置参数是否允许SLEEP函数，默认不允许
SOUNDEX()	支持	否
SOUNDS LIKE	支持	否
SPACE()	支持	否
SQL_THREAD_WAIT_AFTER_GTIDS()(deprecated 5.6.9)	不支持	是
SQRT()	支持	否
SRID()	支持	否
StartPoint()	支持	否
STD()	不支持	是
STDDEV_POP()	不支持	是
STDDEV_SAMP()	不支持	是
STDDEV()	不支持	是
STR_TO_DATE()	支持	否
STRCMP()	支持	否
SUBDATE()	支持	否
SUBSTR()	支持	否
SUBSTRING_INDEX()	支持	否
SUBSTRING()	支持	否
SUBTIME()	支持	否
SUM()	支持	否
SYSDATE()	支持	否	（注意：测试服务器的SYSDATE加了参数，使其等于NOW() 所以不会有延迟的区别，为了规避主从库数据不一致等风险）
SYSTEM_USER()	支持	否	显示为当前登录的计算节点数据库用户信息
TAN()	支持	否
TIME_FORMAT()	支持	否
TIME_TO_SEC()	支持	否
TIME()	支持	否
TIMEDIFF()	支持	否
*	支持	否
TIMESTAMP()	支持	否
TIMESTAMPADD()	支持	否
TIMESTAMPDIFF()	支持	否
TO_BASE64()	支持	否
TO_DAYS()	支持	否
TO_SECONDS()	支持	否
Touches()	支持	否
TRIM()	支持	否
TRUNCATE()	支持	否
UCASE()	支持	否
-	支持	否
UNCOMPRESS()	支持	否
UNCOMPRESSED_LENGTH()	支持	否
UNHEX()	支持	否
UNIX_TIMESTAMP()	支持	否
UpdateXML()	支持	否
UPPER()	支持	否
USER()	支持	否	SELECT user();查询出来的是当前登录的计算节点数据库用户
UTC_DATE()	支持	否
UTC_TIME()	支持	否
UTC_TIMESTAMP()	支持	否
UUID_SHORT()	支持	否
UUID()	支持	否
VALIDATE_PASSWORD_STRENGTH()	支持	否
VALUES()	支持	否
VAR_POP()	不支持	是
VAR_SAMP()	不支持	是
VARIANCE()	不支持	是
VERSION()	支持	否	查询结果显示计算节点的version
WAIT_UNTIL_SQL_THREAD_AFTER_GTIDS()	不支持	是
WEEK()	支持	否
WEEKDAY()	支持	否
WEEKOFYEAR()	支持	否
WEIGHT_STRING()	支持	否
窗口函数	不支持	是	MySQL8.0新增功能
Within()	支持	否
X()	支持	否
XOR	支持	否
Y()	支持	否
YEAR()	支持	否
YEARWEEK()	支持	否

11.2 聚合结果集合并（MERGE_RESULT）

MERGE_RESULT控制计算节点对聚合函数的结果是否进行合并。当该值设置为1时，计算节点将合并聚合函数的结果；当该值设置为0时，计算节点将不合并聚合函数的结果。

默认情况下，MERGE_RESULT值为1。

· MERGE_RESULT=0时，含有聚合函数的SQL语句，计算节点将不合并结果集，每个数据节点的查询结果单独返回：

mysql> select count(*) from customer;

+------------+

| COUNT(*) |

+------------+

| 23 |

| 11 |

| 13 |

| 53 |

+------------+

4 rows in set (0.00 sec)

SET MERGE_RESULT=0 和SET SHOW_DNID=1，可用于统计业务表在各个数据节点上的分布情况：

mysql> set MERGE_RESULT=0;

mysql> set show_dnid=1;

mysql> select count(*) from customer;

+------------+------+

| COUNT(*) | DNID |

+------------+------+

| 13 | 12 |

| 11 | 15 |

| 53 | 13 |

| 23 | 14 |

+------------+------+

4 rows in set (0.00 sec)

结果集中的DNID列显示了每个数据节点的唯一标识ID。结果中，非常直观的显示了customer表在各个数据节点上的实际数据量。

· MERGE_RESULT=1时，含有聚合函数的SQL语句，计算节点将所有数据节点的结果按SQL语义返回查询结果：

mysql> set show_dnid=0;

mysql> set MERGE_RESULT=1;

mysql> select count(*) from customer;

+------------+

| COUNT(*) |

+------------+

| 100 |

+------------+

1 row in set (0.00 sec)

12 SQL语法

12.1 DML语句

在分布式事务数据库中，DML语句的逻辑将变的更为复杂。计算节点将DML语句分为两大类：单库DML语句与跨库DML语句。

· 单库DML语句，指SQL语句只需在一个节点上运行，即可计算出正确结果。假设分片表customer分片字段为provinceid，则下列语句为单库SELECT，因为该条语句只会在provinceid=1所路由的那个节点上运行：

SELECT * FROM customer WHERE provinceid=1;

· 跨库DML语句，指SQL语句需要多个数据节点的数据，经过计算节点的二次处理，才能整合计算出最终的结果。假设分片表customer分片字段为provinceid，则下面的SELECT语句为跨库语句，因为 id>10的数据可能分布在多个节点，为了整合并排序得出最终结果，需要获取多个节点的数据：

SELECT * FROM customer WHERE id>10 ORDER BY id;

显然，单库的SQL语句要比跨库的SQL语句性能高。在使用计算节点的时候，尽量使用单库的DML语句。

上面的例子，描述的仅仅是简单单表的SELECT单库与跨库查询。那么在JOIN中，需要多个数据节点的数据时，称之为跨库JOIN；只需要单个数据节点的数据时，称之为单库JOIN。

对于子查询语句，需要查询多个数据节点的数据时，称之为跨库子查询；只需要单个数据节点的数据时，称之为单库子查询。

计算节点对单库JOIN的查询支持功能，与单库SELECT语句支持功能一样。计算节点对跨库JOIN语句的支持，请参考跨库JOIN 。

12.1.1 DELETE语句

MySQL5.6.2开始，DELETE语句支持删除指定分区（partition）中的数据。如有表名称t与分区名称p0，下面语句将删除分区p0所有的数据：

DELETE FROM t PARTITION(p0);

1. 单库的DELETE语句

MySQL语句类型	子句类型	功能	支持状态	说明
DELETE	PARTITION		支持
	ORDER BY		支持
	LIMIT		支持
	WHERE	dnid	支持	在where条件中指定分片节点
	WHERE	函数	支持
	多表DELETE		支持

2. 跨库的DELETE语句

MySQL语句类型	子句类型	功能	支持状态	说明
DELETE	PARTITION		支持
	ORDER BY DESC\|ASC		支持
	LIMIT		支持
	ORDER BY … LIMIT …		支持	父子表不支持
	ORDER BY字段值大小写敏感		支持
	WHERE	WHERE中的函数	支持
	JOIN		支持

12.1.2 INSERT语句

1. 单库INSERT语句

MySQL语句类型	子句类型	功能	支持状态	说明
INSERT	INSERT … SELECT …		支持
	IGNORE		支持
	PARTITION		支持
	ON DUPLICATE KEY UPDATE		支持
	INSERT INTO table_name(columns… ) VALUES(values…)		支持
	INSERT INTO … VALUES()		支持
	INSERT INTO … SET		支持
	分片表无拆分字段值		不支持
	分片表拆分字段值为NULL		支持	需要在分片函数参数中配置NULL值参数
	子表无关联字段值		不支持	子表数据的INSERT操作必须满足外键条件
	子表关联字段值为NULL		不支持	子表数据的INSERT操作必须满足外键条件
	INSERT BATCH	分片表	支持
		全局表	支持
		子表	限制支持	父表的关联字段不是分片字段时不支持。

· INSERT IGNORE

在计算节点上，INSERT IGNORE保留了MySQL原有的特性。当出现主键/唯一键冲突时，将忽略数据与冲突信息。

mysql> create table test(id int not null primary key,provinceid int)engine=innodb;

Query OK, 0 rows affected (0.02 sec)

mysql> insert into test set id = 1,provinceid=2;

Query OK, 1 row affected (0.00 sec)

mysql> select * from test;

+----+------------+

| id | provinceid |

+----+------------+

| 1 | 2 |

+----+------------+

1 row in set (0.00 sec)

mysql> insert ignore into test set id = 1,provinceid=2; --主键id为1的记录已经存在，数据被忽略。

Query OK, 0 rows affected (0.00 sec)

对分片表INSERT IGORE语句的操作，若INSERT语句中，没有给出分片字段与分片字段值，计算节点将根据是否开启全局唯一约束判断是否忽略SQL语句。

例如 test 表为分片表，id 为分片字段

mysql> CREATE TABLE `test2` (

`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,

`name` varchar(20) DEFAULT NULL,

UNIQUE KEY `id` (`id`),

UNIQUE KEY `name` (`name`)

) ENGINE=InnoDB;

mysql> insert ignore into test2(name) values ('e');

mysql> insert ignore into test2(name) values ('e')

¡ 当关闭表全局唯一约束时，插入第2条时，如果id 列1、2 值路由到同一个节点，则第2条SQL 会忽略，若不是同一节点，则第2条会插入成功。

¡ 当开启表全局唯一约束时，插入第2条时，如果id 列1、2 值路由到同一个节点，则第2条SQL 会忽略，若不是同一节点，则第2条SQL也会忽略。

· INSERT无分片字段

¡ 若INSERT 从句中没有指定分片字段的值时：

¡ 若分片字段有default 默认值，默认按照default值路由；

¡ 若分片字段没有default 默认值，会填充null , 若null值配置了路由规则即可插入；未配置路由规则则不允许插入（例如range \match 这类需要单独配置null 分片规则；auto_crc32 这类，根据null自动路由）。

2. 跨库INSERT语句

在分布式事务数据库中，INSERT语句只有在INSERT... SELECT与INSERT BATCH两种情况下，才会产生跨库INSERT语句。

· INSERT BATCH指的是单条INSERT语句，写入多行记录的方式：

INSERT INTO ... table_name VALUES(),VALUES(),VALUES();

MySQL语句类型	子句类型	功能	支持状态	说明
INSERT	INSERT … SELECT …		支持
	INSERT BATCH	子表	支持	父表的JOIN字段不是分片字段时不支持。
		全局表	支持
		分片表	支持

· 批量INSERT (INSERT BATCH）的情况特殊说明

事务中的批量INSERT，部分成功部分失败，会自动回滚至上一个SAVEPOINT。

12.1.3 LOAD DATA语句

MySQL语句类型	子句类型	功能	支持状态	说明
LOAD DATA	LOAD DATA … INFILE … INTO TABLE		支持	要求执行语句的计算节点数据库用户拥有FILE权限当计算节点为集群模式时，无论在集群中哪台服务器上执行此语法，导入文件都必须上传至当前主计算节点服务器上的固定路径： /usr/local/hotdb/hotdb-server/hotdb-temp
	LOW_PRIORITY		不支持
	CONCURRENT		不支持
	LOCAL		不支持
	REPLACE		支持
	IGNORE		支持
	PARTITION		不支持
	CHARACTER SET		不支持
	{FIELDS \| COLUMNS} [TERMINATED BY 'string'] [[OPTIONALLY] ENCLOSED BY 'char'] [ESCAPED BY 'char']		支持
	LINES STARTING BY 'string'		不支持
	LINES TERMINATED BY 'string'		支持
	导入指定字段		支持
	SET		支持
	IGNORE number {LINES \| ROWS}		支持

12.1.4 REPLACE语句

1. 单库REPLACE语句

MySQL语句类型	子句类型	功能	支持状态	说明
REPALCE	REPLACE … SELECT …	单库简单单表查询	支持
		单库JOIN	支持
		单库子查询	支持
		单库UNION/UNION ALL	支持
	PARTITION		支持
	ON DUPLICATE KEY UPDATE		支持
	REPLACE INTO table_name(columns… ) VALUES(values…)		支持
	REPALCE INTO … VALUES()		支持
	REPLACE INTO … SET		支持
	分片表无拆分字段值		不支持
	分片表拆分字段值为NULL		支持	需要在分片函数参数中配置NULL值参数
	子表无关联字段值		不支持	子表数据的INSERT操作必须满足外键条件
	子表关联字段值为NULL		不支持	子表数据的INSERT操作必须满足外键条件
	REPLACE BATCH	分片表	支持
		全局表	支持
		子表	限制支持	父表的关联字段不是分片字段时不支持。

2. 跨库REPLACE语句

在分布式事务数据库中，REPLACE语句只有在REPLACE … SELECT与REPLACE BATCH两种情况下，才会产生跨库REPLACE语句。

REPLACE BATCH指的是单条REPLACE语句，写入多行记录的方式：

REPLACE INTO … table_name VALUES(),VALUES(),VALUES();

MySQL语句类型	子句类型	功能	支持状态	说明
REPLACE	REPLACE … SELECT …	跨库简单单表查询	支持
		跨库JOIN	不支持
		跨库UNION	不支持
	REPLACE BATCH	子表	支持	父表的JOIN字段不是分片字段时不支持。
		全局表	支持
		分片表	支持

12.1.5 SELECT语句

1. 单库SELECT语句

MySQL语句类型	子句类型	功能	支持状态	说明
SELECT	JOIN	LEFT JOIN	支持
		INNER JOIN	支持
		RIGHT JOIN	支持
		CROSS JOIN	支持
		普通JOIN（无JOIN关键字的多表查询）	支持
		PARTITION分区表	支持
		单种表类型的混合JOIN	支持
		多表类型的混合JOIN	支持
	子查询	JOIN	支持
		IFNULL/NULLIF	支持
		UNION/UNION ALL	支持
		IS NULL/IS NOT NULL	支持
		PARTITION分区表	支持
		Select from where表达式	支持
		Select select表达式	支持
		SELECT FROM SELECT表达式	支持
	UNION/UNION ALL	简单单表查询	支持
		JOIN	支持
		子查询	支持	同子查询的支持语法相同
		Having聚合函数	支持
		PARTITION分区表	支持
	DISTINCTROW		支持
	DISTINCT		支持
	STRAIGHT_JOIN		支持
	SQL_NO_CACHE		支持
	PARTITION		支持
	WHERE	dnid	支持	· SET show_dnid=1之后，不支持WHERE 条件带dnid； · dnid与其他条件用or关联，仅取dnid条件； · 不支持SELECT子句中跟dnid表达式，例如：SELECT dnid=4 FROM dml_a_jwy;
	WHERE	函数	支持	请参考函数说明
	GROUP BY ASC\|DESC WITH ROLLUP		支持
	HAVING		支持
	ORDER BY ASC\|DESC		支持
	LIMIT n,m		支持
	PROCEDURE		限制支持	V2.5.5开始支持单库存储过程
	INTO OUTFILE		支持	· 要求执行语句的计算节点数据库用户拥有FILE权限 · 无论在哪台服务器上执行此语法，输出文件都将保存在当前计算节点服务器上的固定路径： /usr/local/hotdb/hotdb-server/hotdb-temp · 若输出时集群发生切换，仍能保证数据输出正常
	INTO DUMPFILE		不支持
	INTO 变量		不支持
	FOR UPDATE		支持	不支持与NOWAIT或SKIP LOCKED连用
	LOCK IN SHARE MODE		支持	与MySQL8.0的FOR SHARE功能相同，为保证向下兼容，仍保留支持
	FOR SHARE		支持	支持在MySQL8.0及以上存储节点使用；不支持与NOWAIT或SKIP LOCKED连用
	函数	包括聚合函数	支持	支持单表聚合函数括号外的复杂运算
	DUAL		支持
	FORCE INDEX		支持
	USING INDEX		支持
	IGNORE INDEX		支持

2. 跨库SELECT语句

MySQL语句类型	子句类型	功能	状态	说明
SELECT	LIMIT n,m		支持
	ORDER BY		支持
	ORDER BY LIMIT n,m		支持
	GROUP BY ASC\|DESC WITH ROLLUP		支持
	GROUP BY ORDER BY LIMIT m,n		支持
	GROUP BY/ORDER BY字段值大小写敏感		支持
	聚合函数	SELECT子句中的聚合函数	支持
		HAVING子句中的聚合函数	支持
		COUNT(DISTINCT)	支持
	FETCH FIRST ROWS		支持
	FOR UPDATE WAIT		支持
	DISTINCT		支持
	ROWNUM		限制支持	ROWNUM仅支持以下几种用法： 1. 位于SELECT字段中，仅支持单独使用，例如 SELECT ROWNUM [as xx] ,xx from tablexx，用以对结果各行生成序列号，不允许ROWNUM出现在函数内部，同时不支持ROWNUM和*同时使用 2. 位于WHERE字段中，仅支持位于WHERE条件最外层，并且是一个'AND'条件的分支, 用以对结果进行数量限制，仅支持“ ROWNUM 比较操作符长整型数值” 同时在一个select子句中仅允许出现一次
	WHERE	函数	支持
	PARTITION		支持
	HAVING		支持
	PROCEDURE		限制支持	V2.5.5开始支持单库的存储过程
	INTO OUTFILE		支持	· 要求执行语句的计算节点数据库用户拥有FILE权限。 · 当计算节点为集群模式时，无论在集群中哪台服务器上执行此语法，输出文件都将保存在当前主计算节点服务器上的固定路径： /usr/local/hotdb/hotdb-server/hotdb-temp。 · 若输出时集群发生切换，仍能保证数据输出正常。
	INTO DUMPFILE		不支持
	INTO 变量		不支持
	FOR UPDATE		支持
	LOCK IN SHARE MODE		支持
	FORCE INDEX		支持
	USING INDEX		支持
	IGNORE INDEX		支持
	STRAIGHT_JOIN		支持
	JOIN		支持	请参考跨库JOIN
	子查询	JOIN	支持
		IFNULL/NULLIF	支持
		UNION/UNION ALL	支持
		IS NULL /IS NOT NULL	支持
		PARTITION分区表	支持
		AVG/SUM/MIN/MAX函数	支持
		横向派生表	不支持	MySQL8.0新功能
	UNION/UNION ALL	join	支持

12.1.6 UPDATE语句

1. 单库UPDATE语句

MySQL语句类型	子句类型	功能	支持状态	说明
UPDATE	LOW_PRIORITY		支持
	IGNORE		支持
	ORDER BY		支持
	LIMIT n		支持
	SET		支持	· 允许更新分片字段，但要求分片字段值的变更不会影响数据路由，即修改后的分片字段值与修改前的值路由到相同节点，否则执行不成功 · 父子表不允许使用表达式语法更新父子表的关联字段，即使分片字段值的变更不会影响数据路由，例如SET id=id或SET id=id+3 · 不支持一条语句多次更新分片字段，例如：UPDATE table1 SET id =31,id=41 WHERE id =1;
	WHERE	dnid	支持	DML WHERE条件里dnid作为OR条件时，仅判断dnid条件，其他限制条件忽略
	WHERE	函数	支持
	函数		支持
	多表关联		支持

2. 跨库UPDATE语句

MySQL语句类型	子句类型	功能	支持状态	说明
UPDATE	ORDER BY DESC\|ASC		支持
	LIMIT n		支持
	ORDER BY DESC\|ASC LIMIT n,m		支持	父子表不支持
	ORDER BY字段值大小写敏感		支持
	WHERE		支持
	SET		支持	· 允许更新分片字段，但要求分片字段值的变更不会影响数据路由，即修改后的分片字段值与修改前的值路由到相同节点，否则执行不成功 · 父子表不允许使用表达式语法更新父子表关联字段，即使关联字段值的变更不会影响数据路由，例如SET id=id或SET id=id+3 · 不支持一条语句多次更新分片字段，例如：UPDATE table1 SET id =31,id=41 WHERE id =1;
	SET	子句中的函数	支持
	WHERE中的函数		支持
	PARTITION		支持
	JOIN		支持

12.1.7 跨库JOIN

一级功能	二级功能	三级功能	支持状态	说明
INNER/ LEFT JON	UNION ALL		支持
	UNION		支持
	HAVING	无条件字段	不支持	SELECT子句必须包含HAVING过滤字段，MySQL也一样
		COUNT(*)	支持
		AVG()	支持
		MAX()	支持
		MIN()	支持
		SUM()	支持
		别名	支持
	ORDER BY	单字段	支持
		多字段相同顺序	支持	order by column_name1 desc,column_name2 desc
		多字段不同顺序	支持	order by column_name1 desc,column_name2 asc
		字段别名	支持	别名不能与表中的字段名称相同
		字段值大小写敏感	支持
		ENUM类型	支持
		函数	支持
	OR		支持
	WHERE	不同字段OR条件	支持
		单个字段的or条件	支持
		IN	支持
		AND	支持
		IS NOT NULL	支持
		IS NULL	支持
		BETWEEN … AND …	支持
		>、>= 、< 、<=	支持
		NOW()等常量表达式	支持	column1 > NOW() 或 column1 > DATE_ADD(NOW(), INTERVAL +3 day )
		运算表达式	支持
		LIKE	支持
	GROUP BY	单字段	支持
		多字段	支持
		ORDER BY NULL	支持
		WITH ROLLUP	支持
		字段别名	支持	别名不能与表名中的字段名称相同
		字段值大小写	支持
	FORCE INDEX		支持
	USING INDEX		支持
	IGNORE INDEX		支持
	AVG	AVG()	支持
		AVG(IFNULL())	支持
		AVG(column1-column2)	支持
	COUNT	COUNT()	支持
		COUNT DISTINCT	支持
		COUNT(*)	支持
		COUNT(1)	支持
	MIN	MIN()	支持
	MAX	MAX()	支持
	SUM	SUM()	支持
		SUM(CASE ... WHEN...)	支持
		SUM(IFNULL())	支持
		SUM(column1-column2)	支持
	INTO OUTFILE		支持	1. 要求执行语句的计算节点数据库用户拥有FILE权限 2.无论在哪台服务器上执行此语法，输出文件都将保存在当前计算节点服务器上的固定路径： /usr/local/hotdb/hotdb-server/hotdb-temp 3. 若输出时集群发生切换，仍能保证数据输出正常
	FOR UPDATE		不支持
	LOCK IN SHARE MODE		不支持
	子查询		支持
	表别名		支持	支持使用表别名WHERE a.column或者SELECT a.column
	ON子句	单个=	支持
		<=>	支持
		!= <>	支持
		>= > <= <	支持
		多个>= > <= <条件	支持
		多个 and = 条件	支持
		IN	支持
		IS NOT NULL	支持
		IS NULL	支持
BETWEEN … AND …		支持
LIKE		支持
or条件		支持
数学表达式		支持
SELECT子句	显示空列	支持	SELECT '' AS A FROM … 查询结果中能正确显示空列
SELECT子句	STRAIGHT_JOIN	支持
函数	UNIX_TIMESTAMP()	支持
	NOW()	支持
	DATE_FORMAT()	支持
	DATE_ADD()	支持
	DATEDIFF()	支持
	FROM_UNIXTIME()	支持
	CONVERT	支持
	SUBSTRING_INDEX()	支持
	SUBSTRING()	支持
	TRIM()	支持
	RTRIM()	支持
	LTRIM()	支持
	UCASE()	支持
	UPPER()	支持
	FLOOR()	支持
	% 或 MOD	支持
	RAND()	支持
	TRUNCATE()	支持
	/ 或 DIV	支持
	ABS()	支持
	LENGTH()	支持
	CONCAT()	支持
	CAST()	支持
	IF()	支持
	IFNULL	支持
	CASE...WHEN...END	支持
	DISTINCT	支持
USING(column)		支持
PARTITION		支持
LIMIT	LIMIT n,m	支持
LIMIT	LIMIT n	支持
多表(三表及以上)查询	单种LEFT JOIN	支持
	单种INNER JION	支持
	单种NATURAL JOIN	支持
	混合的LEFT/INNER JOIN/RIGHT JOIN	支持
	混合的LEFT/INNER/NATURAL JOIN	支持
	TABLE a … JOIN (TABLE b,TABLE c) …	支持
NATURAL JOIN		支持
不同节点的表JOIN		支持
JOIN	UPDATE … JOIN		支持
JOIN	DELETE … JOIN		支持

12.2 DDL语句

12.2.1 ALTER语句

MySQL语句类型	子句类型	支持状态	说明
ALTER TABLE	ADD COLUMN	支持
	ADD PRIMARY KEY/UNIQUE/FOREIGN KEY/FULLTEXT/INDEX/KEY	支持	支持 ADD UNIQUE [index_name][index_type]index_col_name
	父子表的ADD FOREIGN KEY	限制支持	非分片字段作为外键关联字段时，无法跨节点保证父子表数据关联性。即在MySQL中，若父表与子表的外键值相等，则可匹配后插入数据，但在分布式环境中，当非分片字段作为外键关联字段时，由于子表外键关联字段路由的节点与父表分片字段的路由节点不一致，导致子表最终路由的存储节点中找不到父表所对应的外键值，故插入失败： ERROR 1452 (23000): Cannot add or update a child row: a foreign key constraint fails
	ADD SPATIAL [INDEX\|KEY]	支持
	ADD CONSTRAINT [CONSTRAINT [symbol]] PRIMARY KEY/UNIQUE KEY/FOREIGN KEY	支持
	父子表的ADD CONSTRAINT [CONSTRAINT [symbol]] FOREIGN KEY	限制支持	非字段作为外键关联字段时，无法跨节点保证父子表数据关联性。即在MySQL中，若父表与子表的外键值相等，则可匹配后插入数据，但在分布式父子表环境中，当非关联字段作为外键关联字段时，由于子表外键关联字段路由的节点与父表分片字段的路由节点不一致，导致子表最终路由的存储节点中找不到父表所对应的外键值，故插入失败： ERROR 1452 (23000): Cannot add or update a child row: a foreign key constraint fails
	ALGORITHM	支持	MySQL8.0新增INSTANT，且默认使用INSTANT
	ALTER COLUMN	支持
	LOCK	支持
	MODIFY/CHANGE [COLUMN]	支持
	DROP COLUMN	支持
	DROP PRIMARY KEY/KEY/INDEX/FOREIGN KEY	支持
	DISABLE KEYS	支持
	ENABLE KEYS	支持
	DISCARD TABLESPACE	不支持
	IMPORT TABLESPACE	不支持
	ADD/DROP/TRUNCATE PARTITION	支持
	GENERATED COLUMNS	支持	MySQL8.0与5.7新增功能
	SECONDARY INDEXES	支持	MySQL8.0与5.7新增功能
	CHECK	支持	MySQL8.0新增功能
ALTER	VIEW	支持	计算节点版本高于（包含）2.5.6时支持

12.2.2 CREATE语句

MySQL语句类型	子句类型	支持状态	说明
CREATE DATABASE		支持	V2.5.6版本以上可支持直接创建逻辑库，功能使用说明可见表格下方补充描述。
CREATE EVENT		禁用
CREATE FUNCTION		限制支持	单库场景下可支持
CREATE INDEX	FOREIGN KEY	支持
	UNIQUE	支持
	父子表的FOREIGN KEY	限制支持	非分片字段作为外键关联字段时，无法跨节点保证父子表数据关联性。即在MySQL中，若父表与子表的外键值相等，则可匹配后插入数据，但在分布式父子表环境中，当非关联字段作为外键关联字段时，由于子表外键关联字段路由的节点与父表分片字段的路由节点不一致，导致子表最终路由的存储节点中找不到父表所对应的外键值，故插入失败： ERROR 1452 (23000): Cannot add or update a child row: a foreign key constraint fails
	FULLTEXT	支持
	SPATIAL	支持
	ALGORITHM	支持
	LOCK	支持
	FUNCTIONAL KEYS	支持	MySQL8.0新增功能
CREATE TABLE	CREATE TEMPORARY TABLE	禁用
	CREATE TABLE [IF NOT EXISTS]	支持
	CREATE TABLE LIKE	支持
	CREATE TABLE AS SELECT …	支持	· 要求存储节点用户拥有CREATE TEMPORARY TABLE权限。 · 要求CREATE的表和SELECT的表关联至少一个相同的数据节点，否则执行不成功：ERROR 10215 (HY000): [LOADTEST1] no overlapping datanode · 不支持CREATE TABLE ... IGNORE SELECT 和 CREATE TABLE ... REPLACE SELECT
	GENERATED COLUMNS	支持	MySQL8.0与5.7新增功能
	SECONDARY INDEXES	支持	MySQL8.0与5.7新增功能
	CHECK	支持	MySQL8.0新增功能

CREATE TRIGGER		支持	目前仅支持单库，且需要赋予CREATE权限，内部语句不验证权限，DEFINER相关目前不支持，show trrigers时相关字段显示当前用户
CREATE VIEW		支持	计算节点版本高于（包含）2.5.6时支持

CREATE DATABASE 在计算节点使用时对应为创建逻辑库的功能，语法使用说明如下：

CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] db_name [create_option] ... [DEFAULT DATANODE 'datanodeid']

create_option: [DEFAULT] { CHARACTER SET [=] charset_name | COLLATE [=] collation_name }

[DEFAULT DATANODE 'datanodeid'] 可以指定默认分片节点。当不单独指定时，默认关联所有数据节点；当指定时，按指定数据节点关联成逻辑库默认分片节点；当指定的datanodeid不存在时，提示：datanodeid not exists。

服务端创建逻辑库语法示例：

create database if not exists zjj_d3 default datanode '1,4';

· 关联不存在的数据节点

12.2.3 DROP语句

MySQL语句类型	子句类型	支持状态	说明
DROP DATABASE		支持	V2.5.7版本以上可支持直接删除逻辑库，功能使用说明可见表格下方补充描述。
DROP EVENT		禁用
DROP FUNCTION		禁用
DROP INDEX	UNIQUE	支持
	普通索引KEY	支持
	FOREIGN KEY	支持
	FOREIGN KEY	支持
	FULLTEXT	支持
	SPATIAL	支持
	ALGORITHM	支持
	LOCK	支持
DROP TABLE	DROP [TEMPORARY] TABLE [IF EXISTS]	禁用
	DROP TABLE	支持
	DROP TABLE 多表	支持	必须保证多表在相同节点
	DROP TABLE table_name [RESTRICT \| CASCADE]	支持
DROP TRIGGER		支持	需要赋予DROP权限
DROP VIEW		支持

DROP DATABASE 在计算节点使用时对应为删除逻辑库的功能，语法使用说明如下：

DROP {DATABASE | SCHEMA} [IF EXISTS] db_name

· db_name为计算节点逻辑库名称。

· Server.xml新增参数enableDropDatabase，0为关闭，1为开启，默认值0。

· 当设置参数1时，可执行DROP {DATABASE | SCHEMA} [IF EXISTS] db_name语句，删除逻辑库时，若库中有表也会一起删除。

· 当设置参数0时，只允许删除空库，若库中有表则删除库失败。

服务端删除逻辑库语法示例：drop database if exists zjj_db2;

· 设置enableDropDatabase=0，库中有表时提示：

· 设置enableDropDatabase=0且同时开启回收站功能，删除库中表后再删除库时提示：

· 设置enableDropDatabase=1，库中有表或开启回收站后删除表，均可以成功删除库：

12.2.4 TRUNCATE与RENAME语句

MySQL语句类型

子句类型

支持状态

说明

RENAME TABLE

支持

1. 支持RENAME多张表，但要求这些表都在相同节点，否则将执行失败并报错：ERROR 10042 (HY000): unsupported to rename multi table with different datanodes

2. RENAME中的目标表不需要提前添加表配置，若添加新表的表配置，需要保证新表表配置与原表一致，否则RENAME将不成功

注意：计算节点数据库用户需要对旧表拥有ALTER和DROP权限，以及对新表拥有CREATE和INSERT权限

TRUNCATE TABLE

支持

12.3 事务管理与锁语句

语句类型	事务语句	语句参数	状态	说明
事务管理	START TRANSACTION	无参数	支持
		WITH CONSISTENT SNAPSHOT	支持
		READ WRITE	支持
		READ ONLY	支持
	BEGIN		支持
	COMMIT		支持
	COMMIT	[AND [NO] CHAIN] [[NO] RELEASE]	支持
	ROLLBACK		支持
	ROLLBACK	[AND [NO] CHAIN] [[NO] RELEASE]	支持
	SET autocommit	0\|1	支持
SAVEPOINT	SAVEPOINT		支持
	ROLLBACK … TO …		支持
	RELEASE SAVEPOINT		支持
LOCK	LOCK TABLES	READ [LOCAL]	禁用
	LOCK TABLES	[LOW_PRIORITY] WRITE	禁用
	UNLOCK TABLES		禁用
	LOCK INSTANCE FOR BACKUP		禁用
	UNLOCK INSTANCE;		禁用
事务隔离级别语句	SET SESSION TRANSACTION	REPEATABLE READ	支持	XA模式可完整支持，普通模式下会存在读到部分提交的情况
		READ COMMITTED	支持	普通模式下会存在读写不一致的问题； XA模式下，2.5.5版本以下不支持，2.5.5版本及以上支持，但跨库多次查询的情况下不保证读写强一致；即：对select 、insert select 这类SQL，如果出现一个SQL转成多个SQL执行的SQL语句，则SQL执行结果在该隔离级别下可能不正确。可参考数据强一致性（XA事务）章节描述
		READ UNCOMMITTED	不支持
		SERIALIZABLE	支持	XA模式可完整支持，普通模式下会存在读到部分提交的情况
	SET GLOBAL TRANSACTION	REPEATABLE READ	不支持	不支持SET GLOBAL的方式，只支持SET SESSION
		READ COMMITTED	不支持	不支持SET GLOBAL的方式，只支持SET SESSION
		READ UNCOMMITTED	不支持
		SERIALIZABLE	不支持
	SET SESSION TRANSACTION	READ ONLY	支持
	SET SESSION TRANSACTION	READ WRITE	支持
	SET GLOBAL TRANSACTION	READ ONLY	不支持
	SET GLOBAL TRANSACTION	READ WRITE	不支持
分布式事务	XA START\|BEGIN …	[JOIN\|RESUME]	禁用
	XA END	[SUSPEND [FOR MIGRATE]]	禁用
	XA PREPARE		禁用
	XA COMMIT	[ONE PHASE]	禁用
	XA ROLLBACK		禁用
	XA RECOVER		禁用
	XA RECOVER	[CONVERT XID]	禁用	5.7新增参数

12.4 其他MySQL语句

12.4.1 存储过程、自定义函数等语句

SeaSQL DRDS当前仅支持垂直库（即逻辑库仅关联一个数据节点）场景下下使用存储过程，自定义函数等语句。

语句类型	SQL语句	支持状态	说明
存储过程	BEGIN … END …	限制支持	垂直库下可使用，下同
	DECLARE	限制支持
	CASE	限制支持
	IF	限制支持
	ITRATE	限制支持
	LEAVE	限制支持
	LOOP	限制支持
	REPEAT	限制支持
	RETURN	限制支持
	WHILE	限制支持
	CURSOR	限制支持
	DECLARE … CONDITION…	限制支持
	DECLARE … HANDLER …	限制支持
	GET DIAGNOSTICS	限制支持
	RESIGNAL	限制支持
	SIGNAL	限制支持
Plugin and User-Defined Function 语句	CREATE [AGGREGATE] FUNCTION function_name RETURNS {STRING\|INTEGER\|REAL\|DECIMAL} SONAME shared_library_name	限制支持
	DROP FUNCTION	限制支持
	INSTALL PLUGIN	禁用
	UNINSTALL PLUGIN	禁用

12.4.2 Prepare SQL Statement

语句类型	SQL语句		支持状态	说明
Prepare SQL Statement		PREPARE … FROM …	支持
		EXECUTE …	支持
		{DEALLOCATE \| DROP} PREPARE	支持

12.4.3 用户管理语句

SeaSQL DRDS实现了一套自己的用户名与权限管理的系统，可以优先在分布式事务数据库可视化管理平台页面上操作即可。若使用同MySQL数据库用户管理类同的SQL语句，部分可以支持。

语句类型	SQL语句		支持状态	说明
用户管理语句		ALTER USER	支持	使用说明详见表格下方详细描述
		CREATE USER	支持	使用说明详见表格下方详细描述
		DROP USER	支持	使用说明详见表格下方详细描述
		GRANT	支持	使用说明详见表格下方详细描述
		RENAME USER	禁用	通过平台操作可支持
		REVOKE	支持	使用说明详见表格下方详细描述
		SET PASSWORD	禁用	通过平台操作可支持

计算节点版本高于2.5.6版本时，支持使用SQL语句创建/删除用户，并给用户赋权/解权。

1. 创建用户

· 创建用户语法：

CREATE USER [IF NOT EXISTS] 'user_name'@'host_name' IDENTIFIED BY 'password_auth_string'[,'user_name'@'host_name' IDENTIFIED BY 'password_auth_string']...

· 服务端创建用户语法示例：

create user 'jingjingjing'@'%' identified by 'jing' with max_user_connections 3;

创建用户时执行用户必须具有super权限且不支持空密码创建，用户名最大长度限制64字符，密码暂未限制。

· 执行用户不具有super权限创建用户，提示如下：

· 空密码创建时，提示如下：

· 用户名超过限制，提示如下：

· 重复创建用户，提示如下：

2. 删除用户

· 删除用户语法：

DROP USER [IF EXISTS] 'user_name'@'host_name' [,'user_name'@'host_name']...

· 服务端删除用户语法示例：

drop user 'jingjingjing'@'%';

删除用户时执行用户必须具有super权限。

· 执行用户不具有super权限删除用户，提示如下：

· 删除不存在的用户时，提示如下：

3. 修改密码

服务端支持三种方式修改密码，分别是：ALTER USER，SET，GRANT。其中，GRANT语法见GRANT赋权，另外两种语法如下：

Alter user:

alter user 'user_name'@'host_name' identified with mysql_native_password by 'password_auth_string';

SET:

set password for 'user_name'@'host_name'=password('password_auth_string');

语法示例如下：

Alter user：

alter user 'auto'@'%' identified with mysql_native_password by 'auto123';

SET:

set password for 'auto'@'%'=password('auto123');

当前用户只能修改自己的密码，如有super权限，则可修改其他用户的密码。

· 执行用户不具有super权限修改其他用户密码时，提示如下：

· 修改密码的用户不存在时，提示如下：

4. GRANT赋权

GRANT赋权语法：

GRANT

priv_type[, priv_type ] ...

ON priv_level TO 'user_name'@'host_name'[,'user_name'@'host_name'] ...

[WITH MAX_USER_CONNECTIONS con_num ]

· 可授权的权限类型priv_type包括：SELECT、 UPDATE、 DELETE、 INSERT 、CREATE 、DROP 、ALTER 、FILE 、 SUPER

· 可使用ALL [PRIVILEGES]为用户赋予所有权限（包括SUPER权限）在内，用法等同MySQL。

· 其中，*：表示当前数据库中的所有表(必须use 逻辑库之后才能执行)；*.*：表示所有数据库中的所有表；db_name.*：表示某个数据库中的所有表，db_name 指定数据库名；db_name.tbl_name：表示某个数据库中的某个表，db_name 数据库名，tbl_name 表名；tbl_name：表示某个表，tbl_name 指定表名(必须use 逻辑库之后才能执行)

服务端GRANT语法示例：

· 全局权限：

grant all on *.* to ' test_ct '@'localhost' identified by ' test_ct ' with max_user_connections 3;

· 库级权限：

grant all on test_ct.* to 'test_ct'@'localhost' identified by 'test_ct';

· 表级权限：

grant update on test_ct.test_aa to 'test_ct'@'localhost' identified by 'test_ct';

赋权注意事项：

· 执行赋权操作的用户本身必须有super权限。

· 可在赋权时同步创建用户但需带上密码。

· super和file必须赋全局管理权限，不支持库和表级别授权。

· all权限不能与其他权限同时使用只能单独赋权，同MySQL。

· 权限修改后只对新连接生效，不会改变已创建的连接权限。

¡ 若执行赋权操作的用户不具有super权限，则提示如下：

¡ 赋权时同步创建用户

¡ 赋权时同步创建用户不带密码，提示如下：

¡ super只能赋全局权限，不支持库和表级别授权，如下图：

¡ file权限只能赋全局权限，不支持库和表级别授权

¡ all权限只能单独授权，不能和其他权限项同时授权

· 使用GRANT语句修改用户密码时，必须注意，若修改的用户对象是Keepalived/LVS配置文件中的连接用户，必须同步修改Keepalived/LVS配置文件中对应的连接密码并加载配置，否则可能导致计算节点高可用切换异常、或者LVS流量分发异常等问题。另外，也需要同步修改管理平台连接计算节点的用户密码配置，否则会立即导致管理平台无法连接计算节点，进而无法监控、无法操作等问题。

5. REVOKE删除权限

REVOKE删除权限语法：

REVOKE priv_type [, priv_type ] ...ON priv_level FROM 'user_name'@'host_name' [, 'user_name'@'host_name'] ...

服务端REVOKE语法示例：

revoke select,update,delete,insert,create,drop,alter,file,super on *.* from jingjing05;

解权注意事项：

· 执行删除权限操作的用户本身必须有super权限。

· 可以移除部分权限和所有权限，可以移除对应库、表级别的权限。

· 权限项可重复移除，但移除不存在的类型会报语法错误。

· 权限修改后只对新连接生效，不会改变已创建的连接权限。

¡ 执行用户没有super权限时删除权限，提示如下：

¡ 支持移除部分权限

¡ 支持移除所有权限

¡ 支持移除库级别权限

¡ 支持移除表级别权限

¡ 移除权限后再次使用该权限，报错提示如下

12.4.4 表维护语句

语句类型	SQL语句	支持状态	说明
表维护语句	ANALYZE TABLE	禁用
	CHECK TABLE	禁用
	CHECKSUM TABLE	禁用
	OPTIMIZE TABLE	禁用
	REPAIR TABLE	禁用

12.4.5 SET语句

语句类型	SQL语句	支持状态	说明
SET语句	SET GLOBAL	不支持
	SET SESSION	部分支持	如:SET SESSION TRANSACTION/SET TX_READONLY/SET NAMES等
	SET @@global.	不支持
	SET @@session.	部分支持	例如支持设置字符集相关（连接字符集、查询结果字符集、字符集校对规则），最大连接数、是否进行外键约束等
	SET @@	不支持
	SET ROLE	禁用	计算节点不支持MySQL8.0新增角色功能
	用户自定义变量	支持	仅支持单库下调用
	SET CHARACTER SET	支持	仅支持：CHARACTER_SET_CLIENT CHARACTER_SET_CONNECTION CHARACTER_SET_RESULTS
	SET NAMES	支持
	SET TRANSACTION ISOLATION LEVEL	支持	普通模式下支持的级别为REPEATABLE READ，READ COMMITTED，SERIALIZABLE XA 模式只支持 REPEATABLE READ、SERIALIZABLE

12.4.6 SHOW语句

语句类型	SQL语句	支持状态	说明
SHOW语句	SHOW AUTHORS	支持	返回空集
	SHOW BINARY LOGS	支持	返回空集
	SHOW BINLOG EVENTS	支持	返回空集
	SHOW CHARACTER SET	支持
	SHOW COLLATION	支持
	SHOW FIELDS FROM	支持
	SHOW COLUMNS FROM\|IN tbl_name	支持
	SHOW FULL COLUMNS FROM\|IN tbl_name	支持
	SHOW CONTRIBUTORS	支持	返回空集
	SHOW CREATE DATABASE	支持
	SHOW CREATE EVENT	支持	返回空集
	SHOW CREATE FUNCTION	支持	返回空集
	SHOW CREATE PROCEDURE	支持	返回空集
	SHOW CREATE TABLE	支持
	SHOW CREATE TRIGGER	支持	返回空集
	SHOW CREATE VIEW	支持	返回空集
	SHOW DATABASES	支持
	SHOW ENGINES	支持	返回空集
	SHOW ERRORS	支持
	SHOW EVENTS	支持	返回空集
	SHOW FUNCTION STATUS	支持	返回空集
	SHOW GRANTS	支持	显示计算节点的权限控制情况
	SHOW INDEX FROM db_name.table_name	支持
	SHOW INDEX FROM table_name WHERE…	支持
	SHOW MASTER STATUS	支持	返回空集
	SHOW OPEN TABLES	支持	返回空集
	SHOW PLUGINS	支持	返回空集
	SHOW PRIVILEGES	支持	返回空集
	SHOW PROCEDURE STATUS	支持	返回空集
	SHOW PROCESSLIST	支持	显示计算节点的连接情况
	SHOW PROFILES	支持	返回空集
	SHOW RELAYLOG EVENTS [IN 'log_name'] [FROM pos] [LIMIT [offset,] row_count]	支持	返回空集
	SHOW SLAVE HOSTS	支持	返回空集
	SHOW SLAVE STATUS	支持	返回空集
	SHOW GLOBAL STATUS	支持
	SHOW SESSION STATUS	支持
	SHOW STATUS	支持
	SHOW TABLE STATUS	支持
	SHOW FULL TABLES	支持
	SHOW TABLES	支持
	SHOW TRIGGERS	支持	返回空集
	SHOW GLOBAL\|SESSION VARIABLES	支持
	SHOW WARNINGS	支持
	SHOW HOTDB TABLES	支持	支持[{FROM \| IN} db_name] [LIKE 'pattern' \| WHERE expr] 显示计算节点的分片信息

12.4.7 DRDS PROFILE

语句类型	SQL语句	支持状态	说明
SET语句	SET hotdb_profiling={0\|1\|on\|off}	支持	支持 set [session] hotdb_profiling
SHOW语句	SHOW HOTDB_PROFILES	支持
SHOW语句	SHOW HOTDB_PROFILE FOR QUERY N [relative time\|real time]	支持	N代表执行的SQL id

功能说明：该功能仅限session级别

SHOW HOTDB_PROFILES输出与MySQL相同：

· 第一列Query_ID为SQL的id

· 第二列Duration为（计算节点完成向前端写出最后一个结果集的时间-计算节点开始接收SQL第一个数据包时的时间点）的时长，单位：ms。

· 第三列Query 为SQL文本

示例：

mysql> show hotdb_profiles;

+----------+----------+-------------------+

| Query_ID | Duration | Query |

+----------+----------+-------------------+

| 1 | 422 | SELECT DATABASE() |

| 2 | 1962 | select * from aa |

+----------+----------+-------------------+

2 rows in set (0.01 sec)

SHOW HOTDB_PROFILE FOR QUERY N [relative time|real time]与MySQL相似：

· 第一列Status，即SQL 语句执行的状态；

· 第二列为relative time或real time，若不指定则默认relative time；

· 第三列Duration，即SQL执行过程中每一个步骤的耗时。

示例：

mysql> show hotdb_profile for query 2 relative time;

+--------------------------------------------+---------------+----------+

| Status | Relative_time | Duration |

+--------------------------------------------+---------------+----------+

| SQL receive start time | 0 | NULL |

| SQL receive end time | 67 | 67 |

| multiquery parse end time | 125 | 58 |

| multiquery other SQL execute wait end time | 155 | 30 |

| SQL parse end time | 709 | 553 |

| backend SQL 1 request generate start time | 709 | NULL |

| backend SQL 1 request generate end time | 892 | 182 |

| backend SQL 1 request send start time | 1329 | NULL |

| backend SQL 1 request send end time | 1390 | 61 |

| backend SQL 1 result receive start time | 1733 | NULL |

| backend SQL 1 result receive end time | 1842 | 109 |

| backend SQL 1 result rewrite start time | 1733 | NULL |

| backend SQL 1 result rewrite end time | 1849 | 116 |

| result send start time | 1849 | NULL |

| result send end time | 1962 | 112 |

+--------------------------------------------+---------------+----------+

15 rows in set (0.00 sec)

注：status列说明：

· SQL recive start time：计算节点开始接收SQL第一个数据包的时间点。

· SQL recive end time：计算节点完成SQL接收的时间点（接收失败的SQL，后续不再继续输出）。

· multiquery parse end time：计算节点完成Multi query解析的时间点（发生解析失败后续行不再继续输出）。

· multiquery other SQL execute wait end time：计算节点开始SQL解析的时间点（如果前面没有SQL要跑，则不需要此行）。

· SQL parse end time：计算节点完成SQL解析的时间点（发生解析失败后续行不再继续输出）。

· backend SQL N request generate start time：计算节点开始后端SQL N 生成的时间点(N为后端SQL的序列号1，2，3，4...)。

· backend SQL N request generate end time：计算节点完成后端SQL N 的时间点。

· backend SQL N request send start time：计算节点开始向第一个MySQL发送第一个后端SQL N的时间。

· backend SQL N request send end time：计算节点完成向最后一个MySQL发出最后一个后端SQL N的时间。

· backend SQL N result recive start time：计算节点开始从第一个MySQL接收到第一个SQL N结果集数据包的时间。

· backend SQL N result recive end time：计算节点完成从最后一个MySQL接收完成最后一个SQL N结果集数据包的时间。

· backend SQL N result rewrite start time：计算节点开始对收到的结果集进行改写处理的时间（如果SQL执行报错或报warning，这一段时间会包含error或warning的处理时间）

· backend SQL N result rewrite end time：计算节点完成对收到的结果集进行改写处理的时间

· result send start time：计算节点开始向前端写出第一个结果集包的时间

· result send end time：计算节点完成向前端写出最后一个结果集的时间

12.4.8 其他MySQL管理语句

语句类型	SQL语句	支持状态	说明
其他管理语句	BINLOG 'str'	禁用
	CACHE INDEX	禁用
	KILL [CONNECTION \| QUERY]	支持
	LOAD INDEX INTO CACHE	禁用
	RESET MASTER	禁用
	RESET QUERY CACHE	禁用
	RESET SLAVE	禁用
MySQL Utility Statements	DESCRIBE\|DESC	支持
	EXPLAIN	支持	请参考EXPLAIN
	EXPLAIN EXTENDED	不支持
	HELP	不支持
	USE	支持

KILL语句与MySQL KILL语句用法一样。KILL会同时关闭计算节点前端连接与存储节点的MySQL数据库的连接。

服务端普通用户仅能KILL自己的连接，SUPER用户才能KILL其他用户的连接。

12.4.9 SHOW HOTDB VARIABLES

查看SeaSQL DRDS内存中参数配置信息，可在服务端执行以下语法：

SHOW HOTDB VARIABLES [LIKE ‘PATTERN’|WHERE EXPR];

· 不加任何条件，查看的是所有参数信息：

· 查询加上条件，可以筛选特定参数：

12.4.10 SHOW VARIABLES 和SHOW STATUS

SeaSQL DRDS对MySQL部分variables及status的显示结果做了支持，可通过相关语法查看计算节点连接的存储节点变量信息。

无特殊处理的参数显示说明：当show_dnid=1，merge_result=0时，输出数据增加dnid一列，所有数据显示在读存储节点中的原始值；当show_dnid=1，merge_result=1时，变量值相同的存储节点会聚合为一行显示；当show_dnid=0时，没有特殊说明都是返回第一个存储节点变量值，

以下参数特殊处理，具体显示结果，见显示说明：

MySQL VARIABLES	显示说明
BIND_ADDRESS	* 始终显示*
TX_ISOLATION	根据server.xml中配置的隔离级别设置，默认REPEATABLE-READ,session也按照server.xml中配置显示此参数在MySQL8.0时被移除，用transaction_isolation代替此参数
TRANSACTION_ISOLATION	MySQL8.0新增参数，用于代替tx_isalation
AUTO_INCREMENT_OFFSET	目前显示1
CHARACTER_SET_CONNECTION	仅支持utf8/gbk/latin1/utf8mb4/gb18030字符集
CHARACTER_SET_RESULTS	仅支持utf8/gbk/latin1/utf8mb4/gb18030字符集
MAX_CONNECTIONS	按计算节点实际配置显示
MAX_USER_CONNECTIONS	按计算节点实际配置显示
MAX_JOIN_SIZE	仅支持set session max_join_size=xxx , 按照计算节点设置的值显示, global的按照server.xml中JOIN中间结果集行数参数设置
CHARACTER_SET_SERVER	仅支持utf8/gbk/latin1/utf8mb4/gb18030字符集
VERSION_COMMENT	SeaSQL DRDS by H3C Tech
INTERACTIVE_TIMEOUT	172800
SERVER_UUID	始终显示00000000-0000-0000-0000-0000000000
TX_READ_ONLY	默认OFF， session的按照session的显示此参数在MySQL8.0时被移除，用transaction_ready_only代替
TRANSACTION_READ_ONLY	MySQL8.0新增参数，用于代替tx_read_only
PORT	按照配置的服务端口值显示
AUTOCOMMIT	默认ON，session级别的按照session的显示
HOSTNAME	MySQL5.7,显示为计算节点服务器的主机名
COLLATION_DATABASE	仅支持utf8/gbk/latin1/utf8mb4/gb18030字符集
CHARACTER_SET_DATABASE	仅支持utf8/gbk/latin1/utf8mb4/gb18030字符集
PROTOCOL_VERSION	按照计算节点实际使用的通讯协议版本显示
READ_ONLY	按照计算节点实际使用的模式设置
VERSION	MySQL版本号-SeaSQL DRDS版本号，按照计算节点实际使用的显示
COLLATION_SERVER	目前仅支持：latin1_swedish_ci latin1_bin gbk_chinese_ci gbk_bin utf8_general_ci utf8_bin utf8mb4_general_ci utf8mb4_bin
SOCKET	显示空字符串
SERVER_ID	显示0
WAIT_TIMEOUT	172800
SSL_CIPHER	返回空字符串
COLLATION_CONNECTION	目前仅支持：latin1_swedish_ci latin1_bin gbk_chinese_ci gbk_bin utf8_general_ci utf8_bin utf8mb4_general_ci utf8mb4_bin
FOREIGN_KEY_CHECKS	显示ON
CHARACTER_SET_CLIENT	仅支持utf8/gbk/latin1/utf8mb4/gb18030字符集
TIME_ZONE	time_zone参数为具体的相同值，或全为SYSTEM并且system_time_zone全相同的具体值。计算节点在SHOW [GLOBAL] VARIABLES时，将time_zone统一显示为+08:00这个字符串
MAX_ALLOWED_PACKET	计算节点控制，默认：64M
ADMIN_ADDRESS	始终显示空字符串，MySQL8.0新增
INNODB_BUFFER_POOL_SIZE	逻辑库下所有节点总和，主备节点按主节点算

Status Name	显示说明
Compression	一律为OFF（计算节点暂不支持压缩协议）
Innodb_buffer_pool_dump_status	第一个不以not started结尾的状态，否则取逻辑库的第一个节点的值
Innodb_buffer_pool_load_status	第一个不以not started结尾的状态，否则取逻辑库的第一个节点的值
Innodb_have_atomic_builtins	如果逻辑库有一个节点为OFF则为OFF，全为ON则为ON
Innodb_page_size	取逻辑库的第一个节点的值
Innodb_row_lock_time_avg	逻辑库的所有节点取简单平均
Innodb_row_lock_time_max	逻辑库的所有节点取最大值
Last_query_cost	始终0.000000
Last_query_partial_plans	始终0
Max_used_connections	逻辑库的所有节点取最大值
Slave_heartbeat_period	逻辑库的所有节点取最大值
Slave_last_heartbeat	日期型，逻辑库的所有节点取最小值，如果全为空字符串则为空字符串
Slave_running	如果逻辑库有一个节点为OFF则为OFF，全为ON则为ON
Ssl_cipher	始终返回空字符串
Ssl_cipher_list	始终返回空字符串
Ssl_ctx_verify_depth	取逻辑库的第一个节点的值
Ssl_ctx_verify_mode	取逻辑库的第一个节点的值
Ssl_default_timeout	取逻辑库的第一个节点的值
Ssl_server_not_after	始终返回空字符串
Ssl_server_not_before	始终返回空字符串
Ssl_session_cache_mode	取逻辑库的第一个节点的值
Ssl_verify_depth	取逻辑库的第一个节点的值
Ssl_verify_mode	取逻辑库的第一个节点的值
Ssl_version	取逻辑库的第一个节点的值
Tc_log_page_size	取逻辑库的第一个节点的值
Uptime	逻辑库的所有节点取最大值
Uptime_since_flush_status	逻辑库的所有节点取最大值
Caching_sha2_password_rsa_public_key	始终显示空字符串，MySQL8.0新增
Current_tls_ca	始终显示空字符串，MySQL8.0新增
Current_tls_capath	始终显示空字符串，MySQL8.0新增
Current_tls_cert	始终显示空字符串，MySQL8.0新增
Current_tls_cipher	始终显示空字符串，MySQL8.0新增
Current_tls_ciphersuites	始终显示空字符串，MySQL8.0新增
Current_tls_crl	始终显示空字符串，MySQL8.0新增
Current_tls_crlpath	始终显示空字符串，MySQL8.0新增
Current_tls_key	始终显示空字符串，MySQL8.0新增
Current_tls_version	始终显示空字符串，MySQL8.0新增
group_replication_primary_member	始终显示空字符串，MySQL8.0新增
mecab_charset	逻辑库第一个，MySQL8.0新增
Performance_schema_session_connect_attrs_longest_seen	逻辑库取最大，MySQL8.0新增
Rpl_semi_sync_master_clients	始终显示0，MySQL8.0新增
Rpl_semi_sync_master_net_avg_wait_time	逻辑库求平均，MySQL8.0新增
Rpl_semi_sync_master_status	始终显示ON，MySQL8.0新增
Rpl_semi_sync_master_tx_avg_wait_time	逻辑库求平均，MySQL8.0新增
Rpl_semi_sync_slave_status	始终显示ON，MySQL8.0新增
Rsa_public_key	始终显示空字符串，MySQL8.0新增

12.5 计算节点语法特殊功能

12.5.1 默认分片规则建表

在使用分片数据库时，需要先将表的分片规则信息配置好之后才能创建表。实际使用过程中，用户可能对分片数据库及分片规则不了解，这就需要一种能直接从MySQL过渡到分片数据库SeaSQL DRDS的方案，该方案能根据逻辑库关联的分片节点数量自动对表生成分片规则，称为默认分片规则。

1. 使用前提

逻辑库已设置分片节点。为逻辑库设置分片节点的方法如下：

(1) 登录分布式事务数据库管理平台,选择“配置”->“逻辑库”。

(2) 给逻辑库设置默认分片节点，然后点动态加载。

2. 功能说明

为逻辑库设置默认分片节点后，登录计算节点可以直接建表，SeaSQL DRDS将根据分片节点的数量为创建的表自动设置分片规则信息。具体的分片规则如下：

如果逻辑库只设置了一个分片节点，则SeaSQL DRDS对创建的表不做分片处理（和MySQL原生的表一致），在SeaSQL DRDS中将此类表称为创建垂直分片表。

如果逻辑库设置了多个分片节点，则SeaSQL DRDS对创建的表进行水平分片，分片算法是对每行数据分片字段的值进行AUTO_CRC32从而确定该行数据应被存储在哪个分片节点中，分片字段选取顺序：主键字段 -> 唯一键字段 ->第一个整型字段（BIGINT、INT、MEDIUMINT、SMALLINT、TINYINT） ->没有整型字段时取字符串类型字段（CHAR、VARCHAR），以上类型全部没有时默认随机选择一个字段作为分片字段。

3. 注意事项

· 此功能仅推荐在初次接触SeaSQL DRDS的时候使用，正式交付以及上线不推荐，需要根据实际业务场景做分片。

· 若后期对逻辑库默认节点进行更改，对更改之前创建的表无影响，只对后续新增的表生效。

· SeaSQL DRDS中对表分为三类：全局表、水平分片表、垂直分片表。

¡ 全局表：在SeaSQL DRDS中如果一个表被定义为全局表，则该表存储在逻辑库下的所有分片节点中，且每个分片节点中该表的数据都是完全一致的全量数据。

¡ 水平分片表：在SeaSQL DRDS中如果一个表被定义为水平分片表，则该表存储在逻辑库下的所有分片节点中，且每个分片节点中该表的数据都只是部分行数据，所有分片节点中该表的数据合在一起才是该表的全量数据。

¡ 垂直分片表：在SeaSQL DRDS中如果一个表被定义为垂直分片表，则该表仅存储在逻辑库下的一个分片节点中（其余分片节点无该表信息），且该分片节点中存储该表的全量数据。SeaSQL DRDS中垂直分片表与一般垂直分片表概念不同，不是按列进行分片存储的。

4. 举例

假设“test001”逻辑库配置了一个默认分片节点，则“test01”表为垂直分片表；假设“test002”逻辑库配置了两个默认分片节点，则“test02”表为水平分片表。

mysql> use TEST001;

Database changed

mysql> create table test01(id not null auto_increment primary key,a char(8),b decimal(4,2),c int);

mysql> use TEST002;

Database changed

mysql> create table test02(id not null auto_increment primary key,a char(8),b decimal(4,2),c int);

12.5.2 已有分片规则建表

· 使用前提：

在管理平台上已创建了分片规则，并进行了动态加载。添加分片规则请参考《H3C SeaSQL DRDS 管理平台用户手册》。

· 功能说明：

根据管理平台已添加好的分片规则，在计算节点服务端利用特殊语句直接建表，无需再配置表分片信息。利用已有分片规则所建的表，删除表后，管理平台相关表配置信息会同步被删除。

利用服务端口命令查看分片规则的functionid | functionname| functiontype| ruleid | rulename等信息，根据相关字段信息创建表。

mysql> show hotdb functions;

+-------------+---------------------+---------------+----------------+

+-------------+---------------------+---------------+----------------+

| 1 | AUTO_GENERATE_CRC32 | AUTO_CRC32 | 1 |

| 2 | AUTO_CRC32_4 | AUTO_CRC32 | 0 |

| 3 | AUTO_CRC32_1 | AUTO_CRC32 | 0 |

| 26 | AUTO_GENERATE_MOD | AUTO_MOD | 1 |

| 31 | 29__MATCH1 | MATCH | 0 |

| 33 | 32_SIMPLE_MOD | SIMPLE_MOD | 0 |

| 36 | 36_SIMPLE_MOD | SIMPLE_MOD | 0 |

| 37 | 37_CRC32_MOD | CRC32_MOD | 0 |

+-------------+---------------------+---------------+----------------+

8 rows in set (0.01 sec)

mysql> show hotdb rules;

+---------+--------------------------------------------------------+-------------+-------------+----------------+

+---------+--------------------------------------------------------+-------------+-------------+----------------+

| 4 | hotdb-cloud_555f9d00-27c3-4eaa-860c-309312672908 | id | 3 | 0 |

| 12 | hotdb-cloud_8b7d9b8d-f711-476c-aa33-a4e2af184ab5 | adnid | 2 | 0 |

| 13 | hotdb-cloud_7f8fff18-6016-47f1-ab0a-1912f5b75523 | adnid | 2 | 0 |

| 21 | AUTO_GENERATE_3_JOIN_A_JWY | ID | 1 | 1 |

| 50 | AUTO_GENERATE_9_FT_ADDR | ID | 26 | 1 |

| 64 | AUTO_GENERATE_23_S03 | A | 1 | 1 |

+---------+--------------------------------------------------------+-------------+-------------+----------------+

6 rows in set (0.01 sec)

1. 水平分片表

水平分片表是指将表的数据按行以分片列的分片规则进行拆分，拆分后的分片数据存储不同的数据节点。数据量大的表适合定义为水平分片表。

· 水平分片表创建语法如下：

CREATE TABLE [IF NOT EXISTS] tbl_name SHARD BY {functionid | functionname} 'functionid | functionname' USING COLUMN 'shardcolumnname' （table define...）

CREATE TABLE [IF NOT EXISTS] tbl_name SHARD BY {functiontype} 'functiontype' USING COLUMN 'shardcolumnname' on datanode 'datanodeid' （table define...）

注：SHARD BY 之后的关键字也支持/* hotdb:020503*/注释的模式，如：

CREATE TABLE `a_vertical` /*hotdb:020503 shard by vertical on datanode'1'*/( id int not null auto_increment primary key, n set('','null','1','2','3'), KEY id (id)) ENGINE=InnoDB DEFAULT CHARSET==utf8mb4;

同时也可以将SHARD BY 之后的关键字放置表定义之后（垂直分片表、全局表亦同），示例：

CREATE TABLE [IF NOT EXISTS] tbl_name （table define...） SHARD BY {functiontype} 'functiontype' USING COLUMN 'shardcolumnname' on datanode 'datanodeid'(.....);

· 水平分片表创建语法说明：

¡ SHARD BY {FUNCTIONID | FUNCTIONNAME | FUNCTIONTYPE}：指分片函数ID、分片函数名称、分片函数类型的关键字。

¡ ' functionid_value | functionname_value | functiontype_value '：指具体的分片函数ID、分片函数名称、分片函数类型的值。

¡ USING COLUMN：指分片列的关键字。

¡ 'shardcolumnname'：指具体的分片列的列名。

¡ ON DATANODE：指数据节点的关键字。

¡ 'datanodeid'：指具体的数据节点的值，多个不连续的值可以用逗号间隔，多个连续的值可以使用区间形式指定，如:'1,3,4,5-10,12-40'。

(1) 登录服务端，切换逻辑库，输入建表语句并执行。

mysql> use fun_zy

Database changed

mysql> CREATE TABLE match1_tb shard by functionname 'test_match1' using column 'aname' (id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, adnid INT DEFAULT NULL, aname VARCHAR(32) DEFAULT '', adept VARCHAR(40), adate datetime DEFAULT NULL)ENGINE =INNODB;

Query OK, 0 rows affected (0.09 sec)

(2) 执行成功，管理平台会显示该表为已定义状态：

对于此语法规则建表，需要注意以下几点:

· 'functionid | functionname | functiontype'为具体指定的分片函数ID、分片函数名称、分片函数类型

· 'shardcolumnname' 为指定的分片字段

· 'datanodeid'为节点ID，可以逗号间隔，且支持区间形式指定，如:'1,3,4,5-10,12-40'，节点ID可登录分布式事务数据库可视化管理平台页面，选择“配置”->“节点管理”查看，也可以登录计算节点服务端口使用命令show hotdb datanodes;查看：

mysql> show hotdb datanodes;

+---------------+----------------+-----------------+

| datanode_id | datanode_name | datanode_type |

+---------------+----------------+-----------------+

| 9 | dn_01 | 0 |

| 11 | dn_02 | 0 |

| 13 | dn_03 | 0 |

| 15 | dn_04 | 0 |

| 19 | dn_failover | 0 |

| 20 | dn_rmb_01 | 0 |

+---------------+----------------+-----------------+

6 rows in set (0.00 sec)

· functiontype 只支持 auto_crc32/auto_mod, 若使用了其他类型会提示：ERROR:The fucntiontype can only be auto_crc32/auto_mod.

mysql> create table ft_match shard by functiontype 'match' using column 'id' on datanode '11,13'(id int(10) primary key, a char(20) not null);

ERROR 10070 (HY000): The functiontype can only by auto_crc32/auto_mode.

· 使用functionid | functionname建表时，当指定的function信息关联的function_type 是auto_crc32/auto_mod 时，需要指定on datanode 'datanodes' ，否则会提示：The function must be specified datanodes。如果是其他类型，则无需指定。

mysql> create table mod_ft shard by functionid '15' using column 'id'(id int(10) primary key, a char(20) not null);

ERROR 10090 (HY000): The function must be specified datanodes.

mysql> create table testsa shard by functionid '3' using column 'id'(id int,a int);

Query OK, 0 rows affected, 1 warning (0.10 sec)

mysql> CREATE TABLE match_tb shard by functionname 'test_match1' using column 'ananme' on datanode '1,2'(id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, adnid INT DEFAULT NULL, aname VARCHAR(32) DEFAULT '', adept VARCHAR(40), adate datetime DEFAULT NULL)ENGINE =INNODB;

ERROR 10090 (HY000): This rule doesn't need to specify a datanodes;

表结构类似的表可以使用相同的分片规则，使用如下语法可直接引用分片规则创建水平分片表：

CREATE TABLE [IF NOT EXISTS] tbl_name SHARD BY {ruleid | rulename} 'ruleid\rulename' [on datanode 'datanodes'] (......

登录计算节点服务端口使用命令，show hotdb rules;和show hotdb functions;可以看到与之分片函数关联的分片规则：

mysql> show hotdb rules;

+---------+--------------------------------------------------------+-------------+-------------+----------------+

+---------+--------------------------------------------------------+-------------+-------------+----------------+

| 17 | AUTO_GENERATE_3_ROUTE1_TB | A | 1 | 1 |

+---------+--------------------------------------------------------+-------------+-------------+----------------+

21 rows in set (0.01 sec)

mysql> show hotdb functions;

+-------------+---------------------+---------------+----------------+

+-------------+---------------------+---------------+----------------+

| 1 | test_route1 | ROUTE | 1 |

+-------------+---------------------+---------------+----------------+

13 rows in set (0.01 sec)

用户可用ruleid/rulename来直接创建表：

mysql> CREATE TABLE rt_table shard by ruleid '17'(id int not null auto_increment primary key,a int(10),b decimanl(5,2),c decimal(5,2),d date,e time(6),f timestamp(6) DEFAULT CURRENT_TIMESTAMP(6),g datetime(6) DEFAULT CURRENT_TIMESTAMP(6),h year,I char(20) charcter set utf8,j varchar(30) character set utf8mb4,k char(20) character set gbk,l text character set latin1, m enum('','null','1','2','3'),n set('','null','1','2','3'));

Query OK, 0 rows affected (0.07 sec)

对于此语法规则建表，需要注意以下几点：

· 当指定的rule关联的function_type是auto_crc32/auto_mod 时，需要指定on datanode 'datanodes'；如果是其他类型，则无需指定datanode。

mysql> show hotdb rules;

+---------+--------------------------------------------------------+-------------+-------------+----------------+

+---------+--------------------------------------------------------+-------------+-------------+----------------+

| 17 | AUTO_GENERATE_3_ROUTE1_TB | A | 1 | 1 |

+---------+--------------------------------------------------------+-------------+-------------+----------------+

21 rows in set (0.01 sec)

mysql> show hotdb functions;

+-------------+---------------------+---------------+----------------+

+-------------+---------------------+---------------+----------------+

| 1 | test_route1 | ROUTE | 1 |

+-------------+---------------------+---------------+----------------+

13 rows in set (0.01 sec)

mysql> CREATE TABLE route2_rptb1 shard by rulename 'AUTO_GENERATE_3_ROUTE1_TB' on datanode '9,11,13'(id int not null auto_increment primary key,a int(10),b decimanl(5,2),c decimal(5,2),d date,e time(6),f timestamp(6) DEFAULT CURRENT_TIMESTAMP(6),g datetime(6) DEFAULT CURRENT_TIMESTAMP(6),h year,i char(20) charcter set utf8,j varchar(30) character set utf8mb4,k char(20) character set gbk,l text character set latin1, m enum('','null','1','2','3'),n set('','null','1','2','3'));

ERROR 10090 (HY000): This rule doesn't need to specify a datanodes;

· 当指定的rule关联的function_type是auto_crc32/auto_mod 时，指定的datanode 个数与参数不符时，则会提示：ERROR:The total number of datanodes must be XXX（XXX为实际ruleid 关联的 function info的 column_value值）：

mysql> CREATE TABLE auto_c shard by ruleid '63' on datanode '9'(id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, adnid INT DEFAULT NULL, aname VARCHAR(32) DEFAULT '',adept VARCHAR(40), adate datetime DEFAULT NULL)ENGINE=INNODB;

ERROR 10090 (HY000): The total number of datanodes must be 2

mysql> CREATE TABLE auto_c shard by ruleid '63' on datanode '9,15'(id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, adnid INT DEFAULT NULL, aname VARCHAR(32) DEFAULT '',adept VARCHAR(40), adate datetime DEFAULT NULL)ENGINE=INNODB;

Query OK, 0 rows affected (0.13 sec)

2. 垂直分片表

垂直分片表是一个全局唯一且不分片的全量表，垂直分片表的全量数据仅存储在一个数据节点。

· 创建垂直分片表语法：

CREATE TABLE [IF NOT EXISTS] tbl_name SHARD BY vertical on datanode 'datanodeid'(.....

· 语法说明：

SHARD BY VERTICAL是垂直分片关键字，ON DATANODE 'datanodeid'只能指定一个数据节点，不指定数据节点或指定多个数据节点都会报错。

mysql> CREATE TABLE tb_vertical shard by vertical on datanode'9'( id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, adnid INT DEFAULT NULL, aname VARCAHR(32) DEFAULT '', adept VARCHAR(40), adate DATETIME DEFAULT NULL)ENGINE=INNODB;

Query OK, 0 rows affected(0.07 sec)

¡ 未指定datanode：

mysql> CREATE TABLE tb1_vertical shard by vertical( id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, adnid INT DEFAULT NULL, aname VARCAHR(32) DEFAULT '', adept VARCHAR(40), adate DATETIME DEFAULT NULL)ENGINE=INNODB;

ERROR 10090 (HY000): This table has to specify a datanodes.

¡ 指定多个节点：

mysql> CREATE TABLE tb1_vertical shard by vertical on datanode'9,11,13'( id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, adnid INT DEFAULT NULL, aname VARCAHR(32) DEFAULT '', adept VARCHAR(40), adate DATETIME DEFAULT NULL)ENGINE=INNODB;

ERROR 10090 (HY000): Can only specify one datanodes.

3. 全局表

全局表是指在该逻辑库下的所有数据节点中都存储的表，所有数据节点中该表的表结构和数据都完全一致。数据量小、不会频繁DML、经常与其他表发生JOIN 操作的表适合作为全局表。

· 创建全局表语法如下：

CREATE TABLE [IF NOT EXISTS] tbl_name SHARD BY global on datanode 'datanodeid'(.....

· 语法说明：

¡ SHARD BY GLOBAL：是全局表关键字。

¡ [ON DATANODE 'datanodeid']：是指定数据节点的语法。计算节点版本高于（包含）2.5.6时，不指定datanodeid则默认按逻辑库默认分片节点+逻辑库下所有表关联节点的并集建表；指定则必须包括全部数据节点，指定部分数据节点会报错。

mysql> CREATE TABLE tb_quan shard by global(id int not null auto_increment primary key,a int(10),b decimanl(5,2),c decimal(5,2),d date,e time(6),f timestamp(6) DEFAULT CURRENT_TIMESTAMP(6),g datetime(6) DEFAULT CURRENT_TIMESTAMP(6),h year,I char(20) null,j varchar(30),k blob,l text, m enum('','null','1','2','3'),n set('','null','1','2','3'));

Query OK, 0 rows affected (0.07 sec)

¡ 语法规则里的global是创建全局表的标志，'datanodeid'为节点ID，可以逗号间隔，且支持区间形式指定，如:'1,3,4,5-10,12-40'，使用该语法创建分片规则的全局表，该表的节点应该包括逻辑库下所有节点。

¡ 如果逻辑库下没有默认分片节点也没有已经定义的表，则使用特殊语法进行全局表的创建时，需要指定全局表分布的节点：

mysql> CREATE TABLE tb2_quan shard by global(id int not null auto_increment primary key,a int(10),b decimanl(5,2),c decimal(5,2),d date,e time(6),f timestamp(6) DEFAULT CURRENT_TIMESTAMP(6),g datetime(6) DEFAULT CURRENT_TIMESTAMP(6),h year,i char(20) null,j varchar(30),k blob,l text, m enum('','null','1','2','3'),n set('','null','1','2','3'));

ERROR 10090 (HY000): This table has to specify a datanodes.

¡ 如果逻辑库下存在已经定义的表，则可以不指定节点或指定节点的时候，需要为该逻辑库下包含节点的最大非重复个数（即所有表所选节点的并集），否则指定部分数据节点会提示建表错误：

mysql> CREATE TABLE tb1_quan shard by global on datanodes'9,11'(id int not null auto_increment primary key,a int(10),b decimanl(5,2),c decimal(5,2),d date,e time(6),f timestamp(6) DEFAULT CURRENT_TIMESTAMP(6),g datetime(6) DEFAULT CURRENT_TIMESTAMP(6),h year,i char(20) null,j varchar(30),k blob,l text, m enum('','null','1','2','3'),n set('','null','1','2','3'));

ERROR 10090 (HY000): The specified datanodes must cover all datanodes of the logical database.

4. 使用已有分片规则建表相关命令

此小节介绍的命令登录到计算节点服务端口、管理端口均可执行。

· show hotdb datanodes – 显示当前可用的节点：

此命令用于查看配置库中hotdb_datanodes表，语法：

mysql> show hotdb datanodes [LIKE 'pattern' | WHERE expr];

表12-1 命令包含参数及其说明：

参数	说明	类型
pattern	可选，模糊查询表达式，匹配datanode_name字段	STRING
expr	可选，where条件表达式	STRING

表12-2 结果包含字段及其说明：

列名	说明	值类型/范围
datanode_id	节点ID	INTEGER
datanode_name	节点名称	STRING
datanode_type	0：主备；1：MGR	INTEGER

例子：

mysql> show hotdb datanodes;

+-------------+---------------+---------------+

| datanode_id | datanode_name | datanode_type |

+-------------+---------------+---------------+

| 1 | dn_01 | 0 |

| 2 | dn_02 | 0 |

| 4 | dn_04 | 0 |

| 101 | dn_101 | 0 |

| 127 | dn_03 | 0 |

| 186 | dn_199 | 0 |

| 203 | dn_19 | 0 |

+-------------+---------------+---------------+

例子：

mysql> show hotdb datanodes like 'dn_0%';

+-------------+---------------+---------------+

| datanode_id | datanode_name | datanode_type |

+-------------+---------------+---------------+

| 1 | dn_01 | 0 |

| 2 | dn_02 | 0 |

| 4 | dn_04 | 0 |

| 127 | dn_03 | 0 |

+-------------+---------------+---------------+

· show hotdb functions – 显示当前可用的分片函数：

此命令用于查看配置库中hotdb_function表，语法：

mysql> showhotdb functions;

表12-3 命令包含参数及其说明：

参数	说明	类型
pattern	可选，模糊查询表达式，匹配function_name字段	STRING
expr	可选，where条件表达式	STRING

表12-4 结果包含字段及其说明：

列名	说明	值类型/范围
function_id	分片函数ID	INTEGER
function_name	分片函数名称	STRING
function_type	分片类型	STRING
auto_generated	是否为DRDS自动生成的配置(1:自动生成，其他：非自动生成)	INTEGER

例子：

mysql> show hotdb functions;

+-------------+---------------------+---------------+----------------+

+-------------+---------------------+---------------+----------------+

…省略更多…

| 40 | AUTO_CRC32_8 | AUTO_CRC32 | 0 |

| 41 | th_fun_range | RANGE | 0 |

| 42 | AUTO_MOD_5 | AUTO_MOD | 0 |

| 43 | 43_RANGE | RANGE | 0 |

| 44 | AUTO_CRC32_15 | AUTO_CRC32 | 0 |

| 45 | AUTO_CRC32_5 | AUTO_CRC32 | 0 |

| 46 | yds_RANGE | RANGE | 0 |

| 47 | AUTO_CRC32_11 | AUTO_CRC32 | 0 |

+-------------+---------------------+---------------+----------------+

例子：

mysql> show hotdb functions like '%range%';

+-------------+---------------+---------------+----------------+

+-------------+---------------+---------------+----------------+

| 41 | th_fun_range | RANGE | 0 |

| 43 | 43_RANGE | RANGE | 0 |

| 46 | yds_RANGE | RANGE | 0 |

+-------------+---------------+---------------+----------------+

3 rows in set (0.00 sec)

mysql> show hotdb functions where function_name like '%range%';

+-------------+---------------+---------------+----------------+

+-------------+---------------+---------------+----------------+

| 41 | th_fun_range | RANGE | 0 |

| 43 | 43_RANGE | RANGE | 0 |

| 46 | yds_RANGE | RANGE | 0 |

+-------------+---------------+---------------+----------------+

3 rows in set (0.00 sec)

· show hotdb function infos - 显示当前可用的分片函数信息：

此命令用于查看配置库中hotdb_function_info 表，语法：

mysql> show hotdb function infos [WHERE expr];

表12-5 命令包含参数及其说明：

参数	说明	类型
expr	可选，where条件表达式	STRING

表12-6 结果包含字段及其说明：

列名	说明	值类型/范围
function_id	分片函数ID	INTEGER
column_value	分片字段的值	STRING
datanode_id	数据节点id	INTEGER

例子：

mysql> show hotdb function infos;

+-------------+--------------+-------------+

| function_id | column_value | datanode_id |

+-------------+--------------+-------------+

| 2 | 4 | 0 |

| 3 | 1 | 0 |

| 4 | 2 | 0 |

| 31 | '' | 4 |

| 31 | 1 | 1 |

| 31 | 2 | 2 |

| 31 | null | 127 |

| 33 | 0:1 | 1 |

| 33 | 10:10 | 191 |

| 33 | 11:11 | 186 |

| 33 | 12 | 0 |

| 33 | 2:3 | 2 |

…省略更多…

例子：

mysql> show hotdb function infos where function_id=38;

+-------------+--------------+-------------+

| function_id | column_value | datanode_id |

+-------------+--------------+-------------+

| 38 | 10:12 | 1 |

| 38 | 1:2 | 1 |

| 38 | 20 | 0 |

| 38 | 4:8 | 1 |

+-------------+--------------+-------------+

4 rows in set (0.00 sec)

· show hotdb rules – 显示当前可用的分片规则：

此命令用于查看配置库中hotdb_rule 表，语法：

mysql> show hotdb rules [LIKE 'pattern' | WHERE expr];

表12-7 命令包含参数及其说明：

参数	说明	类型
pattern	可选，模糊查询表达式，匹配rule_name字段	STRING
expr	可选，where条件表达式	STRING

表12-8 结果包含字段及其说明：

列名	说明	值类型/范围
rule_id	分片规则ID	INTEGER
rule_name	分片规则名称	STRING
rule_column	分片字段名称	STRING
function_id	分片类型ID	INTEGER
auto_generated	是否为DRDS自动生成的配置(1:自动生成，其他：非自动生成)	INTEGER

例子：

mysql> show hotdb rules;

+---------+--------------------------------------------------------+-------------+-------------+----------------+

+---------+--------------------------------------------------------+-------------+-------------+----------------+

| 21 | AUTO_GENERATE_3_JOIN_A_JWY | ID | 1 | 1 |

| 22 | hotdb-cloud_0374c02e-58a7-4263-9b80-9c5b46fb42af | id | 5 | 0 |

| 25 | hotdb-cloud_f3979d19-93cb-4925-8dee-e4fbf8803c7c | id | 5 | 0 |

| 32 | hotdb-cloud_6ccd2f69-cf53-4e81-ab3d-61345134fb7a | id | 5 | 0 |

| 33 | hotdb-cloud_b5bc16e6-3481-40ed-83ff-e81d488e47a5 | ID | 4 | 0 |

…省略更多…

例子：

mysql> show hotdb rules like '%auto%';

+---------+----------------------------+-------------+-------------+----------------+

+---------+----------------------------+-------------+-------------+----------------+

| 21 | AUTO_GENERATE_3_JOIN_A_JWY | ID | 1 | 1 |

| 50 | AUTO_GENERATE_9_FT_ADDR | ID | 26 | 1 |

| 64 | AUTO_GENERATE_23_S03 | A | 1 | 1 |

| 65 | AUTO_GENERATE_23_S04 | B | 1 | 1 |

…省略更多…

mysql> show hotdb rules where rule_name like '%auto%';

+---------+----------------------------+-------------+-------------+----------------+

+---------+----------------------------+-------------+-------------+----------------+

| 21 | AUTO_GENERATE_3_JOIN_A_JWY | ID | 1 | 1 |

| 50 | AUTO_GENERATE_9_FT_ADDR | ID | 26 | 1 |

| 64 | AUTO_GENERATE_23_S03 | A | 1 | 1 |

| 65 | AUTO_GENERATE_23_S04 | B | 1 | 1 |

…省略更多…

12.5.3 暂时保留被删除的表数据

考虑到DROP TABLE、TRUNCATE TABLE 、DELETE TABLE 不带WHERE条件的语句在实际生产或线上环境执行时的较高风险，SeaSQL DRDS支持保留被DROP的表一段时间后再删除。其中，DELETE TABLE 不带WHERE条件的场景仅支持语句在自动提交的情况下可保留数据，事务内的操作暂无法保留数据。

可通过修改server.xml中的dropTableRetentionTime参数或在管理平台配置菜单下的计算节点参数配置中添加参数“被删除表保留时长(小时)”。

dropTableRetentionTime参数默认为0，表示不保留被删除的表数据，例如DROP TABLE立即会删除表无法瞬间恢复；dropTableRetentionTime大于0时，单位以小时计算，保留被删除的表数据到设置时长，超过设置时长后自动删除被保留的表。

计算节点暂不提供还原被删除的表的直接命令，但是用户可以在存储节点通过RENAME的方式还原被删除的表。因直接在存储节点上进行操作，故此操作存在风险，请谨慎使用。风险包括还原后数据路由可能与实际路由不同、原有的外健和触发器被删除、父子表关系不存在等，详细风险参考还原注意事项。

当该功能开启时，以dropTableRetentionTime=24为例，将保留被DROP的表，24小时后删除被保留的表。若想要还原被DROP的表，首先查询计算节点配置库中的hotdb_dropped_table_log，查看被DROP的表的映射关系。例如：

mysql> select * from hotdb_dropped_table_log;

+-------------+------------+----------------------+-------------------------------+

+-------------+------------+----------------------+-------------------------------+

| TABLE25 | 11 | 2019-03-26 17:18:07 | HOTDB_TEMP_33_20190326171807 |

| TABLE30 | 11 | 2019-03-26 17:18:13 | HOTDB_TEMP_34_20190326171812 |

+-------------+------------+----------------------+-------------------------------+

2 rows in set (0.00 sec)

其中，renamed_table_name即为保留被DROP的表的临时表，可以通过RENAME该临时表来还原数据。

RENAME TABLE tbl_name TO new_tbl_name

还原操作可以在对应的存储节点下分别RENAME临时表，也可以直接在计算节点下通过HINT语句RENAME临时表。使用HINT语句的操作说明及注意事项请参考此文档的HINT章节。

1. 还原注意事项

还原时需要注意以下要点：

· 通过管理平台配置后创建的表，可以直接RENAME成原表名。通过自动建表功能创建的表，DROP TABLE时不保留表配置，因此不能直接RENAME成原表名。

· 还原自动建表创建的表可以通过在管理平台上添加配置后RENAME成该表表名。也就是说，还原操作允许通过RENAME表名，将被删除的表还原成任何在管理平台上已配置但未定义的表。

· 若被删除的表引用的分片规则发生修改，或配置了不同的分片规则，还原后，数据不会按照新的分片规则自动迁移，即实际数据路由将与配置的路由不匹配。建议按照原来的分片规则配置还原，以防出现数据丢失或不一致的问题。

· 若被删除的表上存在外键或触发器，DROP TABLE时将会在临时表中删除外键与触发器。有外键约束的表因外键被删除，还原后没有相关约束，以及有可能表内数据已经不再满足相关约束。

· RENAME临时表的还原操作需要动态加载（reload）后才会生效。当前计算节点的动态加载功能在配置库有变更的情况下才生效，所以若除RENAME操作，配置库无其他变更，需要进行一些变更后，执行动态加载才会生效，生效后可查看到还原的表。

13 INFORMATION_SCHEMA

INFORMATION_SCHEMA库提供当前计算节点的信息与数据，例如数据库名称、表名称、某列的数据类型等。

此章节列出计算节点支持的INFORMATION_SCHEMA中的表与其特殊处理内容如下：

表名称	特殊处理
character_sets	仅返回计算节点支持的字符集与校对集数据
collations	仅返回计算节点支持的字符集与校对集数据
collation_character_set_applicability	仅返回计算节点支持的字符集与校对集数据
columns	返回逻辑库中表的列信息
column_privileges	返回空集
engines	仅返回innodb
events	返回空集
files	返回空集
global_status	与SHOW GLOBAL STATUS结果相同
global_variables	与SHOW GLOBAL VARIABLES结果相同
innodb_buffer_page	返回空集
innodb_buffer_page_lru	返回空集
innodb_buffer_pool_stats	返回空集
innodb_cmp	返回空集
innodb_cmpmem	返回空集
innodb_cmpmem_reset	返回空集
innodb_cmp_per_index	返回空集
innodb_cmp_per_index_reset	返回空集
innodb_cmp_reset	返回空集
innodb_ft_being_deleted	返回空集
innodb_ft_config	返回空集
innodb_ft_default_stopword	返回空集
innodb_ft_deleted	返回空集
innodb_ft_index_cache	返回空集
innodb_ft_index_table	返回空集
innodb_locks	返回空集
innodb_lock_waits	返回空集
innodb_metrics	返回空集
innodb_sys_columns	返回空集
innodb_sys_datafiles	返回空集
innodb_sys_fields	返回空集
innodb_sys_foreign	返回空集
innodb_sys_foreign_cols	返回空集
innodb_sys_indexes	返回空集
innodb_sys_tables	返回空集
innodb_sys_tablespaces	返回空集
innodb_sys_tablestats	返回空集
innodb_trx	返回空集
key_column_usage	返回索引的约束信息。
optimizer_trace	返回空集
parameters	返回空集
partitions	返回逻辑库中表的分区信息，可支持对该表进行排序、分组查询。
plugins	返回空集
processlist	返回的结果与服务端命令show processlist一致
profiling	返回空集
referential_constraints	返回逻辑库中表的外键信息
routines	返回空集
schemata	返回逻辑库相关信息
schema_privileges	返回空集
session_status	与SHOW SESSION STATUS结果相同
session_variables	与SHOW SESSION VARIABLES结果相同
statistics	返回逻辑库中表的索引统计信息
tables	返回逻辑库中表信息
tablespaces	返回空集
table_constraints	返回逻辑库中表的约束信息
table_privileges	返回空集
triggers	返回空集
user_privileges	返回空集
views	返回空集

为兼容MySQL版本高于8.0的存储节点，对于MySQL8.0新增的表做如下特殊处理：

表名称	特殊处理
check_constraints	返回CHECK约束信息
column_statistics	返回索引的直方图统计信息
keywords	返回空集
resource_groups	返回空集
st_geometry_columns	返回逻辑库中表的空间列信息
st_spatial_reference_systems	不做特殊处理
st_units_of_measure	不做特殊处理
view_table_usage	返回空集
view_routine_usage	返回空集

14 计算节点参数说明

计算节点使用过程中，维护了许多系统配置参数，本文描述这些参数如何使用以及对功能带来什么影响。每个参数都有一个默认值，可以在服务启动时在server.xml配置文件中修改，也可以登录管理平台在参数配置页面进行修改。这些参数大多数可以在运行时使用动态加载（reload @@config）操作动态更改，无需停止并重新启动服务。部分参数也可以使用set方式修改。

14.1 adaptiveProcessor

1. 参数说明

Property	Value
参数值	adaptiveProcessor
是否可见	隐藏不显示
参数说明	控制启动服务时是否自动适配
默认值	true
Reload是否生效	否
最低兼容版本	2.4.5

2. 参数设置

server.xml中adaptiveProcessor参数配置如下配置：

adaptiveProcessor参数默认为true，即开启自动适配，包括processor 、processorExecutor和timerExecutor 值都将自动适配。为false时则关闭自动适配。

3. 参数作用

开启自动适配后，计算节点会根据当前服务器配置和自动适配规则设定参数，即使在server.xml中对以下参数值进行配置，也不会生效，仍然会按照适配规则设置参数值。

(1) 登录3325端口，执行show @@threadpool;命令，查看当前processor、processorExecutor和timerExecutor值。例如：

mysql> show @@threadpool;

+-----------------+-----------+--------------+-----------------+----------------+------------+

+-----------------+-----------+--------------+-----------------+----------------+------------+

| TimerExecutor | 4 | 0 | 15 | 50376807 | 50376822 |

| $NIOExecutor-0- | 4 | 0 | 0 | 99254 | 99254 |

| $NIOExecutor-1- | 4 | 1 | 0 | 81195 | 81196 |

| $NIOExecutor-2- | 4 | 2 | 0 | 140921 | 140923 |

| $NIOExecutor-3- | 4 | 1 | 0 | 48218 | 48219 |

| $NIOExecutor-4- | 4 | 0 | 0 | 39073 | 39073 |

| $NIOExecutor-5- | 4 | 0 | 0 | 31656 | 31656 |

| $NIOExecutor-6- | 4 | 0 | 0 | 167007 | 167007 |

| $NIOExecutor-7- | 4 | 1 | 0 | 27221 | 27222 |

+-----------------+-----------+--------------+-----------------+----------------+------------+

9 rows in set (0.00 sec)

$NIOExecutor有0到7，表示当前processor=8，对应的pool_size为4，表示processorExecutor=4，TimerExecutor对应的pool_size为4，表示timerExecutor=4。

cat /proc/cpuinfo| grep "processor"| wc -l

注意：计算节点在刚刚启动时并不会生成所有线程，而是用多少创建多少，因此执行show @@threadpool;命令，可能会显示如下：

mysql> show @@threadpool;

+-----------------+-----------+--------------+-----------------+----------------+------------+

+-----------------+-----------+--------------+-----------------+----------------+------------+

| TimerExecutor | 4 | 0 | 14 | 73720 | 73734 |

| $NIOExecutor-0- | 1 | 0 | 0 | 1 | 1 |

| $NIOExecutor-1- | 1 | 0 | 0 | 1 | 1 |

| $NIOExecutor-2- | 1 | 0 | 0 | 1 | 1 |

| $NIOExecutor-3- | 1 | 0 | 0 | 1 | 1 |

| $NIOExecutor-4- | 2 | 0 | 0 | 2 | 2 |

| $NIOExecutor-5- | 5 | 0 | 0 | 5 | 5 |

| $NIOExecutor-6- | 1 | 0 | 0 | 1 | 1 |

| $NIOExecutor-7- | 1 | 1 | 0 | 1 | 1 |

+-----------------+-----------+--------------+-----------------+----------------+------------+

9 rows in set (0.00 sec)

直到计算节点受到足够压力时才会达到自动适配的值，也就是说，自动适配的值为最大值。

14.2 allowRCWithoutReadConsistentInXA

1. 参数说明

Property	Value
参数值	allowRCWithoutReadConsistentInXA
是否可见	否
参数说明	允许XA模式下使用不保证读写强一致性的RC隔离级别
默认值	0
Reload是否生效	是
最低兼容版本	2.4.9

2. 参数设置

Server.xml中allowRCWithoutReadConsistentInXA参数配置如下配置：

3. 参数作用

默认XA模式下只能选择REPEATABLE READ、SERIALIZABLE两种隔离级别。

· 当计算节点版本低于2.5.3.1时，参数allowRCWithoutReadConsistentInXA设置为0，XA模式下不允许使用READ COMMITTED隔离级别；设置为1时，XA模式下允许使用READ COMMITTED隔离级别，以及可修改会话隔离级别为READ COMMITTED，但须注意此时READ COMMITED隔离级别实质介于READ COMMITED和READ UNCOMMITED之间，不保证读写强一致性。

· 当计算节点版本高于（包含）2.5.3.1时，若参数allowRCWithoutReadConsistentInXA设置成0，XA模式下允许使用保证事务读写一致性的READ COMMITTED隔离级别，其行为等同于MySQL（但须注意原SQL涉及跨库查询被拆分多条语句多次查询时，会不停读到最新事务，故该模式下需尽量使用单库查询）；若参数allowRCWithoutReadConsistentInXA设置成1，也允许XA模式下使用READ COMMITTED隔离级别，但是不能保证事务读写一致性，隔离级别实质介于READ COMMITED和READ UNCOMMITED之间，其性能优于设置成0的情况，且启动和同步加载时时会有日志提示，如下

2020-03-12 15:36:03.719 [WARN][INIT][main] cn.hotpu.hotdb.a(519) – Note that the READ COMMITTED isolation level in XA mode is essentially between READ COMMITTED and READ UNCOMMITTED at this time, which does not guarantee strong consistency of reading and writing.

14.3 allowReadConsistentInReadOnly

1. 参数说明

Property	Value
参数值	allowReadConsistentInReadOnly
是否可见	是
参数说明	开启实例级别只读后，是否保证读一致性
默认值	false
Reload是否生效	是
最低兼容版本	2.5.7

2. 参数设置

server.xml中allowReadConsistentInReadOnly参数配置：

3. 参数作用

控制开启实例级别只读后，是否保证读一致性。默认为0，不保证读一致性；若为1，则在多计算节点集群模式下enableListener和enableXA参数启用且部署了监听组件后，可保证读一致性。

14.4 autoIncrement

1. 参数说明

Property	Value
参数值	autoIncrement
是否可见	是
参数说明	· 2.5.4以下版本代表：是否采用全局自增序列 · 2.5.4及以上版本代表：全局自增序列模式
默认值	1
Reload是否生效	是
最低兼容版本	2.4.3

2. 参数作用

控制表的自增序列是否可以在分布式环境下全局自增，功能参见具体全局自增章节描述。在2.5.4及以上版本，该参数设置范围为：0、1、2、3、4；

在2.5.3及以下版本，只能设置为true或false。设置为true等同于设置为1；设置为false等同于设置为0。

14.5 badConnAfterContinueGet

1. 参数说明

Property	Value
参数值	badConnAfterContinueGet
是否可见	否
参数说明	是否继续获取连接
默认值	true
Reload是否生效	是
最低兼容版本	2.4.3

2. 参数设置

3. 参数作用

计算节点从连接池获取连接后时，如果进行了连接有效性检验并获取到了一个失效的连接，当该参数为true，连接池将继续获取可用连接，为false，连接池将返回null，由外部代码逻辑继续进行处理。

14.6 badConnAfterFastCheckAllIdle

1. 参数说明

Property	Value
参数值	badConnAfterFastCheckAllIdle
是否可见	否
参数说明	当获取坏的后端连接时，是否快速检测所有空闲连接
默认值	true
Reload是否生效	是
最低兼容版本	2.4.3

2. 参数设置

3. 参数作用

当获取到坏的后端连接，计算节点连接池是否快速检测全部的空闲连接。

14.7 bakUrl & bakUsername & bakPassword

1. 参数说明

Property	Value
参数值	bakUrl
是否可见	是
参数说明	从配置库地址
默认值	jdbc:mysql://127.0.0.1:3306/hotdb_config
Reload是否生效	是
最低兼容版本	2.4.4

Property	Value
参数值	bakUsername
是否可见	是
参数说明	从配置库用户名
默认值	hotdb_config
Reload是否生效	是
最低兼容版本	2.4.4

Property	Value
参数值	bakPassword
是否可见	是
参数说明	从配置库密码
默认值	hotdb_config
Reload是否生效	是
最低兼容版本	2.4.4

2. 参数作用

bakUrl和bakUsername以及bakPassword属于配套参数，用于配置库高可用功能。若使用配置库高可用，则需要设置为对应从配置库的信息且保证主从配置库实例的复制关系正常，且互为主备，当主配置库发生故障时会自动切换到从配置库。

切换过程中，若存在复制延迟，会等待从配置库复制延迟追上后切换并提供服务。

若不需要主备配置库，则这里配置为跟主配置库信息一致或不配置从配置库即可。

<property name="bakUrl">jdbc:mysql://192.168.210.31:3306/hotdb_config</property>

<property name="bakUsername">hotdb_config</property>

<property name="bakPassword">hotdb_config</property>

当配置库因主库故障发生切换后，主库恢复正常且检测过数据主从一致，此时可恢复主备配置库重新到可切换状态，需要将配置库里的houdb_config_info表里k字段为hotdb_master_config_status这一行的v值从0更新为1，并在管理端执行reload @@config，才会重新使用主配置库（使用管理平台启用主配置库的操作方法请参考《H3C SeaSQL DRDS 管理平台用户手册》）。

mysql> select * from hotdb_config_info\G

***************************1.row**************************

k: hotdb_master_config_status

v: 1

description: NULL

14.8 checkConnLastUsedTime

1. 参数说明

Property	Value
参数值	checkConnLastUsedTime
是否可见	否
参数说明	后端连接最后一次使用最大允许间隔时间，超过将校验该连接是否有效单位：毫秒
默认值	3000
最小值	0
最大值	600000
Reload是否生效	是
最低兼容版本	2.4.3

2. 参数设置

<property name="checkConnLastUsedTime">false</property>

3. 参数作用

后端连接超过此参数配置的时长没有被使用过，计算节点从连接池获取连接时会先校验该连接的连通性，保证获取到的连接可用。

mysql> show @@session;

+-------+---------+-------------+----------+-----------+----------+---------+---------+-------+------------+----------+-----------+---------------+---------+---------+-------+----------+-------------------+--------------------+

1 row in set (0.00 sec)

14.9 CheckConnValid

1. 参数说明

Property	Value
参数值	CheckConnValid
是否可见	否
参数说明	是否检查后端连接有效
默认值	true
Reload是否生效	是
最低兼容版本	2.4.3

2. 参数设置

server.xml中手动添加一条CheckConnValid的配置：

3. 参数作用

从连接池获取连接的时候检查连接的可用性，如有不可用的连接会关闭连接，从连接池清除。

14.10 checkConnValidTimeout

1. 参数说明

Property	Value
参数值	checkConnValidTimeout
是否可见	否
参数说明	后端连接有效校验时，最大超时时间单位：毫秒
默认值	500
Reload是否生效	是
最低兼容版本	2.4.3

2. 参数设置

3. 参数作用

后端连接有效校验时，当检测时间超过“后端连接超时时间”，则判断为无效的连接，当检测后端连接属于超时连接时，会把该连接从连接池中清除。

14.11 checkMySQLParamInterval

1. 参数说明

Property	Value
参数值	checkMySQLParamInterval
是否可见	否
参数说明	检查MySQL参数设置间隔时间（单位:毫秒）
默认值	600000
最小值	1000
最大值	86400000
Reload是否生效	2.4.5版本为N， 2.4.7及以上为Y
最低兼容版本	2.4.3

2. 参数设置

3. 参数作用

检查MySQL参数设置是否合理的间隔时间。其中，检查参数包括：completion_type、innodb_rollback_on_timeout、div_precision_increment、autocommit、read_only、tx_isolation、max_allowed_packet。

14.12 checkUpdate

1. 参数说明

Property	Value
参数值	checkUpdate
是否可见	否
参数说明	是否拦截对分片字段的更新操作
默认值	true
Reload是否生效	是
最低兼容版本	2.4.3

2. 参数作用

控制是否允许修改分片字段。非特殊情况，建议不要修改该参数，否则可能导致数据路由与配置的分片规则不相符，影响查询结果。

· 设置为true的情况，同节点内可以更新，不能更新分片字段路由到不同节点的，如跨节点分片字段更新会有如下提示：

mysql> update ss set id=13 where a='aa';

ERROR 10217 (HY000): update sharding column's value can't change dn.

· 设置为false的情况，更新分片字段可以随意更新。

mysql> update ss set id=13 where a='aa';

Query OK, 1 row affected (0.01 sec)

Rows matched: 1 Changed: 1 Warnings: 0

mysql> select * from ss where a='aa';

+------+------+

| id | a |

+------+------+

| 13 | aa |

+------+------+

1 row in set (0.00 sec)

注意：对于insert on duplicate key update语句，参数为true时，不可以更新子表关联字段；参数为false时，可以更新路由到同一数据节点下子表关联字段。

· 参数为ture，不可以更新子表关联字段：

[email protected]:zjj_db1 5.7.25 04:47:53> insert into dpc1 values(3,3,'fsef') on duplicate key update id=1;

ERROR 10041 (HY000): forbidden operation:INSERT IGNORE ... ON DUPLICATE KEY UPDATE on a sharding key

· 参数为false，可以更新子表关联字段：

[email protected]:zjj_db1 5.7.25 04:41:24> insert into dpc1 values(3,3,'fwefwe') on duplicate key update id=1;

Query OK, 2 rows affected (0.00 sec)

· 不论参数是否开启，全局唯一约束字段均不能更新：

[email protected]:zjj_db1 5.7.25 05:42:53> insert into dpl1 values(3,3,'fssfds') on duplicate key update id1=1;

ERROR 10041 (HY000): forbidden operation:INSERT IGNORE ... ON DUPLICATE KEY UPDATE

14.13 clientFoundRows

1. 参数说明

Property	Value
参数值	clientFoundRows
是否可见	否
参数说明	用found rows代替OK包中的affected rows
默认值	false
Reload是否生效	是
最低兼容版本	2.4.9 （2.5.5版本废弃）

2. 参数设置

server.xml中clientFoundRows参数配置如下配置：

<property name=" clientFoundRows ">false</property>

3. 参数作用

在2.5.5版本以下时，该参数用于操作SQL语句时判断语句的执行情况，若客户端连接使用了useAffectedRows参数，设置clientFoundRows=false ，update返回的是实际影响行数；设置clientFoundRows=true，update返回的是匹配行数；在2.5.5 及以上版本计算节点服务支持了自适应，即客户端连接使用了useAffectedRows参数则会以客户端设置为准，该参数废弃。

如：jdbc传入useAffectedRows=false，返回匹配行数

jdbc传入useAffectedRows=true，返回影响行数

14.14 clusterElectionTimeoutMs

1. 参数说明

Property	Value
参数值	clusterElectionTimeoutMs
是否可见	否
参数说明	集群选举超时时间(ms)
默认值	2000
Reload是否生效	是
最低兼容版本	2.5.3

2. 参数设置

server.xml中clusterElectionTimeoutMs参数配置如下配置：

3. 参数作用

该参数用于设置计算节点集群选举超时时间，一般不建议修改，可根据实际网络质量情况进行适度调整。例如将参数clusterElectionTimeoutMs设置为2000ms，则集群中的主计算节点发生故障后，新的候选节点会在超时时间内一直等待选举，直至选举成功或超过2000ms选举失败。

14.15 clusterHeartbeatTimeoutMs

1. 参数说明

Property	Value
参数值	clusterHeartbeatTimeoutMs
是否可见	否
参数说明	集群心跳超时时间(ms)
默认值	5000
Reload是否生效	是
最低兼容版本	2.5.3

2. 参数设置

server.xml中clusterHeartbeatTimeoutMs参数配置如下配置：

3. 参数作用

该参数用于设置计算节点集群心跳超时时间，一般不建议修改，可根据实际网络质量情况进行适度调整。

14.16 clusterHost

1. 参数说明

Property	Value
参数值	clusterHost
是否可见	是
参数说明	本节点所在IP
默认值	192.168.200.1
Reload是否生效	否
最低兼容版本	2.5.0

2. 参数设置

Server.xml中clusterHost参数配置如下配置：

3. 参数作用

该参数需设置和实际计算节点所在的IP一致（不能用127.0.0.1代替），集群选举时该计算节点用于与其他计算节点通信的地址。

14.17 clusterName

1. 参数说明

Property	Value
参数值	clusterName
是否可见	是
参数说明	集群组名称
默认值	DRDS-Cluster
Reload是否生效	否
最低兼容版本	2.5.0

2. 参数设置

Server.xml中clusterName参数配置如下配置：

<property name=" HotDB-Cluster ">DRDS-Cluster </property>

3. 参数作用

指定集群启动后加入的组名称，同一个集群内的计算节点的该参数必须相同，不同集群的计算节点的该参数必须设置不同。

14.18 clusterNetwork

1. 参数说明

Property	Value
参数值	clusterNetwork
是否可见	是
参数说明	集群所在网段
默认值	192.168.200.0/24
Reload是否生效	否
最低兼容版本	2.5.0

2. 参数设置

Server.xml中clusterNetwork参数配置如下配置：

3. 参数作用

该参数为整个集群所在的网段，限定集群内的所有计算节点IP必须在该网段内。否则即使集群组相同启动后也不会加入集群。

14.19 clusterPacketTimeoutMs

1. 参数说明

Property	Value
参数值	clusterPacketTimeoutMs
是否可见	否
参数说明	集群间通讯包失效时间(ms)
默认值	5000
Reload是否生效	是
最低兼容版本	2.5.3

2. 参数设置

Server.xml中clusterPacketTimeoutMs参数配置如下配置：

3. 参数作用

该参数用于设置集群间通讯包失效时间，一般不建议修改，可根据实际网络质量情况进行适度调整。集群间通讯包指在集群正常运行时需要发送的所有点对点的通讯包，包括且不限于心跳、选举、成员变更等数据包。

14.20 clusterPort

1. 参数说明

Property	Value
参数值	clusterPort
是否可见	是
参数说明	集群通信端口
默认值	3326
Reload是否生效	否
最低兼容版本	2.5.0

2. 参数设置

Server.xml中clusterPort参数配置如下配置：

3. 参数作用

默认值3326，指定监听集群信息的端口。该参数用于集群内通讯，同一集群通信的端口必须相同。

14.21 clusterRole

1. 参数说明

Property	Value
参数值	clusterRole
是否可见	是
参数说明	计算节点集群当前角色
默认值	0
Reload是否生效	否
最低兼容版本	2.5.6

2. 参数设置

Server.xml中clusterRole参数配置如下配置：

3. 参数作用

目前集群模式下的计算节点，如果宕机到最后一个计算节点故障之前，其他计算节点若均是一起故障（不是先后故障），则整个集群可能都是故障状态。为了减少发生这类问题的概率，新增了clusterRole参数，该参数为计算节点在集群内的角色配置参数，配置为0代表普通角色、配置为1代表仅参与选举投票的角色。仅参与选举投票的角色在成为集群内最后一个节点前不提供服务，可将其单独与实际集群计算节点配置在同一集群内，可保证集群内只要计算节点多数存活即可提供服务。

14.22 clusterSize

1. 参数说明

Property	Value
参数值	clusterSize
是否可见	是
参数说明	集群中节点总数
默认值	3
Reload是否生效	否
最低兼容版本	2.5.0

2. 参数设置

Server.xml中clusterSize参数配置如下配置：

3. 参数作用

该参数为集群内计算节点的总个数，若haMode设置为1（即集群模式），需配置成该集群的实际计算节点数。

14.23 clusterStartedPacketTimeoutMs

1. 参数说明

Property	Value
参数值	clusterStartedPacketTimeoutMs
是否可见	否
参数说明	集群Started广播包失效时间(ms)
默认值	5000
Reload是否生效	是
最低兼容版本	2.5.3

2. 参数设置

Server.xml中clusterStartedPacketTimeoutMs参数配置如下配置：

3. 参数作用

该参数用于设置集群Started广播包失效时间，一般不建议修改，可根据实际网络质量情况进行适度调整。集群Started广播包是指在集群启动时的一个针对网段广播的包。

14.24 columnPrivilegeDenied

1. 参数说明

Property	Value
参数值	columnPrivilegeDenied
是否可见	隐藏
参数说明	控制表中的列拒绝权限，优先级高于其他权限
默认值	（空）
Reload是否生效	是
最低兼容版本	2.5.5

2. 参数设置

<property name="columnPrivilegeDenied">列拒绝权限内容</property>

3. 内容格式

‘user_name’@‘host_name’.logicDB.tableName[privilegeType(columnName,columnName)];‘user_name’@‘host_name’.logicDB.tableName[privilegeType(columnName,columnName),privilegeType(columnName,columnName)];....

4. 详细说明

· ‘user_name'@‘host_name'：由用户名+主机名组成，可以填写具体用户（例如‘zhangsan'@‘127.0.0.1'或‘lisi'@‘%'或‘wangwu'@‘192.168.210.129'），也可以填写*（代表所有用户）；

· logicDB：逻辑库名，可以填写具体逻辑库（例如hotdb），也可以填写*（代表所有逻辑库）；

· tableName：表名，可以具体表（例如sbtest1），也可以填写*（代表所有表）；

· privilegeType：权限类型，列权限目前可控制类型包括：INSERT,SELECT,UPDATE（不区分大小写），可以只填写一种权限类型，也可以填写多种权限类型，两种权限类型之间用,隔开；

· columnName：列名，若是主键字段可以使用“_PRIMARY_” 代替，若是唯一键字段可以使用“_UNIQUE_”代替。同一个权限类型下可以只填写一个列名，也可以填写多个列名，两个列名之间用,隔开；

· 为了保证能够被识别和分类，采用.[](),;符号间隔；

· 当配置的列拒绝权限生效后，执行SQL涉及被控制的列时，不符合权限要求的有错误提示，同时hotdb.log会输出相应日志信息；

· 用户可通过服务端口执行show grants查看被拒绝的列权限类型；

示例1：

不允许用户‘ztm'@‘192.168.210.129'对逻辑库d1中sbtest1表的c列有select权限

(1) 以OLTP场景标准表sbtest1为例，则可配置：

<property name="columnPrivilegeDenied">'ztm'@'192.168.210.129'.d1.sbtest1[select(c)]</property>

(2) 动态加载成功后，立即生效，在服务端口执行sql验证：

[email protected]:(none) 5.7.25 01:37:23> use d1

Database changed

[email protected]:d1 5.7.25 02:20:37> select c from sbtest1;

ERROR 1143 (HY000): SELECT command denied to user 'ztm'@'192.168.210.129' for column 'c' in table 'sbtest1'

[email protected]:d1 5.7.25 02:22:33> show grants for 'ztm'@'192.168.210.129';

+-----------------------------------------------------------+

| Grants for ztm |

+-----------------------------------------------------------+

| 'ztm'@'192.168.210.129'.d1.sbtest1[select(c)] |

+-----------------------------------------------------------+

(3) 此时hotdb.log会输出相应内容：

2021-06-25 14:22:33.465 [INFO] [SQL] [$NIOExecutor-1-2] cn.hotpu.hotdb.server.b(1140) - Error in SQL:[select c from sbtest1] from connection:[[thread=$NIOExecutor-1-2,id=702,user=ztm,host=192.168.210.129,port=3323,localport=47832,schema=D1,[{_os:linux-glibc2.12}, {_client_name:libmysql}, {_pid:32094}, {_client_version:5.7.25}, {_platform:x86_64}, {program_name:mysql}]]] cn.hotpu.hotdb.b.c: 1143: SELECT command denied to user 'ztm'@'192.168.210.129' for column 'c' in table 'sbtest1'

2021-06-25 14:22:33.466 [INFO] [HOTDBERROR] [Unusual-Logger-1] cn.hotpu.hotdb.server.b(286) - sql: select c from sbtest1, err: SELECT command denied to user 'ztm'@'192.168.210.129' for column 'c' in table 'sbtest1' from connection [thread=Unusual-Logger-1,id=702,user=ztm,host=192.168.210.129,port=3323,localport=47832,schema=D1,[{_os:linux-glibc2.12}, {_client_name:libmysql}, {_pid:32094}, {_client_version:5.7.25}, {_platform:x86_64}, {program_name:mysql}]]

示例2：

不允许用户‘ztm'@‘%'对逻辑库d1中sbtest1表主键所在列有select、insert、update权限。

(4) 以OLTP场景标准表sbtest1为例，则可配置：

<property name="columnPrivilegeDenied">'ztm'@'%'.d1.sbtest1[select(id),insert(_primary_),update(_unique_)]</property>

(5) 由于sbtest1表中id既是主键，也是唯一键，故可以使用_primary_或者_unique_来表示。动态加载成功后，立即生效，在服务端口执行sql验证：

[email protected]:(none) 5.7.25 01:47:10> use d1

Database changed

[email protected]:d1 5.7.25 01:47:17> select id from sbtest1;

ERROR 1143 (HY000): SELECT command denied to user 'ztm'@'%' for column 'id' in table 'sbtest1'

[email protected]:d1 5.7.25 01:47:49> insert into sbtest1(id) values(1000);

ERROR 1143 (HY000): INSERT command denied to user 'ztm'@'%' for column 'id' in table 'sbtest1'

[email protected]:d1 5.7.25 01:48:16> update sbtest1 set id=id+1 where k=1;

ERROR 1143 (HY000): UPDATE command denied to user 'ztm'@'%' for column 'id' in table 'sbtest1'

示例3：

不允许用户‘ztm'@‘127.0.0.1'对逻辑库d1中sbtest1表所有列有select、insert、update权限，不允许用户‘root'@‘%'对逻辑库d2中sbtest4表所有列有select、insert、update权限，不允许用户‘ztm'@‘192.168.210.129'对逻辑库d3中sbtest8表所有列有select、insert、update权限

(6) 以OLTP场景标准表sbtest1~sbtest10为例，则可配置：

<property name="columnPrivilegeDenied">'ztm'@'127.0.0.1'.d1.sbtest1[select(id,k,c,pad),insert(_primary_,k,c,pad),update(_unique_,k,c,pad)];'root'@'%'.d2.sbtest4[select(id,k,c,pad),insert(_primary_,k,c,pad),update(_unique_,k,c,pad)];'ztm'@'192.168.210.129'.d3.sbtest8[select(id,k,c,pad),insert(_primary_,k,c,pad),update(_unique_,k,c,pad)]</property>

(7) 由于sbtest1表中id既是主键，也是唯一键，故可以使用_primary_或者_unique_来表示。动态加载成功后，立即生效，在服务端口执行sql验证：

[email protected]:(none) 5.7.25 02:01:10> use d2

Database changed

[email protected]:d2 5.7.25 02:01:20> select id from sbtest4;

ERROR 1143 (HY000): SELECT command denied to user 'root'@'%' for column 'id' in table 'sbtest4'

[email protected]:d2 5.7.25 02:01:25> select k from sbtest4;

ERROR 1143 (HY000): SELECT command denied to user 'root'@'%' for column 'k' in table 'sbtest4'

[email protected]:d2 5.7.25 02:01:43> select c from sbtest4;

ERROR 1143 (HY000): SELECT command denied to user 'root'@'%' for column 'c' in table 'sbtest4'

[email protected]:d2 5.7.25 02:01:47> select pad from sbtest4;

ERROR 1143 (HY000): SELECT command denied to user 'root'@'%' for column 'pad' in table 'sbtest4'

[email protected]:d2 5.7.25 02:01:52> insert into sbtest4 values(10000,88,uuid(),uuid());

ERROR 1143 (HY000): INSERT command denied to user 'root'@'%' for column 'id' in table 'sbtest4'

[email protected]:d2 5.7.25 02:02:16> insert into sbtest4(id) values(10000);

ERROR 1143 (HY000): INSERT command denied to user 'root'@'%' for column 'id' in table 'sbtest4'

[email protected]:d2 5.7.25 02:02:44> insert into sbtest4(k) values(88);

ERROR 1143 (HY000): INSERT command denied to user 'root'@'%' for column 'k' in table 'sbtest4'

[email protected]:d2 5.7.25 02:02:53> insert into sbtest4(c) values(uuid());

ERROR 1143 (HY000): INSERT command denied to user 'root'@'%' for column 'c' in table 'sbtest4'

[email protected]:d2 5.7.25 02:03:02> insert into sbtest4(pad) values(uuid());

ERROR 1143 (HY000): INSERT command denied to user 'root'@'%' for column 'pad' in table 'sbtest4'

示例4：

不允许所有用户对所有逻辑库中所有表pad列有select、insert、update权限

(8) 以OLTP场景标准表sbtest1~sbtest10为例，则可配置：

<property name="columnPrivilegeDenied">*.*.*[select(pad),insert(pad),update(pad)]</property>

(9) 动态加载成功后，立即生效，在服务端口执行sql验证：

[email protected]:(none) 5.7.25 02:09:01> use d1;

Database changed

[email protected]:d1 5.7.25 02:09:11> select pad from sbtest1;

ERROR 1143 (HY000): SELECT command denied to user 'ztm'@'192.168.210.129' for column 'pad' in table 'sbtest1'

[email protected]:d1 5.7.25 02:09:21> select pad from sbtest2;

ERROR 1143 (HY000): SELECT command denied to user 'ztm'@'192.168.210.129' for column 'pad' in table 'sbtest2'

[email protected]:d1 5.7.25 02:09:25> select pad from sbtest3;

ERROR 1143 (HY000): SELECT command denied to user 'ztm'@'192.168.210.129' for column 'pad' in table 'sbtest3'

[email protected]:d1 5.7.25 02:09:28> select pad from d2.sbtest4;

ERROR 1143 (HY000): SELECT command denied to user 'ztm'@'192.168.210.129' for column 'pad' in table 'sbtest4'

[email protected]:d1 5.7.25 02:09:40> insert into sbtest3(pad) values(uuid());

ERROR 1143 (HY000): INSERT command denied to user 'ztm'@'192.168.210.129' for column 'pad' in table 'sbtest3'

[email protected]:d1 5.7.25 02:10:07> update sbtest2 set pad=uuid() where id=1;

ERROR 1143 (HY000): UPDATE command denied to user 'ztm'@'192.168.210.129' for column 'pad' in table 'sbtest2'

14.25 configMGR & bak1Url & bak1Username & bak1Password

1. 参数说明

Property	Value
参数值	configMGR
是否可见	是
参数说明	配置库是否使用MGR
默认值	false
Reload是否生效	是
最低兼容版本	2.5.0

Property	Value
参数值	bak1Url
是否可见	是
参数说明	MGR配置库地址
默认值	空
Reload是否生效	是
最低兼容版本	2.5.0

Property	Value
参数值	bak1Username
是否可见	是
参数说明	MGR配置库用户名
默认值	空
Reload是否生效	是
最低兼容版本	2.5.0

Property	Value
参数值	bak1Password
是否可见	是
参数说明	MGR配置库密码
默认值	空
Reload是否生效	是
最低兼容版本	2.5.0

2. 参数作用

configMGR和bak1Url和bak1Username以及bak1Password属于配套参数，用于MGR配置库功能。若使用MGR配置库，则需要设置为对应MGR配置库的信息且保证MGR配置库实例的复制关系正常，且互为MGR，当主配置库发生故障时会自动切换到新的主配置库。MGR配置库最多支持3个。

<property name="bak1Url">jdbc:mysql://192.168.210.32:3306/hotdb_config</property>

<property name="bak1Username">hotdb_config</property>

<property name="bak1Password">hotdb_config</property>

14.26 crossDbXa

1. 参数说明

Property	Value
参数值	crossDbXa
是否可见	否
参数说明	跨逻辑库是否采用XA事务
默认值	false
Reload是否生效	否
最低兼容版本	2.5.5

2. 参数设置

server.xml中crossDbXa参数如下配置：

<property name="crossDbXa">false</property>

3. 参数作用

开启enableXA时，如果存在跨逻辑库查询的XA事务，需要开启crossDbXa才能保证强一致性。当crossDbXa未开启时也可以支持，但不保证数据的强一致，且事务内加入新节点，查询会报错。以下四个场景举例说明：

数据准备

· 开启XA

· 逻辑库A，默认节点为1，2；逻辑库B，默认节点为2,3,4

· 逻辑库A创建表a；逻辑库B创建表b；两张表的表结构一致

· 表a中插入1000条数据；表b无数据

场景一、crossDbXa 关闭时，不保证数据强一致

(1) 开启一个session，执行如下SQL：

use A;

begin;insert into B.b select * from A.a;commit;

use B;

begin;delete from b;commit;

两个事务反复交替执行，无间隔时间；

(2) 开启另外一个session，反复执行：

use A;

select count(*) from B.b;

(3) 结果：Count (*)得出的结果不一定全为0或1000

场景二、crossDbXa 开启时，保证数据强一致：

(1) 开启一个session，执行如下SQL：

use A;

begin;insert into B.b select * from A.a;commit;

use B;

begin;delete from b;commit;

两个事务反复交替执行，无间隔时间；

(2) 开启另外一个session，反复执行：

use A;

select count(*) from B.b;

(3) 结果：Count (*)得出的结果为0或1000

场景三、crossDbXa 关闭时，事务内加入节点会报错：

(1) 开启一个session，执行如下SQL：

use A;

begin;

select * from A.a;

select * from B.b;

(2) 结果：select * from B.b;执行会报错

场景四、crossDbXa 开启时，事务内加入节点正常执行：

(1) 1. 开启一个session，执行如下SQL：

use A;

begin;select * from A.a;select * from B.b;

(2) 结果：select * from B.b;正常执行

14.27 cryptMandatory

1. 参数说明

Property	Value
参数值	cryptMandatory
是否可见	是
参数说明	是否强制加密密码
默认值	False
Reload是否生效	是
最低兼容版本	2.4.3

2. 参数设置

<property name="cryptMandatory">false</property>

3. 参数作用

用于设置计算节点是否可以读取加密后的存储节点密码。

· True状态：

¡ 存储节点密码为明文的时候，计算节点会无法连接该存储节点

¡ 存储节点密码为密文的时候，计算节点能够连接该存储节点

· False状态：

¡ 存储节点密码为明文的时候，计算节点能够连接该存储节点

¡ 存储节点密码为密文的时候，计算节点能够连接该存储节点

14.28 dataNodeIdleCheckPeriod

1. 参数说明

Property	Value
参数值	dataNodeIdleCheckPeriod
是否可见	是
参数说明	数据节点默认空闲检查时间（秒）
默认值	120
最小值	1
最大值	3600
Reload是否生效	· 2.4.5版本为N， · 2.4.7及以上为Y
最低兼容版本	2.4.3

2. 参数设置

3. 参数作用

用于设置数据节点空闲检查的定时任务的时间。

计算节点会定时检查后端存储节点连接情况，关闭多余的空闲连接或者补足连接池的可用连接，保持连接不被MySQL关闭，维护连接池的正常运作。

例如：在3323服务端口进行大并发的插入操作，在3325管理端口执行Show @@backend监控后端连接数量，大并发操作执行完毕以后，当计算节点检测到数据节点有超过配置数量的处于空闲的后端连接，计算节点会去清理掉这些连接。

14.29 deadlockCheckPeriod

1. 参数说明

Property	Value
参数值	deadlockCheckPeriod
是否可见	是
参数说明	死锁检测周期（毫秒），0代表不启用
默认值	3000
最小值	0
最大值	100000
Reload是否生效	· 2.4.5版本为N， · 2.4.7及以上为Y
最低兼容版本	2.4.3

2. 参数作用

· 开启死锁检测时，会根据设置的周期定时检测跨库死锁。如果发现跨库死锁，会杀掉其中trx_weight最小的事务。

mysql> select * from autoi where id=4 for update;

ERROR 1213 (HY000): Deadlock found when trying to get lock; try restarting transaction

· 不开启死锁检测，发生死锁时会一直等待到锁超时，锁超时时间依据MySQL存储节点中的innodb_lock_wait_timeout参数值。

mysql> select * from autoi where id=10 for update;

ERROR 1205 (HY000): Lock wait timeout exceeded; try restarting transaction

14.30 defaultMaxLimit

1. 参数说明

Property	Value
参数值	defaultMaxLimit
是否可见	否
参数说明	默认最大有序数量
默认值	10000
最小值	1
最大值	10000000
Reload是否生效	是
最低兼容版本	2.4.3

server.xml中defaultMaxLimit参数配置如下配置：

2. 参数作用

此参数为SeaSQL过载保护相关参数，与highCostSqlConcurrency参数配套使用。当前端并发执行跨库update/delete limit n场景时，若n超过defaultMaxLimit设置时，就会触发highCostSqlConcurrency参数控制，限制高内存消耗语句并发数量，相关连接会被hold住，等待前面执行完后，才能执行下一批。

体现在show processlist中State为Flow control，等待下一批执行。下图为方便测试，设置defaultMaxLimit=5，highCostSqlConcurrency=10，采用20并发执行跨库update limit n场景，可见10个连接在执行，另外的10个连接已经被限制。

[email protected]:pm 5.7.19-HotDB-2.5.1 06:10:45> show processlist;

+------+------+-------------------+------+---------+------+--------------+--------------------------------------------------------------------+

+------+------+-------------------+------+---------+------+--------------+--------------------------------------------------------------------+

| 4 | ztm | 10.10.0.201:57882 | PM | Query | 0 | executing | show processlist |

| 6 | ztm | 10.10.0.201:57905 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 7 | ztm | 10.10.0.201:57902 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 8 | ztm | 10.10.0.201:57912 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 9 | ztm | 10.10.0.201:57900 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 10 | ztm | 10.10.0.201:57919 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 11 | ztm | 10.10.0.201:57911 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 12 | ztm | 10.10.0.201:57904 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 13 | ztm | 10.10.0.201:57906 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 14 | ztm | 10.10.0.201:57903 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 15 | ztm | 10.10.0.201:57910 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 16 | ztm | 10.10.0.201:57908 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 17 | ztm | 10.10.0.201:57920 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 18 | ztm | 10.10.0.201:57907 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 19 | ztm | 10.10.0.201:57913 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 20 | ztm | 10.10.0.201:57909 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 21 | ztm | 10.10.0.201:57921 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 22 | ztm | 10.10.0.201:57918 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 23 | ztm | 10.10.0.201:57962 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 24 | ztm | 10.10.0.201:57915 | PM | Query | 1 | Flow control | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

| 25 | ztm | 10.10.0.201:57914 | PM | Query | 1 | Sending data | UPDATE customer_route_1 SET address = 'abcd' order by id LIMIT 20 |

+------+------+-------------------+------+---------+------+--------------+--------------------------------------------------------------------+

21 rows in set (0.01 sec)

14.31 disableDDLMinLongTrx

1. 参数说明

Property	Value
参数值	disableDDLMinLongTrx
是否可见	否
参数说明	禁用DDL最小长事务时长，单位毫秒
默认值	0
Reload是否生效	是
最低兼容版本	2.5.6

2. 参数设置

3. 参数作用

禁用DDL最小事务时长，当执行DDL操作后，先检查该表对象是否存在超过设定值时长的未提交事务，若存在，则DDL操作被禁用，并记录相关信息到hotdb.log日志文件中。

开启状态：

(1) 配置该设定值为10000，例如：

(2) 打开会话1，登录服务端口，开启事务，如下所示：

[email protected]:hotdb 5.7.22 01:52:10> begin;update test_ddl set tel=222 where id=1;

Query OK, 0 rows affected (0.00 sec)

(3) 等待10秒钟后，打开会话2，登录服务端口，执行DDL操作，如下所示：

[email protected]:hotdb 5.7.22 01:52:22> alter table test_ddl add column car int;

ERROR 10266 (HY000): DDL is disable when exists long trx, long trx is: 11

可见：当表对象存在未提交事务且事务时长超过10秒的情况下，该表的DDL操作会被禁用，同时hotdb.log日志可见如下内容：

2022-01-07 13:52:22.747 [INFO] [HOTDBERROR] [Unusual-Logger-1] cn.hotpu.hotdb.server.b(291) - sql: alter table test_ddl add column car int, err: DDL is disab

le when exists long trx, long trx is: 11 from connection [thread=Unusual-Logger-1,id=37,user=root,host=127.0.0.1,port=3323,localport=48600,schema=HOTDB,isEtl

=false,[{_os:linux-glibc2.12}, {_client_name:libmysql}, {_pid:6849}, {_client_version:5.7.25}, {_platform:x86_64}, {program_name:mysql}]]

14.32 dropTableRetentionTime

1. 参数说明

Property	Value
参数值	dropTableRetentionTime
是否可见	是
参数说明	被删除表保留时长,默认为0,不保留
默认值	0（小时）
最小值	0
最大值	87600
Reload是否生效	是
最低兼容版本	2.5.2

2. 参数设置

server.xml中dropTableRetentionTime参数配置：

3. 参数作用

2.5.5，dropTableRetentionTime参数默认为0，表示不保留被DROP的表，执行DROP TABLE语句将立即删除表；dropTableRetentionTime大于0时，单位以小时计算，保留被DROP的表到设置时长，超过设置时长后自动删除被保留的表。例如dropTableRetentionTime=24表示保留被DROP的表，24小时后再删除被保留的表。

14.33 ddlForDbNeedSuper

1. 参数说明

Property	Value
参数值	ddlForDbNeedSuper
是否可见	否
参数说明	DATABASE的DDL语句是否需要额外的SUPER权限
默认值	false
Reload是否生效	是
最低兼容版本	2.5.6

2. 参数设置

ddlForDbNeedSuper参数指针对DATABASE的DDL语句是否需要配置额外的SUPER权限。

3. 参数作用

以创建逻辑库为例：

· 设置成true时，需要同时拥有super权限和create全局权限才支持建库，否则创建报错：

· 设置成false时，只需要create全局权限即可建库：

· 若设置成false时，未配置create 全局权限也会创建失败：

14.34 drBakUrl & drBakUsername & drBakPassword

1. 参数说明

Property	Value
参数值	drBakUrl
是否可见	是
参数说明	容灾机房从配置库地址
默认值	jdbc:mysql://127.0.0.1:3306/hotdb_config
Reload是否生效	是
最低兼容版本	2.5.3.1

Property	Value
参数值	drBakUsername
是否可见	是
参数说明	容灾机房从配置库用户名
默认值	hotdb_config
Reload是否生效	是
最低兼容版本	2.5.3.1

Property	Value
参数值	drBakPassword
是否可见	是
参数说明	容灾机房从配置库密码
默认值	hotdb_config
Reload是否生效	是
最低兼容版本	2.5.3.1

2. 参数作用

drBakUrl和drBakUsername以及drBakPassword属于配套参数，用于容灾机房配置库高可用功能。当容灾机房切换为当前主机房时，若使用配置库高可用，则需要设置为对应从配置库的信息且保证主从配置库实例的复制关系正常，且互为主备。当容灾机房切换为当前主机房时，主配置库发生故障时会自动切换到从配置库，此时配置库的高可用切换可参考中心机房从配置库参数bakUrl，bakUsername，bakPassword的描述。

<property name="drBakUrl">jdbc:mysql://192.168.240.77:3316/hotdb_config</property>

<property name="drBakUsername">hotdb_config</property>

<property name="drBakPassword">hotdb_config</property>

14.35 drUrl & drUsername & drPassword

1. 参数说明

Property	Value
参数值	drUrl
是否可见	是
参数说明	容灾机房配置库地址
默认值	jdbc:mysql://127.0.0.1:3306/hotdb_config
Reload是否生效	是
最低兼容版本	2.5.3.1

Property	Value
参数值	drUsername
是否可见	是
参数说明	容灾机房配置库用户名
默认值	hotdb_config
Reload是否生效	是
最低兼容版本	2.5.3.1

Property	Value
参数值	drPassword
是否可见	是
参数说明	容灾机房配置库密码
默认值	hotdb_config
Reload是否生效	是
最低兼容版本	2.5.3.1

2. 参数作用

drUrl,drUsername,drPassword属于配套参数，,drUrl是指容灾机房计算节点配置信息的配置库路径，drUsername,drPassword是指连接该物理库的用户名密码，该配置库用于存储容灾机房配置信息。可参考与中心机房配置库相关参数url,username,password。

<property name="drUrl">jdbc:mysql://192.168.240.76:3316/hotdb_config</property>

<property name="drUsername">hotdb_config</property>

<property name="drPassword">hotdb_config</property>

14.36 enableCursor

1. 参数说明

Property	Value
参数值	enableCursor
是否可见	是
参数说明	是否允许PREPARE语句通过CURSOR获取数据
默认值	false
Reload是否生效	是
最低兼容版本	2.4.6

2. 参数设置

server.xml的enableCursor参数：

<property name="enableCursor">false</property>

3. 参数作用

是否允许PREPARE通过游标获取数据内容(jdbcURl:useCursorFetch=true)。

14.37 enableFlowControl

1. 参数说明

Property	Value
参数值	enableFlowControl
是否可见	是
参数说明	是否开启存储节点流控
默认值	False
Reload是否生效	2.4.5版本为N， 2.4.7及以上为Y
最低兼容版本	2.4.5

2. 参数作用

在2.4.8版本以后默认开启，开启后将智能控制后端流量，可以控制存储节点的压力，使存储节点在最佳状态下运行。通过管理端show @@datasource查看流控状态flow_control。

mysql> show @@datasource;

+------+------+-----------------------+------+--------+-------------+------+--------------+--------+------+------+--------------------+--------------+--------+-------------+-----------------+

+------+------+-----------------------+------+--------+-------------+------+--------------+--------+------+------+--------------------+--------------+--------+-------------+-----------------+

| 17 | 17 | 10.10.0.140_3313_db01 | 1 | 1 | 10.10.0.140 | 3313 | db01 | 0 | 45 | 45 | NULL | 0/64 | 1 | 8 | 1 |

| 16 | 16 | 10.10.0.140_3312_db01 | 1 | 1 | 10.10.0.140 | 3312 | db01 | 0 | 47 | 47 | NULL | 0/64 | 1 | 7 | 1 |

| 19 | 19 | 10.10.0.155_3311_db01 | 1 | 1 | 10.10.0.155 | 3311 | db01 | 0 | 49 | 49 | NULL | 0/64 | 1 | 10 | 1 |

| 18 | 18 | 10.10.0.155_3310_db01 | 1 | 1 | 10.10.0.155 | 3310 | db01 | 0 | 53 | 53 | NULL | 0/64 | 1 | 9 | 1 |

| 21 | 21 | 10.10.0.155_3313_db01 | 1 | 1 | 10.10.0.155 | 3313 | db01 | 0 | 55 | 55 | NULL | 0/64 | 1 | 12 | 1 |

| 20 | 20 | 10.10.0.155_3312_db01 | 1 | 1 | 10.10.0.155 | 3312 | db01 | 0 | 47 | 47 | NULL | 0/64 | 1 | 11 | 1 |

| 10 | 10 | 10.10.0.125_3310_db01 | 1 | 1 | 10.10.0.125 | 3310 | db01 | 0 | 44 | 44 | NULL | 0/64 | 1 | 1 | 1 |

| 11 | 11 | 10.10.0.125_3311_db01 | 1 | 1 | 10.10.0.125 | 3311 | db01 | 0 | 43 | 43 | NULL | 0/64 | 1 | 2 | 1 |

| 12 | 12 | 10.10.0.125_3312_db01 | 1 | 1 | 10.10.0.125 | 3312 | db01 | 0 | 44 | 44 | NULL | 0/64 | 1 | 3 | 1 |

| 13 | 13 | 10.10.0.125_3313_db01 | 1 | 1 | 10.10.0.125 | 3313 | db01 | 0 | 48 | 48 | NULL | 0/64 | 1 | 4 | 1 |

| 14 | 14 | 10.10.0.140_3310_db01 | 1 | 1 | 10.10.0.140 | 3310 | db01 | 0 | 44 | 44 | NULL | 0/64 | 1 | 5 | 1 |

| 15 | 15 | 10.10.0.140_3311_db01 | 1 | 1 | 10.10.0.140 | 3311 | db01 | 0 | 62 | 62 | NULL | 0/64 | 1 | 6 | 1 |

| -1 | -1 | configDatasource | 1 | 1 | 10.10.0.121 | 3306 | hotdb_config | 1 | 11 | 12 | NULL | N/A | -1 | 0 | 1 |

+------+------+-----------------------+------+--------+-------------+------+--------------+--------+------+------+--------------------+--------------+--------+-------------+-----------------+

注：存储节点流控是计算节点内部控制算法。

14.38 enableHeartbeat&heartbeatPeriod& heartbeatTimeoutMs

1. 参数说明

Property	Value
参数值	enableHeartbeat
是否可见	是
参数说明	是否启用心跳，是：true，否：false
默认值	true
Reload是否生效	2.4.5版本为N， 2.4.7及以上为Y
最低兼容版本	2.4.3

Property	Value
参数值	heartbeatPeriod
是否可见	是
参数说明	心跳周期（秒）
默认值	2
最大值	60
最小值	1
Reload是否生效	· 2.4.5版本为N， · 2.4.7及以上为Y
最低兼容版本	2.4.3

Property	Value
参数值	heartbeatTimeoutMs
是否可见	是
参数说明	心跳超时时间（毫秒）
默认值	500
最大值	10000
最小值	100
Reload是否生效	· 2.4.5版本为N， · 2.4.7及以上为Y
最低兼容版本	2.4.3

enableHeartbeat设置是否启用心跳检测。heartbeatPeriod设置心跳检测周期，默认值为2s，即心跳定时检测每2秒执行一次。heartbeatTimeoutMs设置心跳超时时间，默认值为500ms。

2. 参数作用

检测存储节点是否可用及是否存在共用的情况。

启用心跳检测后，会根据心跳检测周期去检测存储节点是否正常。当网络不可达或存储节点故障时，存在备存储节点且配置了切换规则的情况下，会切换到备存储节点，主存储节点会被置为不可用；存储节点切换逻辑请参考《H3C SeaSQL DRDS 管理平台用户手册》。

当一个存储节点同时被多个计算节点服务使用时，计算节点通过日志提示：there's another HotDB using this datasource...restart heartbeat. 不启用心跳检测的情况下，则数据节点/配置库高可用无法实现，无法进行故障切换，无法检测出存储节点共用等情况。

心跳超时时间：心跳开启的情况下，出现存储节点故障或心跳操作执行过慢超出阈值，会有日志heartbeat time out输出:

2018-05-29 16:32:52.924 [WARN] [HEARTBEAT] [HeartbeatTimer] a(-1) – Datasource:-1 128.0.0.1:3306/hotdb_config time out! Last packet sent at:2018-05-29 04:32:49:886…省略…

若当前存储节点为数据节点最后一个存储节点，存储节点不会置为不可用。且会尝试一直连接；若为纯备存储节点，即使心跳失败次数已经超过阈值，只要心跳检测时能够连接存储节点成功就不标记为不可用。

14.39 enableLatencyCheck & latencyCheckPeriod

1. 参数说明

Property	Value
参数值	enableLatencyCheck
是否可见	是
参数说明	是否开启主从延迟检测
默认值	true
Reload是否生效	· 2.4.5版本为N， · 2.4.7及以上为Y
最低兼容版本	2.4.5

Property	Value
参数值	latencyCheckPeriod
是否可见	是
参数说明	主从延迟检测周期(ms)
默认值	500
最大值	1000
最小值	100
Reload是否生效	· 2.4.5版本为N， · 2.4.7及以上为Y
最低兼容版本	2.4.5

设置主从延迟检测周期，默认值为500ms，即定时检测每500ms秒执行一次主从延迟检测。

2. 参数作用

延迟检测依赖于心跳表。启用主从延迟检测，检测从库是否存在复制延迟，是否同步追上复制。此参数在存储节点/配置库切换时、计算节点启动时具有一定影响作用，例如，在存储节点故障切换之前要进行主从延迟校验（前提是需要配置故障切换规则，若没有配置切换规则，则不会进行主备存储节点之间的切换以及主从延迟校验），请参考《H3C SeaSQL DRDS 管理平台用户手册》。

登录管理端口，使用show @@latency; 可以查看主从延迟时间。

mysql> show @@latency;

+------+----------------------------+----------------------------+---------+

+------+----------------------------+----------------------------+---------+

| 186 | 192.168.210.68:3307/db252 | 192.168.210.68:3308/db252 | 501 ms |

| 4 | 192.168.210.43:3308/db252 | 192.168.210.44:3308/db252 | 0 ms |

| 190 | 192.168.200.191:3307/db252 | 192.168.200.190:3307/db252 | 0 ms |

| 191 | 192.168.200.191:3308/db252 | 192.168.200.190:3308/db252 | 0 ms |

| 127 | 192.168.210.41:3308/db252 | 192.168.210.42:3308/db252 | STOPPED |

+------+----------------------------+----------------------------+---------+

5 rows in set (0.02 sec)

14.40 enableListener

1. 参数说明

Property	Value
参数值	enableListener
是否可见	是
参数说明	启用Listener模式
默认值	false
Reload是否生效	是
最低兼容版本	2.5.5

2. 参数设置

<property name="enableListener">false</property>

3. 参数作用

SeaSQL Listener是计算节点一个可拔插组件，开启后可解决集群强一致模式下的性能线性扩展问题。要使用Listener需满足：计算节点是多节点集群模式并开启XA、在存储节点服务器上成功部署Listener并启用enableListener参数。执行动态加载，在计算节点管理端执行以下命令可通过listener_status一列查看是否识别成功以及Listener的实时状态。

MySQL [(none)]> show @@datasource;