华为云用户手册

使用限制 当前版本支持分区级MDL锁功能，包括DROP PARTITION操作、RANGE和LIST分区方式的ADD PARTITION操作。 DROP PARTITION操作和ADD PARTITION操作仅支持inplace算法，不支持copy算法。 由于隔离级别可以设置为会话级别，如果transaction_isolation设置为REPEATABLE-READ或更高的隔离级别，在并发执行DDL过程中，可能会出现如下报错： ERROR HY000: Table definition has changed, please retry transaction。 这是正常现象，因为事务访问到了DDL创建的新分区。可以通过重新执行事务来解决这个问题。

语法 创建一个或多个LIST-RANGE分区表，其中每个分区可能有一个或一个以上的子分区。 CREATE TABLE [ schema. ]table_name table_definition PARTITION BY LIST {(expr) | COLUMNS(column_list)} SUBPARTITION BY RANGE {(expr) | COLUMNS(column_list)} (partition_definition [, partition_definition] ...); 其中，partition_definition为： PARTITION partition_name VALUES IN (value_list) (subpartition_definition [, subpartition_definition] ...) subpartition_definition为： SUBPARTITION subpartition_name VALUES LESS THAN {value | value_list | MAXVALUE} 表1 参数说明 参数名称 描述 expr 分区字段表达式。目前只支持INT类型，不支持字符类型。 column_list LIST COLUMNS的情况下使用，分区字段列表，不支持表达式。 value 分区边界值。 value_list LIST COLUMNS的情况下使用，多个字段的边界值。 MAXVALUE 最大值。 partition_name 分区名称，同一个表中不可重复。 subpartition_name 子分区名称， 同一个表中不可重复。

性能测试 TaurusDB执行耗时2.7秒完成，只需要扫描约61万行数据。相比MySQL 8.0 社区版本执行耗时约186秒，扫描数据量4400万，执行效率大大提升。 如下示例中，对7个表连接后的结果做DISTINCT，使用MySQL 8.0.30社区版本，执行耗时186秒，扫描了约4400万行数据。 TaurusDB执行耗时2.7秒，扫描约61万行数据。 查询语句： select distinct ed.code,et.*from ele_template etleft join ele_template_tenant ett on ett.template_id = et.idleft join ele_relation tm on tm.tom_id = et.id and tm.jerry_type = 'chapter'left join ele_relation mv on mv.tom_id = tm.jerry_id and mv.jerry_type = 'variable'left join ele_relation cv on cv.jerry_id = mv.jerry_id and cv.tom_type = 'column'left join ele_doc_column edc on edc.id = cv.tom_idleft join ele_doc ed on ed.id = edc.doc_idwhere ett.uctenantid = 'mmo0l3f8'and ed.code = 'contract'and et.billtype = 'contract'order by ifnull(et.utime,et.ctime)desc limit 0,10;

使用示例 HASH-LIST类型的使用示例 CREATE TABLE tbl_hash_list( col1 INT, col2 INT, col3 varchar(20), col4 DATE)PARTITION BY HASH(col1)SUBPARTITION BY LIST(col2)( PARTITION dp0 ( SUBPARTITION p0 VALUES in (1, 2), SUBPARTITION p1 VALUES in (3, 4), SUBPARTITION p2 VALUES in (5, 6) ), PARTITION dp1 ( SUBPARTITION p3 VALUES in (1, 2), SUBPARTITION p4 VALUES in (3, 4), SUBPARTITION p5 VALUES in (5, 6) ), PARTITION dp2 ( SUBPARTITION p6 VALUES in (1, 2), SUBPARTITION p7 VALUES in (3, 4), SUBPARTITION p8 VALUES in (5, 6) ));

语法 创建一个或多个HASH-LIST分区表，其中每个分区可能有一个或一个以上的子分区。 CREATE TABLE [ schema. ]table_name table_definition PARTITION BY [LINEAR] HASH(expr) SUBPARTITION BY LIST {(expr) | COLUMNS(column_list)} (partition_definition [, partition_definition] ...); 其中，partition_definition为： PARTITION partition_name (subpartition_definition [, subpartition_definition] ...) subpartition_definition为： SUBPARTITION subpartition_name VALUES IN (value_list) 表1 参数说明 参数名称 描述 table_name 要创建的表名称。 expr 分区字段表达式，目前只支持INT类型，不支持字符类型。 column_list LIST COLUMNS的情况下使用，分区字段列表，不支持表达式。 value_list LIST COLUMNS的情况下使用，多个字段的边界值。 partition_name 分区名称，同一个表中不可重复。 subpartition_name 子分区名称，同一个表中不可重复。

