华为云用户手册

数据类型对应关系 GaussDB (for MySQL)实例数据同步到HTAP时会被转成对应的类型，详情请参考表1。 表1 数据类型转换 数据类型 GaussDB(for MySQL)数据类型 HTAP数据类型 NUMERTIC TYPES TINYINT TINYINT TINYINT UNSIGNED SMALLINT SMALLINT SMALLINT SMALLINT UNSIGNED INT MEDIUMINT INT INTEGER/INT INT INTEGER/INT UNSIGNED BIGINT BIGINT BIGINT BIGINT UNSIGNED LARGEINT DECIMAL/NEMERIC DECIMAL FLOAT FLOAT DOUBLE/REAL DOUBLE BIT BIT DATE TIME TYPES DATE DATE DATETIME DATETIME TIMESTAMP DATETIME TIME STRING YEAR INT String Data Types CHAR CHAR/VARCHAR VARCHAR VARCHAR BINARY VARBINARY VARBINARY VARBINARY BLOB VARBINARY TINYTEXT TEXT TEXT TEXT MEDIUMTEXT TEXT LONGTEXT TEXT ENUM 暂不支持 SET 暂不支持 Spatial Data Types GEOMETRY 暂不支持 POINT 暂不支持 LINESTRING 暂不支持 POLYGON 暂不支持 MULTIPOINT 暂不支持 MULTILINESTRING 暂不支持 MULTIPOLYGON 暂不支持 GEOMETRYCOLLECTION 暂不支持 JSON Data Types JSON JSON AP引擎将BLOB类型转换为VARBINAY类型进行兼容。由于VARBINARY最大规格为1MB，无法满足BLOB类型的正常使用；所以有BLOB类型的表需要同步的情况下，需要将库同步设置中enable_filter_lob_column置为True，对Blob类型的列进行过滤。 父主题： 开发指南

系统账户说明 您在创建HTAP实例时，系统会自动为HTAP实例创建如下系统账户（用户不可使用），用于给HTAP实例提供完善的后台运维管理服务。 rdsAdmin：管理账户，拥有最高的superuser权限，用于查询和修改实例信息、故障排查、迁移、恢复等操作。 rdsMetric：指标监控账户，用于watchdog采集数据库状态数据。 删除、重命名、修改这些账户的密码和权限信息，会导致实例运行异常，请谨慎操作。

语法 创建一个或多个HASH-HASH分区表，其中每个分区可能有一个或一个以上的子分区。 CREATE TABLE [ schema. ]table_name table_definition PARTITION BY [LINEAR] HASH(expr) [PARTITIONS num] SUBPARTITION BY [LINEAR] HASH(expr) [SUBPARTITIONS sub_num] [partition_definition [, partition_definition] ...]; 其中，partition_definition为： PARTITION partition_name (subpartition_definition [, subpartition_definition] ...) subpartition_definition为： SUBPARTITION subpartition_name 表1 参数说明 参数名称 描述 table_name 要创建的表名称。 expr 分区字段表达式，目前只支持INT类型，不支持字符类型。 num 用于分区是HASH或者KEY类型的分区表，来指定分区个数。 sub_num 用于二级分区是HASH或者KEY类型的分区表，来指定单个分区的子分区的个数。 partition_name 分区名称，同一个表中不可重复。 subpartition_name 子分区名称， 同一个表中不可重复。

使用示例 HASH-HASH类型的使用示例 CREATE TABLE tbl_hash_hash ( col1 INT, col2 INT, col3 varchar(20), col4 DATE ) PARTITION BY HASH(col1) PARTITIONS 9 SUBPARTITION BY HASH(col2) SUBPARTITIONS 3;

存储类型介绍 表1 存储类型介绍 存储类型 特点 适用场景 DL6（Cloud Database Engine Level 6） 原“共享存储”，即GaussDB(for MySQL)历史版本默认支持的存储类型，2024年7月前创建的GaussDB(for MySQL)实例默认的存储类型。 DL6存储类型的实例采用3AZ部署，RPO=0。性能更佳、峰值吞吐量更高。 对性能敏感，业务高峰对存储IO要求极高的核心应用系统，如金融、电商、政务和游戏等。 DL5（Cloud Database Engine Level 5） GaussDB(for MySQL)全新推出的存储类型，底层基于华为云自研硬件及网络底座技术，保持了DL6的3AZ，RPO=0的高可用性，峰值性能有所下降，单位容量的成本显著降低。 CPU密集型的次核心业务系统；或有降低成本诉求，追求高性价比的应用模块。 由于两类存储依托于不同物理介质，对于已创建的实例，存储类型无法支持直接切换。如需切换存储类型，建议您购买一个新的GaussDB(for MySQL)实例并配置预期的存储类型，将原有实例的数据通过DRS工具迁移到新实例上。