开启多表连接DISTINCT优化 表1 参数说明 参数名称 级别 描述 rds_nlj_distinct_optimize Global，Session DISTINCT优化特性开关，默认值为OFF。 ON：开启DISTINCT优化特性。 OFF：关闭DISTINCT优化特性。 除了使用上述开关来控制优化特性生效或者不生效，还可以使用HINT来实现，语法如下。 开启DISTINCT优化特性 /*+ SET_VAR(rds_nlj_distinct_optimize=ON) */ 关闭 DISTINCT 优化特性 /*+ SET_VAR(rds_nlj_distinct_optimize=OFF) */

使用示例 RANGE-RANGE类型的使用示例 CREATE TABLE tbl_range_range (col1 INT, col2 INT, col3 varchar(20))PARTITION BY RANGE(col1)SUBPARTITION BY RANGE(col2)( PARTITION p0 VALUES LESS THAN (1000) ( SUBPARTITION s0 VALUES LESS THAN(100), SUBPARTITION s1 VALUES LESS THAN(MAXVALUE) ), PARTITION p1 VALUES LESS THAN (2000) ( SUBPARTITION s2 VALUES LESS THAN(100), SUBPARTITION s3 VALUES LESS THAN(200) ), PARTITION p2 VALUES LESS THAN (MAXVALUE) ( SUBPARTITION s4 VALUES LESS THAN(200), SUBPARTITION s5 VALUES LESS THAN(400) )); RANGE COLUMNS-RANGE类型的使用示例 CREATE TABLE tbl_range_col_range (col1 INT, col2 INT, col3 INT)PARTITION BY RANGE COLUMNS(col1, col2)SUBPARTITION BY RANGE(col3)( PARTITION p1 VALUES LESS THAN(1000, MAXVALUE)( SUBPARTITION s0 VALUES LESS THAN(100), SUBPARTITION s1 VALUES LESS THAN(MAXVALUE) ), PARTITION p2 VALUES LESS THAN(2000, MAXVALUE)( SUBPARTITION s2 VALUES LESS THAN(100), SUBPARTITION s3 VALUES LESS THAN(200) ), PARTITION p3 VALUES LESS THAN(MAXVALUE, MAXVALUE)( SUBPARTITION s4 VALUES LESS THAN(200), SUBPARTITION s5 VALUES LESS THAN(400) ));

语法 创建一个或多个RANGE-RANGE分区表，其中每个分区可能有一个或一个以上的RANGE类型的子分区。 CREATE TABLE ... PARTITION BY RANGE {(expr) | COLUMNS(column_list)} SUBPARTITION BY RANGE {(expr) | COLUMNS(column_list)}[(partition_definition [, partition_definition] ...)]; 其中，partition_definition为： PARTITION partition_name VALUES LESS THAN {(value | MAXVALUE | value_list) | MAXVALUE}[(subpartition_definition [, subpartition_definition] ...)] subpartition_definition为： SUBPARTITION subpartition_name VALUES LESS THAN {value | value_list | MAXVALUE} 表1 参数说明 参数名称 描述 expr 分区字段表达式。目前只支持INT类型，不支持字符类型。 column_list RANGE COLUMNS的情况下使用。分区字段列表，不支持表达式，可以支持多列。 value 分区边界值。 value_list RANGE COLUMNS的情况下使用，多个字段的边界值。 MAXVALUE 最大值。 partition_name 分区名称，同一个表中不可重复。 subpartition_name 子分区名称， 同一个表中不可重复。

创建INTERVAL RANGE分区表 INTERVAL RANGE分区表定义格式类似于RANGE分区表，但多了INTERVAL子句。 语法： CREATE TABLE [IF NOT EXISTS] [schema.]table_nametable_definitionpartition_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）的进一步说明：

INTERVAL RANGE分区表与任意类型表的相互转换 语法： 其他类型表转化为INTERVAL RANGE分区表。 ALTER TABLE table_name table_definitionpartition_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]; 示例： 将其他类型表转为INTERVAL RANGE表： CREATE TABLE orders( orderkey BIGINT NOT NULL, custkey BIGINT NOT NULL, orderdate DATE NOT NULL);​ALTER TABLE ordersPARTITION 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));

使用限制 INTERVAL RANGE表只支持HASH/KEY二级分区。 采取RANGE COLUMNS(column_list) INTERVAL([type], value)形式描述INTERVAL RANGE规则时： 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 RANGE规则时，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的约束。

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表）。

工作原理 云数据库TaurusDB采用计算与存储分离的架构，以减少网络流量为主要架构准则，通过NDP设计将该准则应用到查询操作。没有NDP之前，查询处理需要将原始数据从存储节点全部传输到计算节点。通过NDP设计，查询中的I/O密集型和CPU密集型的大部分工作被下推到存储节点完成，仅将所需列及筛选后的行或聚合后的结果值回传给计算节点，使网络流量大幅减少。同时跨存储节点并行处理，使计算节点CPU使用率下降，提升了查询效率性能。 另外，NDP框架同TaurusDB并行查询进行融合，并进行了页面批量预取的设计，达成执行全流程并行，进一步提升查询执行效率。

参数说明 表1 参数说明 参数名 级别 描述 ndp_mode Global、Session NDP特性开关，OFF表示特性关闭，ON表示特性在主机和只读节点开启，REPLICA_ON表示特性只在只读节点开启。 取值范围：OFF/ON/REPLICA_ON 默认取值：OFF ndp_support_features Global、Session NDP支持的特性 COUNT，是否将COUNT聚合运算通过NDP下推至存储计算 MIN，是否将MIN聚合运算通过NDP下推至存储计算 MAX，是否将MAX聚合运算通过NDP下推至存储计算 AVG，是否将AVG聚合运算通过NDP下推至存储计算 SUM，是否将SUM聚合运算通过NDP下推至存储计算 GROUP_BY，是否将GROUP BY分组相关聚合运算通过NDP下推至存储计算 Partition_Table，针对分区表，NDP下推是否生效 Instant_Column_Table，针对快速加列的表，NDP是否生效 Bloom_filter，针对Hash Join，是否将Hash Table通过NDP下推至存储提前过滤 取值范围：COUNT,MIN,MAX,AVG,SUM,GROUP_BY,Partition_Table,Instant_Column_Table,Bloom_filter 默认取值：COUNT,SUM

功能介绍 TaurusDB分区表完全兼容社区MySQL的语法和功能。同时，TaurusDB分区表相对于社区MySQL进行了功能增强，支持丰富的分区表类型及组合，使您可以更加便携、简单和高效的使用分区表。 TaurusDB兼容的社区MySQL分区表类型如下： HASH KEY RANGE LIST RANGE-HASH RANGE-KEY LIST-HASH LIST-KEY 组合分区由一级分区（主分区）和二级分区（子分区）组成。 TaurusDB组合分区功能支持的分区表类型如下： RANGE-RANGE RANGE-LIST LIST-RANGE LIST-LIST HASH-HASH HASH-KEY HASH-RANGE HASH-LIST KEY-KEY KEY-HASH KEY-RANGE KEY-LIST 父主题： 二级分区

更改样式 支持在settings.json文件里自定义Terminal的样式，如：字体大小、行间距等。可参考以下参数项进行配置： terminal.integrated.fontFamily terminal.integrated.fontSize terminal.integrated.fontWeight terminal.integrated.fontWeightBold terminal.integrated.letterSpacing terminal.integrated.lineHeight

语法 创建一个或多个KEY-LIST分区表，其中每个分区可能有一个或一个以上的子分区。 CREATE TABLE [ schema. ]table_name table_definition PARTITION BY [LINEAR] KEY(expr) SUBPARTITION BY LIST {(expr) | COLUMNS(column_list)} (partition_definition [, partition_definition] ...); 其中，partition_definition为： PARTITION partition_name (subpartition_definition [, subpartition_definition] ...) subpartition_definition为： SUBPARTITION subpartition_name VALUES IN (value_list) 表1 参数说明 参数名称 描述 table_name 要创建的表名称。 expr 分区字段表达式，目前只支持INT类型，不支持字符类型。 column_list LIST COLUMNS的情况下使用，分区字段列表，不支持表达式。 value_list 字段的值。 partition_name 分区名称，同一个表中不可重复。 subpartition_name 子分区名称，同一个表中不可重复。