约束与限制 GaussDB(for MySQL)使用和命名上有一些固定限制，用来提高实例的稳定性和安全性，具体详见表1和表2。 表1 功能使用限制 功能 使用限制 GaussDB(for MySQL)访问 如果GaussDB(for MySQL)数据库实例没开通公网访问，则该实例必须与弹性云服务器在同一个虚拟私有云内才能访问。 弹性云服务器必须处于目标GaussDB(for MySQL)数据库实例所属安全组允许访问的范围内。 如果GaussDB(for MySQL)数据库实例与弹性云服务器处于不同的安全组，系统默认不能访问。需要在GaussDB(for MySQL)数据库的安全组添加一条“入”的访问规则。“入”规则开放TCP协议，使用数据库实例的默认端口。 GaussDB(for MySQL)数据库实例的默认端口： 主备版默认端口为3306，需用户手动修改端口号后，E CS 或外网才能访问其他端口。具体操作请参见修改数据库端口。 数据库的root权限 创建实例页面只提供管理员root用户权限（仅限主备版）。 修改数据库参数设置 大部分数据库参数可以通过控制台进行修改。 数据迁移 使用DRS或mysqldump迁移到GaussDB(for MySQL)数据。 MySQL存储引擎 GaussDB(for MySQL)只支持InnoDB存储引擎。 重启GaussDB(for MySQL)实例 无法通过命令行重启，必须通过GaussDB(for MySQL)的管理控制台重启实例。 查看GaussDB(for MySQL)备份 GaussDB(for MySQL)数据库实例在 对象存储服务 上的备份文件，对用户不可见。 开启Binlog GaussDB(for MySQL) 不支持只读节点开启Binlog。 分区表 GaussDB(for MySQL)现有产品能力和社区8.0.22版本是兼容的，对于分区表，如果是list分区，目前每个分区的values最多只支持256个，超出会报错。（规避措施：将values个数过多的分区拆成更小的分区，确保每个分区的values个数都不超过256个。） 小规格实例 对于2U8GB的GaussDB(for MySQL)实例，单个实例中总的表数量不能超过30万个，单个数据库中的表数量不能超过5000个。 表2 命名约束 参数 约束 实例名称 长度在4个到64个字符之间，必须以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他特殊字符。 数据库名称 长度可在1～64个字符之间，由字母、数字、下划线、中划线组成，中划线累计总长度小于等于10个字符，且不能包含其他特殊字符。 账号（非管理员） 长度在1到32个字符之间，由字母、数字、下划线组成，不能包含其他特殊字符 密码 长度为8~32个字符，至少包含大写字母、小写字母、数字、特殊字符三种字符的组合，其中允许输入~!@#$%^*-_=+?,()&特殊字符。 参数模板名称 长度在1~64个字符之间，区分大小写，可包含字母、数字、中划线、下划线或句点，不能包含其他特殊字符。 备份名称 长度在4~64个字符之间，必须以字母开头，区分大小写，可以包含字母、数字、中划线或者下划线，不能包含其他特殊字符。 保留关键字 除社区MySQL8.0的保留关键字外，GaussDB(for MySQL)新增部分保留关键字，在命名时需要避开，防止报错。

规格要求 RegionlessDB支持在1个区域部署主实例，多个区域部署从实例，每个RegionlessDB最多支持创建5个从实例。其中主实例和普通GaussDB(for MySQL)数据库实例能力相同，提供读写服务，从实例提供只读服务。表1列出了RegionlessDB支持的最大规格。 表1 规格说明 描述 主实例 从实例 最大实例数量 1 5 单实例最大可写节点数 1 0 单实例最大只读节点数 15 15 创建实例时最多可批量申请10个只读节点。 父主题： RegionlessDB

删除RegionlessDB 删除RegionlessDB前，请确保从实例已全部与RegionlessDB脱离，具体操作请参见脱离从实例。 单击左侧导航栏中的“RegionlessDB”。 找到目标数据库，单击操作列的“删除”。 若您已开启高危操作保护，在弹框中单击“去验证”，跳转至验证页面，单击“免费获取验证码”，正确输入验证码并单击“认证”，页面自动关闭。 关于如何开启操作保护，具体请参考《 统一身份认证 服务用户指南》的内容。 在“删除RegionlessDB”弹框中，根据需要选择是否勾选“同步删除RegionlessDB下的实例”，输入框中按照提示输入“DELETE”，单击“确定”。 图3 删除RegionlessDB 稍后刷新“RegionlessDB”列表页面，查看删除结果。 您也可以通过“任务中心”查看详细进度和结果。

INTERVAL RANGE分区表与任意类型表的相互转换 语法： 其他类型表转化为INTERVAL RANGE分区表。 ALTER TABLE table_name table_definition partition_options; ​ partition_options： PARTITION BY { RANGE{(expr) | COLUMNS(column_list)} } { INTERVAL(type, value) | INTERVAL(value) } [(partition_definition [, partition_definition] ...)] ​ partition_definition: PARTITION partition_name [VALUES LESS THAN {expr | MAXVALUE}] [[STORAGE] ENGINE [=] engine_name] [COMMENT [=] 'string' ] [DATA DIRECTORY [=] 'data_dir'] [INDEX DIRECTORY [=] 'index_dir'] [MAX_ROWS [=] max_number_of_rows] [MIN_ROWS [=] min_number_of_rows] [TABLESPACE [=] tablespace_name] INTERVAL子句关联参数说明： 表3 参数说明 参数名称 参数说明 INTERVAL(value) 使用RANGE(expr) 或者 RANGE COLUMNS(column_list)且column是整型字段时，INTERVAL子句的格式，其中value代表间隔数值，必须是正整数。 expr RANGE(expr)中的分区表达式，目前只支持整数类型。 column_list RANGE COLUMNS(column_list)的分区字段列表，在INTERVAL RANGE分区表中，column_list只能是单列。 INTERVAL(type, value) 使用RANGE COLUMNS(column_list)且column_list是DATE/TIME/DATETIME类型时，INTERVAL子句的格式，其中type代表间隔类型，value代表间隔数值。 type目前支持8种时间类型（YEAR、QUARTER、MONTH、WEEK、DAY、HOUR、MINUTE、SECOND）。 value代表间隔数值，必须是正整数；当type为SECOND类型时，间隔不能小于60。 INTERVAL RANGE分区表转化为其他任意类型的表，这里partition_options是可选的，具体定义取决于要转化的目标表类型。 ALTER TABLE table_name table_definition [partition_options]; partition_options选项取决于要转化为表的分区类型信息。 示例： 将其他类型表转为INTERVAL RANGE表： CREATE TABLE orders( orderkey BIGINT NOT NULL, custkey BIGINT NOT NULL, orderdate DATE NOT NULL ); ​ ALTER TABLE orders PARTITION BY RANGE COLUMNS(orderdate) INTERVAL(MONTH, 1) ( PARTITION p0 VALUES LESS THAN('2021-10-01') ); 将INTERVAL RANGE表转化为其他类型表： CREATE TABLE orders (a INT, b DATETIME) PARTITION BY RANGE (a) INTERVAL(10) ( PARTITION p0 VALUES LESS THAN(10), PARTITION p2 VALUES LESS THAN(20) ); ​ ALTER TABLE orders PARTITION BY LIST COLUMNS (a) ( PARTITION p0 VALUES IN (1, 11, 25) ); 修改INTERVAL RANGE表的INTERVAL子句信息： CREATE TABLE orders (a INT, b DATETIME) PARTITION BY RANGE (a) INTERVAL(10) ( PARTITION p0 VALUES LESS THAN(10), PARTITION p2 VALUES LESS THAN(20) ); ​ ALTER TABLE orders PARTITION BY RANGE (a) INTERVAL(20) ( PARTITION p0 VALUES LESS THAN(10), PARTITION p2 VALUES LESS THAN(20) ); ​ # 消除INTERVAL子句 ALTER TABLE orders PARTITION BY RANGE (a) ( PARTITION p0 VALUES LESS THAN(10), PARTITION p2 VALUES LESS THAN(20) ); ​ # 添加INTERVAL子句 ALTER TABLE orders PARTITION BY RANGE (a) INTERVAL(100) ( PARTITION p0 VALUES LESS THAN(10), PARTITION p2 VALUES LESS THAN(20) );