使用示例 KEY-LIST类型的使用示例 CREATE TABLE tbl_key_list( col1 INT, col2 INT, col3 varchar(20), col4 DATE)PARTITION BY KEY(col1)SUBPARTITION BY LIST(col2)( PARTITION dp0 ( SUBPARTITION p0 VALUES in (1, 2), SUBPARTITION p1 VALUES in (3, 4), SUBPARTITION p2 VALUES in (5, 6) ), PARTITION dp1 ( SUBPARTITION p3 VALUES in (1, 2), SUBPARTITION p4 VALUES in (3, 4), SUBPARTITION p5 VALUES in (5, 6) ), PARTITION dp2 ( SUBPARTITION p6 VALUES in (1, 2), SUBPARTITION p7 VALUES in (3, 4), SUBPARTITION p8 VALUES in (5, 6) ));

使用示例 RANGE-LIST类型的使用示例 CREATE TABLE tbl_range_list (col1 INT, col2 INT, col3 varchar(20))PARTITION BY RANGE(col1) SUBPARTITION BY LIST(col2)( PARTITION m1 VALUES LESS THAN(1000) ( SUBPARTITION p0 VALUES in (1, 2),SUBPARTITION p1 VALUES in (3, 4),SUBPARTITION p2 VALUES in (5, 6) ), PARTITION m2 VALUES LESS THAN(2000) ( SUBPARTITION p3 VALUES in (1, 2),SUBPARTITION p4 VALUES in (3, 4),SUBPARTITION p5 VALUES in (5, 6) ), PARTITION m3 VALUES LESS THAN(MAXVALUE) ( SUBPARTITION p6 VALUES in (1, 2),SUBPARTITION p7 VALUES in (3, 4),SUBPARTITION p8 VALUES in (5, 6) )); RANGE COLUMNS-LIST类型的使用示例 CREATE TABLE tbl_range_columns_list( col1 INT, col2 INT, col3 varchar(20), col4 DATE)PARTITION BY RANGE COLUMNS(col4)SUBPARTITION BY LIST(col1)( PARTITION dp1 VALUES LESS THAN('2023-01-01')( SUBPARTITION p0 VALUES in (1, 2), SUBPARTITION p1 VALUES in (3, 4), SUBPARTITION p2 VALUES in (5, 6) ), PARTITION dp2 VALUES LESS THAN('2024-01-01')( SUBPARTITION p3 VALUES in (1, 2), SUBPARTITION p4 VALUES in (3, 4), SUBPARTITION p5 VALUES in (5, 6) ), PARTITION dp3 VALUES LESS THAN('2025-01-01')( SUBPARTITION p6 VALUES in (1, 2), SUBPARTITION p7 VALUES in (3, 4), SUBPARTITION p8 VALUES in (5, 6) ));

语法 创建一个或多个HASH-KEY分区表，其中每个分区可能有一个或一个以上的子分区。 CREATE TABLE [ schema. ]table_name table_definition PARTITION BY [LINEAR] HASH(expr) [PARTITIONS num] SUBPARTITION BY [LINEAR] KEY(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类型，不支持字符类型。 partition_name 分区名称，同一个表中不可重复。 subpartition_name 子分区名称，同一个表中不可重复。

语法 创建一个或多个RANGE-LIST分区表，其中每个分区可能有一个或一个以上的子分区。 CREATE TABLE ... PARTITION BY RANGE {(expr) | COLUMNS(column_list)} SUBPARTITION BY LIST {(expr) | COLUMNS(column_list)}[(partition_definition [, partition_definition] ...)]; 其中，partition_definition为： PARTITION partition_name VALUES LESS THAN {(value | value_list) | MAXVALUE}[(subpartition_definition [, subpartition_definition] ...)] subpartition_definition为： SUBPARTITION subpartition_name VALUES IN {(value | value_list)} 表1 参数说明 参数名称 描述 expr 分区字段表达式。目前只支持INT类型，不支持字符类型。 column_list RANGE COLUMNS的情况下使用。分区字段列表，不支持表达式，可以支持多列。 value 分区边界值。 value_list RANGE COLUMNS的情况下使用，多个字段的边界值。 MAXVALUE 最大值。 partition_name 分区名称，同一个表中不可重复。 subpartition_name 子分区名称， 同一个表中不可重复。

语法 扩展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]}

特性参数说明 表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 是

使用须知 TaurusDB实例内核版本大于等于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语句中存在压缩字段会导致迁移任务失败。 物理备份方面，利用备份去做数据恢复的版本也必须是带有字段压缩特性的。 升级至新版本之后，如果已经使用字段压缩功能，不支持回退至无该特性的版本。

性能测试 测试环境 实例规格：8U32GB、32U128GB E CS 规格：32U64GB 测试环境：华北-北京四 测试工具：sysbench-1.0.18 数据模型： 1张表，1条数据。 8张表，每张表1条数据。 参数配置 rds_hotspot=ON transaction_isolation=READ-COMMITTED max_prepared_stmt_count=1048576 rds_global_sql_log_bin=OFF 测试方法 测试所需数据表定义： CREATE TABLE sbtest (id int NOT NULL AUTO_INCREMENT,k int NOT NULL DEFAULT '0',PRIMARY KEY (id)); 测试语句： UPDATE sbtest%u SET k=k+1 WHERE id=1 hotspot； 测试场景和测试结果 测试场景1：8U32GB实例单个热点行更新 测试结果：所有并发均有不同程度提升，64并发及以下并发提升不明显，128并发及以上并发提升明显，最高提升9.26倍。 测试场景2：32U128GB实例单个热点行更新 测试结果：128并发及以上并发提升明显，最高提升639倍。 测试场景3：32U 128GB实例8个热点行更新 测试结果：256及以下并发无提升，512及以上并发提升效果明显，最高提升78倍。

使用示例 创建表，准备数据。 CREATE TABLE test.hotspot1 ( `id` int NOT NULL primary key, `c` int NOT NULL DEFAULT '0') ENGINE=InnoDB;INSERT INTO test.hotspot1 VALUES (1, 1); 打开热点行更新开关。 SET GLOBAL rds_hotspot = ON; 修改隔离级别，AUTOCOMMIT。 SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED;SET SESSION AUTOCOMMIT = ON; 发起带HOTSPOT关键字的更新。 UPDATE test.hotspot1 SET c=c+1 WHERE id=1 HOTSPOT; 检查热点行更新状态。 SHOW STATUS like "%hotspot%";

新增关键字 新增标记语句的关键字如下： 表3 新增关键字 关键字 描述 HOTSPOT 表示开启热点更新功能。 NOT_MORE_THAN 可选项。表示目标值不大于某值。 NOT_LESS_THAN 可选项。表示目标值不小于某值。 上述关键字放置在SQL语句末尾。HOTSPOT必须在最前面，NOT_MORE_THAN和NOT_LESS_THAN没有位置前后的要求。 例如：假设id是主键列，c是int类型列，那么支持以下语法： UPDATE c=c+1 where id=10 HOTSPOT;UPDATE c=c+1 where id=10 HOTSPOT NOT_MORE_THAN 100; // c值不大于100UPDATE c=c-1 where id=10 HOTSPOT NOT_LESS_THAN 0; // c值不小于0UPDATE c=c+1 where id=10 HOTSPOT NOT_MORE_THAN 100 NOT_LESS_THAN 0; // c值不大于100，不小于0UPDATE c=c+1 where id=10 HOTSPOT NOT_LESS_THAN 0 NOT_MORE_THAN 100; // c值不大于100，不小于0 当超过NOT_MORE_THAN或者NOT_LESS_THAN的限制时，会向客户端报如下错误： HOTSPOT field value exceeds limit