SET INTERVAL子句支持 支持使用SET INTERVAL子句修改INTERVAL RANGE表定义的INTERVAL子句间隔类型和间隔值，也可实现消除或添加INTERVAL子句。 语法： ALTER TABLE table_name SET INTERVAL {() | (type, value) | (value)}; 表4 参数说明 参数名称 参数说明 type 目前支持8种时间类型（YEAR、QUARTER、MONTH、WEEK、DAY、HOUR、MINUTE、SECOND），不显式指定默认是数字类型的间隔。 value 指定间隔的数值大小。当type为SECOND类型时，间隔不能小于60。 示例： 修改INTERVAL RANGE表的INTERVAL类型和值。 CREATE TABLE orders( orderkey BIGINT NOT NULL, custkey BIGINT NOT NULL, orderdate DATE NOT NULL ) PARTITION BY RANGE COLUMNS(orderdate) INTERVAL(MONTH, 1) ( PARTITION p0 VALUES LESS THAN('2021-10-01') ); ​ ALTER TABLE orders SET INTERVAL(YEAR, 1); 实现RANGE表和INTERVAL RANGE表之间的转化。 CREATE TABLE orders( orderkey BIGINT NOT NULL, custkey BIGINT NOT NULL, orderdate DATE NOT NULL ) PARTITION BY RANGE COLUMNS(orderdate) INTERVAL(MONTH, 1) ( PARTITION p0 VALUES LESS THAN('2021-10-01') ); ​ # 删除INTERVAL子句 ALTER TABLE sales SET INTERVAL(); ​ # 添加INTERVAL子句 ALTER TABLE sales SET INTERVAL(DAY, 60); 即使当前功能开关rds_interval_range_enabled关闭，"ALTER TABLE table_name SET INTERVAL()"语句也可使用（用于消除INTERVAL RANGE表的INTERVAL子句定义信息，转化为普通RANGE表）。

使用限制 INTERVAL RANGE表只支持HASH/KEY二级分区。 采取RANGE COLUMNS(column_list) INTERVAL([type], value)形式描述INTERVAL RANGHE规则时： column_list（分区键）中列个数只能为1，并且只能是是整数类型或者DATE/TIME/DATETIME类型。 如果分区键是整型，INTERVAL的间隔类型type不需要填写。 如果分区键为DATE类型，INTERVAL的间隔类型type只能取YEAR、QUARTER、MONTH、WEEK、DAY。 如果分区键为TIME类型，INTERVAL的间隔类型type只能取HOUR、MINUTE、SECOND。 如果分区间为DATETIME类型，INTERVAL的间隔类型type可以取YEAR、QUARTER、MONTH、WEEK、DAY、HOUR、MINUTE、SECOND。 间隔值value只能为正整数。 如果INTERVAL的间隔类型是SECOND，间隔不能小于60。 采取RANGE(expr) INTERVAL(value)形式描述INTERVAL RANGHE规则时，expr表达式的结果应为整数，间隔值value只能为正整数。 不支持使用INSERT ...SELECT语句、INSERT ...ON DUPLICATE KEY UPDATE语句、UPDATE语句触发分区新增。 LOAD DATA时不会触发分区新增（如果分区覆盖了所有插入数据的范围，能使用load data导入数据，如果分区没有覆盖插入数据的范围，load data无法触发自增分区，导入数据失败）。 事务中如果触发分区自增，一旦新分区创建成功，不支持回滚。 自增的分区使用'_p'作为分区名的前缀，因此客户设置的以此开头的分区名可能导致分区自增失败。 SET INTERVAL([type], value)子句只适用于INTERVAL RANGE表和RANGE表，如果这两种表有二级分区，只支持二级分区为HASH或KEY类型。 SET INTERVAL([type], value)子句的type和value取值要受原表的分区表达式expr或分区键column_list的约束。

创建INTERVAL RANGE分区表 INTERVAL RANGE分区表定义格式类似于RANGE分区表，但多了INTERVAL子句。 语法： CREATE TABLE [IF NOT EXISTS] [schema.]table_name table_definition partition_options; 其中，partition_options为： PARTITION BY RANGE {(expr) | COLUMNS(column_list)} {INTERVAL(value) | INTERVAL(type, expr)} (partition_definition [, partition_definition] ...) partition_definition为： PARTITION partition_name [VALUES LESS THAN {expr | MAXVALUE}] [[STORAGE] ENGINE [=] engine_name] [COMMENT [=] 'string' ] [DATA DIRECTORY [=] 'data_dir'] [INDEX DIRECTORY [=] 'index_dir'] [MAX_ROWS [=] max_number_of_rows] [MIN_ROWS [=] min_number_of_rows] [TABLESPACE [=] tablespace_name] 其中，INTERVAL子句仅支持设置间隔数值（value）和间隔类型（type）。 INTERVAL子句关联参数说明： 表2 参数说明 参数名称 参数说明 INTERVAL(value) 使用RANGE(expr) 或者 RANGE COLUMNS(column_list)且column是整型字段时，INTERVAL子句的格式，其中value代表间隔数值，必须是正整数。 expr RANGE(expr)中的分区表达式，目前只支持整数类型。 column_list RANGE COLUMNS(column_list)的分区字段列表，在INTERVAL RANGE分区表中，column_list只能是单列。 INTERVAL(type, value) 使用RANGE COLUMNS(column_list)且column_list是DATE/TIME/DATETIME类型时，INTERVAL子句的格式，其中type代表间隔类型，value代表间隔数值。 type目前支持8种时间类型（YEAR、QUARTER、MONTH、WEEK、DAY、HOUR、MINUTE、SECOND）。 value代表间隔数值，必须是正整数；当type为SECOND类型时，间隔不能小于60。 间隔数值（value）和间隔类型（type）的进一步说明：

步骤6：测试ALT效果 当ALT功能开启，使用Sysbench，Tpcc-MySQL或MySQL客户端等工具连接到数据库代理地址，只读升主过程中用户的连接不会中断，只会出现短时间的卡顿后很快恢复。 以下分别是使用Sysbench，Tpcc-MySQL和MySQL客户端工具进行主备切换的效果示意。 使用Sysbench的进行只读升主的示例 使用tpcc-mysql的进行只读升主的示例 使用MySQL命令行工具进行只读升主的示例 如下图所示，用户自定义变量、会话变量、数据库在主备切换前后保持一致。 如下图所示，不同的事务排干超时时间，可能会影响到当前会话的ALT能力。

特性参数说明 表1 参数说明 参数名称 描述 取值范围 默认值 级别 是否动态生效 rds_column_compression 当参数取值为0时，表示字段压缩特性关闭，不再支持显式或者自动创建压缩列。 当参数取值为1时，表示仅支持显式创建压缩列。 当参数取值为2时，表示同时支持显式或自动创建压缩列。 [0,2] 0 GLOBAL 是 rds_default_column_compression_algorithm 设置字段压缩特性默认的压缩算法，适用于如下场景： 显式创建压缩字段而不指定具体的压缩算法。 自动压缩场景。 ZLIB或ZSTD ZLIB GLOBAL 是 rds_column_compression_threshold 设置字段压缩特性的阈值。 当列定义最大长度小于此阈值时，可以显式创建压缩列，但会收到提示信息，不能自动地创建压缩列。 当列定义最大长度大于等于此阈值时，支持显式或者自动创建压缩列。 [20-4294967295] 100 GLOBAL 是 rds_zlib_column_compression_level 控制字段压缩特性中zlib压缩算法的压缩级别。 当参数取值为0时代表不压缩。 取值为除0外范围内的其他参数值时，取值越小，压缩速度越快但压缩效果越差；取值越大，压缩速度越慢但压缩效果越好。 [0,9] 6 GLOBAL 是 rds_zstd_column_compression_level 控制字段压缩特性中zstd压缩算法的压缩级别。 取值越小，压缩速度越快但压缩效果越差；取值越大，压缩速度越慢但压缩效果越好。 [1,22] 3 GLOBAL 是