状态说明 表2 状态说明 状态 说明 Hotspot_total_trx 使用hotspot总事务数 Hotspot_update_errors 更新阶段出错的热点行更新事务，这些出错的事务只会自己更新失败，不会影响其他热点行更新事务的提交。 Hotspot_trx_rollbacked 更新成功，但是由于最终回滚的热点行更新事务数量。当队长（leader）决定回滚时，所有组员（follower）跟着一起回滚。 Hotspot_trx_committed 提交成功的热点行更新事务数量。 Hotspot_batch_size 热点行更新事务分批次提交。该值表示当前批次热点行更新事务的数量。 Hotspot_batch_wait_time 热点行更新按批次持有锁和提交事务。此时间为当前热点行更新批次等待上一批次释放锁的时间，单位微秒。 Hotspot_leader_wait_follower_time 在一个批次中leader需要等待follower完成记录更新，此时间为当前批次leader等待follower的时间，单位微秒。 Hotspot_leader_total_time 当前批次leader的热点行更新事务总时间，单位微秒。 Hotspot_follower_total_time 当前批次某一个follower的热点行更新事务总时间，单位微秒。 Hotspot_follower_wait_commit_time 在一个批次中follower需要等待leader持久化日志，此时间为当前批次某一个follower等待leader持久化日志的时间，单位微秒。 Hotspot_group_counts 每个热点行更新对应一个组，组内事务分批次提交。该值为使用热点行更新的组数。 Hotspot_counter_counts counter用于自动判断热点行更新。当counter中的统计值满足要求时，将会创建group使用热点行更新。该值为counter的总数。

约束与限制 TaurusDB实例的内核版本为2.0.54.240600及以上时支持使用该功能。 功能使用约束如下： where条件中只能使用主键或唯一索引的等值匹配，并且只能更新单条记录。否则将绕过优化正常更新。 不允许修改索引列，否则将绕过优化正常更新。 只对修改列为整数的更新生效，否则将绕过优化正常更新。 只允许对热点行记录进行两个元素的加减操作，且第一个元素与等号左侧相等并满足唯一索引等约束，不允许赋值操作。假设c列为待修改列，d为记录的普通列，那么只允许进行类似c=c+1，或者c=c-1的操作，不允许进行c=d+1，c=1+c，c=c+1+1，c=1+c+1等操作。否则将绕过优化正常更新。 只允许对隐式事务生效。即要求AUTOCOMMIT为ON，并且不在BEGIN，COMMIT显示开启的事务中使用。否则将绕过优化正常更新。 需要使用HOTSPOT显式标记热点行更新事务，或者将rds_hotspot_auto_detection_threshold设置为非0，开启热点行更新自动识别功能。否则将绕过优化正常更新。rds_hotspot_auto_detection_threshold的详细用法请见参数说明。 只对RC级别生效。数据库处于其他隔离级别时将绕过优化正常更新。 无法在stored function, trigger以及event中使用，否则将对客户端报如下错误： HOTSPOT hints can not be used in stored function, trigger or event 行为变更： 一个hotspot事务组内，除了执行失败或者在更新阶段killed的事务外，其他事务被按批次集中提交，集中记录redo log和undo log，只能集中提交或者回滚，无法单独回滚。每个批次提交的事务个数为几十到几百个不等。

参数说明 表1 参数说明 参数名称 参数说明 rds_hotspot 热点行更新优化开关。将其设置为ON将启用热点行更新优化。 rds_hotspot_follower_wait_commit_interval 热点行更新follower事务等待leader事务日志持久化时，进入阻塞前的睡眠时间。单位：微秒。对日志持久化速度慢的实例，建议调大。对于持久化快速的实例，建议设置为0，不休眠直接阻塞。 rds_hotspot_leader_wait_follower_interval 热点行更新leader事务等待follower更新记录的时间单位。单位：微秒。低并发适当调低可以避免性能下降。高并发适当调高可以提升性能。当QPS超过20w时，建议将该值设置为100或者更大。 rds_hotspot_auto_detection_threshold 热点行更新的自动识别功能开关。设置为0表示不启用自动识别功能。设置为非0表示热点行更新的识别阈值。当某个符合热点行要求的行每秒更新次数超过阈值时将启动热点行更新功能。 rds_hotspot_batch_size_lower_limit 每批热点事务大小的建议最小值。每个batch尽可能达到该大小。但是，这并不是严格保证的。当leader发现所有需要等待的follower都已经到达时，batch就进入提交状态。 rds_hotspot_max_memory_size 热点行更新中group和counter占用的内存上限。当group占用的内存超过限制时，将清空group所占用的内存。当counter占用的内存超过限制时，将清空counter所占用的内存。申请新的内存时才会尝试清空旧内存。 rds_hotspot_enable_time_statistics 是否开启热点行更新的时间相关的状态统计功能。将其设置为ON以启用该功能。