语法 扩展column_definition定义，支持在CREATE TABLE/ALTER TABLE ADD/ALTER TABLE CHANGE/ALTER TABLE MODIFY场景定义列属性时使用压缩特性。 create_definition: { col_name column_definition | {INDEX | KEY} [index_name] [index_type] (key_part,...) [index_option] ... | {FULLTEXT | SPATIAL} [INDEX | KEY] [index_name] (key_part,...) [index_option] ... | [CONSTRAINT [symbol]] PRIMARY KEY [index_type] (key_part,...) [index_option] ... | [CONSTRAINT [symbol]] UNIQUE [INDEX | KEY] [index_name] [index_type] (key_part,...) [index_option] ... | [CONSTRAINT [symbol]] FOREIGN KEY [index_name] (col_name,...) reference_definition | check_constraint_definition } alter_option: { table_options | ADD [COLUMN] col_name column_definition [FIRST | AFTER col_name] | ADD [COLUMN] (col_name column_definition,...) | CHANGE [COLUMN] old_col_name new_col_name column_definition [FIRST | AFTER col_name] | MODIFY [COLUMN] col_name column_definition [FIRST | AFTER col_name] ... 其中column_definition为： column_definition: { data_type [NOT NULL | NULL] [DEFAULT {literal | (expr)} ] [VISIBLE | INVISIBLE] [AUTO_INCREMENT] [UNIQUE [KEY]] [[PRIMARY] KEY] [COMMENT 'string'] [COLLATE collation_name] [COLUMN_FORMAT {FIXED | DYNAMIC | DEFAULT}] [COLUMN_FORMAT {FIXED|DYNAMIC|DEFAULT}|COMPRESSED[={ZLIB|ZSTD}**]] [ENGINE_ATTRIBUTE [=] 'string'] [SECONDARY_ENGINE_ATTRIBUTE [=] 'string'] [STORAGE {DISK | MEMORY}] [reference_definition] [check_constraint_definition] | data_type [COLLATE collation_name] [GENERATED ALWAYS] AS (expr) [VIRTUAL | STORED] [NOT NULL | NULL] [VISIBLE | INVISIBLE] [UNIQUE [KEY]] [[PRIMARY] KEY] [COMMENT 'string'] [reference_definition] [check_constraint_definition] }

使用须知 GaussDB(for MySQL)实例内核版本大于等于2.0.54.240600可使用该功能。 不支持分区表、临时表、非InnoDB引擎表。 压缩字段上不能包含索引(主键、唯一索引、二级索引、外键、全文索引)。 仅支持的数据类型：BLOB（包含TINYBLOB、BLOB、MEDIUMBLOB、LONGBLOB），TEXT（包含TINYTEXT、TEXT、MEDIUMTEXT、LONGTEXT），VARCHAR，VARBINARY。 不支持在生成列上使用此特性。 不支持在分区表和带有压缩字段的表之间执行EXCHANGE PARTITION式语句。 不支持IMPORT TABLESPACE。 仅支持在CREATE TABLE/ALTER TABLE ADD/ALTER TABLE CHANGE/ALTER TABLE MODIFY场景使用此特性。 ALTER TABLE ADD COLUMN不支持INSTANT算法，ALTER TABLE {CHANGE|MODIFY} 语法涉及数据变化时不支持使用INSTANT算法。 自动压缩场景(rds_column_compression=2)，定义字段的最大长度需大于等于字段压缩阈值(rds_column_compression_threshold)时才可以被添加压缩属性；显式压缩场景(rds_column_compression=1)，若定义压缩字段的最大长度小于字段压缩阈值，字段仍可被添加压缩属性，同时收到warning信息。 若当前表中包含压缩字段，暂不支持NDP计算下推。 客户手动拉取BIN LOG 同步过程中ALTER语句会出现不兼容的问题，推荐客户侧使用HINT的方式来解决。 利用DRS迁移至无该特性的实例，压缩属性被消除。全量迁移任务可以进行，增量迁移时ALTER语句中存在压缩字段会导致迁移任务失败。 物理备份方面，利用备份去做数据恢复的版本也必须是带有字段压缩特性的。 升级至新版本之后，如果已经使用字段压缩功能，不支持回退至无该特性的版本。

使用须知 请参见约束与限制。 写转发只有在从实例的事务隔离级别为RR的场景下才支持。 当前版本从实例进行写转发时，暂不支持显示WARNING和RECORD信息。 当前版本从实例进行写转发时，暂不支持中断执行中的SQL请求。 写转发会创建用户“_@gdb_WriteForward@_”，请不要修改或者删除该用户，否则写转发功能无法正常运行。 支持的写转发命令如下： SQLCOM_UPDATE SQLCOM_INSERT SQLCOM_DELETE SQLCOM_INSERT_SELECT SQLCOM_REPLACE SQLCOM_REPLACE_SELECT SQLCOM_DELETE_MULTI SQLCOM_UPDATE_MULTI SQLCOM_ROLLBACK 如果执行了不支持的写转发命令，会出现如下报错信息： ERROR xxx (yyy): This version of MySQL doesn't yet support 'operation with write forwarding'. 其中“operation”为具体不支持的操作类型。 不支持的场景： SELECT FOR UPDATE语句。 EXPLAIN写转发语句。 写转发的语句包含SET VARIABLE。 在写转发开启的场景下，不支持SAVEPOINT。 XA事务中不支持写转发。 当前不支持START TRANSACTION READ WRITE，可以直接使用START TRANSACTION进行测试写转发。 存储过程中不支持写转发。 写转发开启时，不支持创建临时表，如果需要创建临时表，可以暂时关闭写转发进行创建。 针对会隐式提交的命令，在不支持写转发的情况下，也会自动提交当前节点和主节点对应的事务。 针对全局一致性级别，每个事务第一次访问数据之前，需要使用会话池中的连接，从主节点获取数据点位（LSN），如果没有可以使用的会话，可能会导致读取数据的命令失败。 如果用户使用写转发的会话出现连接错误，并且用户处于多语句事务中，服务端会主动关闭与客户端和主节点的连接，保证客户端能够感知到对应的错误。 主从实例的版本需要保持为最新版本。 由于写转发是转发到主节点上执行，如果只读节点有相同数据库下的同名临时表，最终以主节点的数据为准。 从实例如果参与了区域切换或者故障转移，写转发相关参数（“rds_open_write_forwarding”和“rds_write_forward_read_consistency”）会恢复为默认值。

查看可控RPO状态 执行如下SQL查看RPO实时状态： 图1 查看RPO状态 表1 参数说明 参数名称 说明 IS_RPO_TIME_OUT 表示可控RPO的状态。 null：表示状态正常。 avg_latency_time_out：表示主实例和从实例之间的平均复制时延过大，可控RPO暂时处于退出状态，直到一段时间后，平均复制时延正常后，再次进入可控RPO状态。 wait_time_out：表示由于网络等原因，可控RPO等待主实例的事务数据同步复制到从实例时出现超时，可控RPO暂时处于退出状态，直到一段时间后，再次进入可控RPO状态。 wait_time_out|avg_latency_time_out：表示出现以上两种情况，可控RPO暂时处于退出状态，直到一段时间后环境恢复正常，再次进入可控RPO状态。 RPO_CONTROL_LSN 表示可控RPO成功同步的数据位点。只有满足执行时长的事务，才会进入可控RPO的同步等待集合。

可控RPO原理 对于长事务，若提交完成返回成功的一瞬间且提交日志还未复制到从集群，容灾切换后，该长事务产生的数据将全部丢失。为了解决这个问题，RegionlessDB提供可控RPO的能力，用户可以控制在主实例上执行时间超过T的事务进入等待集合，同时主实例实时获取从实例日志持久化的数据位点（LSN）A，直到等待集合中事务提交的数据位点小于等于A时，才返回成功。这样达到用户自主控制长事务提交返回成功前，事务已经完整地持久化在从实例中的效果，从而在容灾切换场景下，减少了数据丢失的程度。

脱离从实例 在“RegionlessDB”页面，找到目标RegionlessDB。 单击RegionlessDB名称，进入“RegionlessDB详情”页面。 在实例列表区域，找到目标从实例，单击操作列的“脱离”。 图2 实例列表页面 若您已开启高危操作保护，在弹框中单击“去验证”，跳转至验证页面，单击“免费获取验证码”，正确输入验证码并单击“认证”，页面自动关闭。 关于如何开启操作保护，具体请参考《统一身份认证服务用户指南》的内容。 在“脱离RegionlessDB”弹框中，按照提示在输入框中输入“DELETE”，单击“确定”。 图3 脱离RegionlessDB 您可以通过“任务中心”查看详细进度和结果。 只有从实例支持脱离RegionlessDB，主实例无法脱离。 从RegionlessDB脱离后，主实例将中断与该从实例的数据同步。 从RegionlessDB脱离后，该实例将被彻底删除，请谨慎操作。

资源计划指令(plan_directive)管理 通过租户下的用户连接数据库，进行资源计划指令管理。 创建资源计划指令 dbms_resource_manager.create_plan_directive ( plan CHAR(128), group_or_subplan CHAR(128), comment VARCHAR(2000), mgmt_p1 bigint(20), utilization_limit bigint(20)); 更新资源计划指令 dbms_resource_manager.update_plan_directive ( plan CHAR(128), group_or_subplan CHAR(128), new_comment VARCHAR(2000), new_mgmt_p1 bigint(20), new_utilization_limit bigint(20)); 删除资源计划指令 dbms_resource_manager.delete_plan_directive ( plan CHAR(128), group_or_subplan VARCHAR(128)); 查看资源计划指令 DBA_RSRC_PLAN_DIRECTIVES记录计划（plan）、消费组（consumer_group）的关联关系，以及对应消费组（consumer_group）的资源配置。 SELECT * FROM information_schema.DBA_RSRC_PLAN_DIRECTIVES; 对于共享租户，禁止使用； 参数说明： plan：plan的名称。 group_or_subplan：consumer_group的名称。 comment：资源计划指令的描述信息，可为''。 mgmt_p1：在系统满负载情况下，承诺分配给本消费组的CPU占比，取值范围[0, 100]，100表示使用租户100%的CPU。 utilization_limit：指定消费组使用的CPU资源的上限，取值范围为 [1, 100]。100表示最大可使用租户全部CPU资源，如果取值为70则表示最大可使用租户 70%的CPU资源。 删除正在启用的plan_directive, 将导致对应用户的资源配置失效。 同一消费组下的用户使用的资源总和不超过当前消费组的资源限制。例如：同一租户下有用户user1和user2，user1和user2属于consumer_group1，consumer_group1的UTILIZATION_LIMIT为70；则user1和user2实际使用的CPU资源总和最大为当前租户70%的CPU资源。

CPU使用率统计 用户级CPU使用率 新增information_schema.cpu_summary_by_user表显示当前租户下各用户的CPU使用信息，具体使用如下： SELECT * FROM information_schema.cpu_summary_by_user; 需要提前为当前用户（user）配置消费组（consumer_group）。 查询结果中的列名说明： TENANT_NAME：用户所属的租户名称。 USER_NAME：用户名称。 CPU_USAGE：用户CPU使用率，为用户实际使用的CPU占所在租户配置的MAX_CPU的比例。例如，当前租户的max_cpu为4U, 而用户实际用了2U， 那么CPU_USAGE为50%。 租户级CPU使用率 新增information_schema.cpu_summary_by_tenant表显示各租户的CPU使用信息，具体使用如下： SELECT * FROM information_schema.cpu_summary_by_tenant; 查询结果中的列名说明： TENANT_NAME：租户名称。 CPU_USAGE：租户CPU使用率，为租户实际使用的CPU占配置的MAX_CPU的占比。例如，当前租户的max_cpu为4U, 而租户实际用了2U， 那么CPU_USAGE为50%。

资源计划（plan）管理 通过租户下的用户连接数据库，进行资源计划管理。 创建资源计划 dbms_resource_manager.create_plan ( plan_name VARCHAR(128), comment VARCHAR(2000)); 启用资源计划 dbms_resource_manager.set_resource_manager_plan( plan_name VARCHAR(128)); 禁用资源计划 dbms_resource_manager.set_resource_manager_plan (''); 删除资源计划 dbms_resource_manager.delete_plan ( plan_name VARCHAR(128)); 查看资源计划 视图DBA_RSRC_PLANS记录当前计划（plan）的详细信息。 SELECT * FROM information_schema.DBA_RSRC_PLANS; 对于共享租户，禁止使用。 参数说明： plan_name：资源计划名称，仅支持包含大写字母、小写字母、数字或下划线。 comment：资源计划描述信息，可为''。 若删除当前启用的资源计划，则会将当前启用的资源计划设置为空，同时删除对应的资源计划指令（plan_directive）。 plan默认可配置的最大数量为128，由参数mt_resource_plan_num控制。

用户级资源配置 租户下的用户默认共享当前租户的资源，若要进行用户级资源限制，请使用本节提供的用户级资源配置接口。 资源消费组（consumer_group）管理 通过租户下的用户连接数据库，进行资源消费组管理。 创建消费组 dbms_resource_manager.create_consumer_group ( consumer_group CHAR(128), comment CHAR(2000)); 绑定消费组 consumer_group参数不为'' ，此时将用户和consumer_group绑定。 dbms_resource_manager.set_consumer_group_mapping ( attribute CHAR(128), value varbinary(128), consumer_group CHAR(128)); 解绑消费组 consumer_group参数为'' ，此时将用户和consumer_group解绑。 dbms_resource_manager.set_consumer_group_mapping ( attribute CHAR(128), value varbinary(128), ''); 删除消费组 dbms_resource_manager.delete_consumer_group ( consumer_group CHAR(128)); 查看消费组 视图DBA_RSRC_CONSUMER_GROUPS记录了所属租户（tenant）和消费组（consumer_group）的关联关系。 select * from information_schema.DBA_RSRC_CONSUMER_GROUPS; 查看消费组映射 视图DBA_RSRC_GROUP_MAPPINGS记录所属租户（tenant），用户（user）和消费组（consumer_group）的关联关系。 select * from information_schema.DBA_RSRC_GROUP_MAPPINGS; 对于共享租户，禁止使用。 参数说明： consumer_group：资源消费组名称，仅支持包含大写字母、小写字母、数字或下划线_，在解绑消费组时可设置为''。 comment：资源消费组说明，可为''。 attribute：要添加或修改的映射属性，当前版本仅支持USER。 value：要添加或修改的映射属性，当前版本仅支持用户名。 删除consumer_group的时候会同步删除该资源消费组对应的plan_directive以及consumer_group_mapping条目。 如果特性开关打开，删除用户时，也会删除此用户关联的消费组条目。 如果特性开关打开，重命名用户时，也会同步更新此用户关联的消费组条目。 重新打开特性，如果发现对应的用户已经无效，则自动删除这些无效的条目。 如果特性开关关闭后，删除用户，再创建同名用户，后续打开特性，该用户对应的条目会被保留。

用户管理 开启多租模式后，用户分为系统租户下的用户和普通租户下的用户。存量的用户均属于系统租户，新创的用户根据接口语义属于系统租户或者普通租户。 在系统租户下管理用户 创建用户 创建系统租户下的用户： CREATE user [IF NOT EXISTS] user_name@host; 创建普通租户下的用户： CREATE user [IF NOT EXISTS] 'user_name@tenant_name'@host; 重命名用户 重命名系统租户下的用户： RENAME USER user_from@host1 TO user_to@host2; 重命名普通租户下的用户： RENAME USER 'user_from@tenant_name'@host1 TO 'user_to@tenant_name'@host2; 删除用户 删除系统租户下的用户： DROP USER [IF EXISTS] user_name@host; 删除普通租户下的用户： DROP USER [IF EXISTS] 'user_name@tenant_name'@host; 授权用户 为用户user1@tenant_1授予租户tenant_1下的priv_type权限： GRANT priv_type ON *.* to 'user_1@tenant_1'@'%' with grant option; 查看权限： SHOW grants for 'user_1@tenant_1'; 在普通租户下管理用户 创建用户 创建当前租户下的用户： CREATE user [IF NOT EXISTS] user_name@host; 重命名用户 RENAME USER user_from@host1 TO user_to@host2; 删除用户 DROP USER [IF EXISTS] user_name@host; 授权用户 为用户user1授予当前租户下的priv_type权限： GRANT priv_type ON *.* to 'user_1'@'%' with grant option; 查看权限： SHOW grants for 'user_1'; 在系统租户下创建或删除普通租户下的用户时，需要以user_name@tenant_name的方式对用户进行操作。 普通租户下的用户名称的长度被限制为不超过20个字符。 租户内不可以创建部分特殊用户：mysql.sys, mysql.session, mysql.infoschema以及参数rds_reserved_users中保留的用户。 普通租户下的用户重命名时，需要保证user_from和user_to中的tenane_name相同，如不相同，则接口返错。 特性开关关闭时，无法重命名普通租户下的用户。

租户管理 创建租户时，需要绑定已经创建的资源配置（resource_config），以此限制该租户下用户使用的CPU资源。 创建租户 CREATE TENANT tenant_name RESOURCE_CONFIG config_name [COMMENT [=] 'comment_string']; 更改租户 ALTER TENANT tenant_name RESOURCE_CONFIG config_name [COMMENT [=] 'comment_string']; 删除租户 DROP TENANT tenant_name; 查看租户 SELECT * FROM information_schema.DBA_RSRC_TENANT; 仅在高权限root用户下可使用。 创建租户 tenant_name长度不超过10个字符，仅支持包含小写字母、数字或下划线_。 创建租户会进行资源约束检查，需要保证所有租户的资源配置中MIN_CPU之和满足资源约束。 更改租户resource_config 如果新绑定的resource_config的MIN_CPU值大于等于原有resource_config的MIN_CPU值时，会进行资源约束检查，需要保证所有租户的资源配置中MIN_CPU之和满足资源约束。 独占租户如果新绑定的resource_config的MIN_CPU值为0，会导致租户变为共享租户，将同时删除租户关联的用户级资源隔离相关的元数据。 删除租户 需要保证租户下的DB和用户已经被删除，否则，无法删除租户。 同时将删除租户关联的用户级资源隔离相关的配置。

数据库管理 数据库分为系统租户下的数据库和普通租户下的数据库。系统租户可以访问所有数据库，普通租户只能访问属于自己的数据库。 在系统租户下管理数据库 创建数据库 创建系统租户的数据库： CREATE DATABASE [IF NOT EXISTS] `db_name`; 创建普通租户的数据库： CREATE DATABASE [IF NOT EXISTS] `db_name@tanent_name`; 删除数据库 删除系统租户的数据库： DROP DATABASE [IF EXISTS] `db_name`; 删除普通租户的数据库： DROP DATABASE [IF EXISTS] `db_name@tanent_name`; 在普通租户下管理数据库 创建当前租户的DB： CREATE DATABASE [IF NOT EXISTS] 'db_name'; 删除当前租户的DB： DROP DATABASE [IF EXISTS] 'db_name'; 在系统租户下创建或删除普通租户下的DB时，需要以db_name@tenant_name的方式对DB进行操作。 普通租户当前只支持INFORMATION_SCHEMA系统库的访问，PERFORMANCE_SCHEMA、SYS、MYSQL等系统库暂不允许普通租户访问。 租户内不可以创建部分特殊DB：INFORMATION_SCHEMA, PERFORMANCE_SCHEMA, MYSQL, SYS, __recyclebin。 存量数据库分配租户 为保证兼容性，升级或者迁移到多租实例后，存量的DB默认属于系统租户，可以通过如下语法将存量的DB分配给租户。此外，对于已经开启多租特性后，系统租户创建的且未分配给普通租户的DB，也可通过如下语法分配数据库给对应租户。 数据库分配 将DB分配给租户名为tenant_name的普通租户 ALTER DATABASE db_name TENANT = `tenant_name`; 将DB回收到系统租户下 ALTER DATABASE db_name TENANT = ``; 查看映射关系 SELECT * FROM information_schema.DBA_RSRC_TENANT_DB; 仅在高权限root用户下可使用。 如果DB是开启多租后创建的，以db_name@tenant_name格式命名的DB不允许分配调用此接口，接口会返错。 如果tenant不存在，且不为空，接口返错。 通过租户下的用户连接数据库 在系统租户下，原有连接方式不变。 在普通租户下，指定用户时，需要以user_name@tenant_name的形式；指定DB时，支持db_name和db_name@tenant_name两种形式。 mysql --host=**** -u user1@tenant_1 -D db1 -p pwssword; mysql --host=**** -u user1@tenant_1 -D db1@tenant_1 -p pwssword; 连接成功后，该用户将受到对应租户下的资源限制。

使用须知 多租户管理与资源隔离功能支持租户级数据隔离、租户级CPU资源隔离、用户级CPU资源隔离。 多租户管理与资源隔离功能需要GaussDB(for MySQL)实例内核版本为2.0.54.240600及以上。 开启多租户管理与资源隔离前必须开启thread pool功能。 开启多租户管理与资源隔离功能前，要求实例中的数据库名称和用户名称不能包含@字符。 Serverless不支持多租户管理与资源隔离功能。 租户跨实例迁移： 开启多租户管理与资源隔离功能后，DRS迁移可以迁移所有租户下的数据，但DRS不会同步多租元数据，故租户信息不会被同步到目标端。如果需要迁移某个租户到另一个实例，需要遵循以下步骤： 目标端需要使用具备多租特性的实例，首先在目标端手动创建租户。 使用DRS数据同步功能创建库级同步任务（如果源端和目标端租户名有改动，则这里需要改动目标端库名）。 进行同步。 Binlog： 目前Binlog没有实现租户隔离，如果允许普通租户拉取Binlog会破坏租户间数据隔离，因此当前禁止普通租户下的用户拉取Binlog。 本特性引入的租户和资源隔离相关接口，记录的Binlog为row格式。在binlog_format不为row的情况下，通过Binlog进行同步，将无法同步租户及资源配置信息。 Proxy： 支持带Proxy使用，带Proxy使用时show processlist显示结果是节点级别。 因HTAP标准版和轻量版不支持带@字符的数据库，普通租户下的数据库迁移到该类HTAP引擎时会更改目标端库名，但Proxy的自动行存/列存引流功能要求源端和目标端的库名一致，因此普通租户创建的数据库将无法使用Proxy的自动行存/列存引流功能。 备份恢复： 恢复已打开多租开关的多租实例数据到新实例，未开启多租开关下，新实例不支持创建带@的用户和DB。 兼容性： 先开启后关闭多租开关，创建DB和用户时，名称中不能包含@字符。 普通租户下，数据库名称最大长度由64降低为50，用户名称最大长度由32降低为20。 当前仅支持普通租户访问information_schema，其他系统库暂不开放给普通租户。 普通租户不支持tablespace相关语法。

资源管理 资源配置（resource_config）和租户是一对多的关系，当某一租户绑定此资源配置时便可限制此租户下用户使用的CPU资源。 创建资源配置 CREATE resource_config config_name MAX_CPU [=] {max_cpu_value} [MIN_CPU [=] {min_cpu_value}]; 更新资源配置 ALTER resource_config config_name MAX_CPU [=] {max_cpu_value} [MIN_CPU [=] {min_cpu_value}]; 删除资源配置 DROP resource_config config_name; 查看资源配置 SELECT * FROM information_schema.DBA_RSRC_TENANT_RESOURCE_CONFIGS; 仅在高权限root用户下可使用。 参数说明： config_name： 资源配置名称。最大长度为64，仅支持包含大写字母、小写字母、数字或下划线。 MAX_CPU：该资源配置能够使用的CPU的最大数量，最小值为0.1，最大值为mt_flavor_cpu。粒度0.1U。 MIN_CPU：该资源配置能够使用的CPU的最小数量，为可选项。默认等于MAX_CPU，最小值为0，最大值不超过MAX_CPU。粒度为0.1U。如果设置为0，表示该租户为共享租户，如果大于0则为独占租户。 更新resource_config时，如果该resource_config已经绑定租户，且更新后MIN_CPU值大于原有的MIN_CPU值，则需要校验修改后的值是否满足资源约束，否则不做资源约束校验。 删除resource_config时，若租户正在使用该资源配置，则无法进行删除操作。 实际使用中，共享租户的资源分配不依赖MAX_CPU，是随机争夺资源的。 CPU争抢时，租户间资源分配会尽量按照租户的MIN_CPU分配资源，但存在一定的误差，误差通常在1U以内。 租户性能比同等规格实例性能低，实际使用中多个租户抢占资源性能将更低。

其他操作和检查 主从实例分别是独立的GaussDB(for MySQL)数据库集群，主从切换和故障转移不会交换主从间的各种配置，为了避免配置参数不同引起的性能和兼容性等问题，建议在主从切换和故障转移后检查主从实例的配置项差异。 检查应用程序读取/写入地址 主从切换和故障转移不会切换实例的读写地址，需要检查应用程序的读写地址是否符合预期。 故障转移期间，可以配置应用程序使用新的主实例的读写地址，等待故障实例重建完成后重新配置应用程序的读写地址。 检查备机支持写转发配置，请参考从实例写转发。 检查参数组参数配置，请参考修改GaussDB(for MySQL)实例参数。 配置监控告警，请参考监控指标与告警。 如果操作前主实例关联了数据库代理或者HTAP分析节点，需要手动移除。