华为云用户手册

注意事项 当有对应的小版本更新时（定期同步开源社区问题、漏洞修复），请及时手动立即升级或者设置可维护时间段升级小版本。 升级数据库内核小版本会重启 GaussDB (for MySQL)实例，服务可能会出现闪断，请您尽量在业务低峰期执行该操作，或确保您的应用有自动重连机制。 如果实例有大量表分区（100w+），重启实例时间可能会达到2小时以上。 如果数据库内核从8.0.18升级到8.0.22版本，分区数大于1000时可能会升级失败，请升级之前联系华为云工程师协助检查版本兼容性。 如果主节点和只读节点在同一个AZ，升级内核小版本会触发一次主备倒换；如果在不同AZ，则会触发两次主备倒换。主备倒换指主节点与只读节点进行切换。 升级实例小版本时，如有只读节点，也会同步升级只读节点的小版本，升级完成会重启实例，请您选择合适的时间升级（不支持单独升级只读实例的小版本）。升级内核小版本后，实例会升级到最新的内核小版本，升级成功，无法降级。 小版本升级过程中禁止event的ddl操作，如create event、drop event和alter event。 如果只读节点到主节点的复制延迟大于300秒，则无法升级小版本。

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

使用示例 KEY-RANGE类型的使用示例 CREATE TABLE tbl_key_range ( col1 INT, col2 INT, col3 varchar(20), col4 DATE ) PARTITION BY KEY(col1) SUBPARTITION BY RANGE COLUMNS(col4) ( PARTITION p0( SUBPARTITION p0_q1_2023 VALUES LESS THAN('2023-04-01'), SUBPARTITION p0_q2_2023 VALUES LESS THAN('2023-07-01'), SUBPARTITION p0_q3_2023 VALUES LESS THAN('2023-10-01'), SUBPARTITION p0_q4_2023 VALUES LESS THAN('2024-01-01') ), PARTITION p1( SUBPARTITION p1_q1_2023 VALUES LESS THAN('2023-04-01'), SUBPARTITION p1_q2_2023 VALUES LESS THAN('2023-07-01'), SUBPARTITION p1_q3_2023 VALUES LESS THAN('2023-10-01'), SUBPARTITION p1_q4_2023 VALUES LESS THAN('2024-01-01') ), PARTITION p2( SUBPARTITION p2_q1_2023 VALUES LESS THAN('2023-04-01'), SUBPARTITION p2_q2_2023 VALUES LESS THAN('2023-07-01'), SUBPARTITION p2_q3_2023 VALUES LESS THAN('2023-10-01'), SUBPARTITION p2_q4_2023 VALUES LESS THAN('2024-01-01') ) );

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

操作场景 创建GaussDB(for MySQL)数据库实例时，系统默认开启自动备份策略，暂不支持关闭。实例创建成功后，您可根据业务需要设置自动备份策略。GaussDB(for MySQL)按照用户设置的自动备份策略对数据库进行备份。 GaussDB(for MySQL)的备份操作是实例级的，而不是数据库级的。当数据库故障或数据损坏时，可以通过备份恢复数据库，从而保证数据可靠性。由于开启备份会损耗数据库读写性能，建议您选择业务低峰时间段启动自动备份。 设置自动备份策略后，会按照策略中的备份时间段和备份周期进行全量备份。实例在执行备份时，按照策略中的保留天数进行存放，备份时长和实例的数据量有关。 在进行全量备份的同时系统每5分钟会自动生成增量备份，用户不需要设置。生成的增量备份可以用来将库表数据恢复到指定时间点。

前提条件 GaussDB(for MySQL)实例需要按照表1进行参数设置。 表1 参数说明 参数名称 参数值 修改方式 default_authentication_plugin mysql_native_password 修改实例参数 binlog_expire_logs_seconds 86400 说明： Binlog的保留时间建议大于1天：60（秒）*60（分钟）*24（小时）=86400，防止由于binlog时间设置过短，导致增量复制失败。 修改实例参数 log_bin 说明： GaussDB(for MySQL)内核版本小于2.0.45.230900时，使用该参数。 ON GaussDB(for MySQL)服务如何开启binlog？ rds_global_sql_log_bin 说明： GaussDB(for MySQL)内核版本大于或等于2.0.45.230900时，使用该参数。 ON GaussDB(for MySQL)服务如何开启binlog？ binlog_format ROW 通过“SHOW VARIABLES;”命令查看参数的值，如需修改，请联系客服人员修改。 binlog_row_image FULL 通过“SHOW VARIABLES;”命令查看参数的值，如需修改，请联系客服人员修改。 log_bin_use_v1_row_events OFF 通过“SHOW VARIABLES;”命令查看参数的值，如需修改，请联系客服人员修改。 GaussDB(for MySQL)实例已创建数据库和表。

备份类型 GaussDB(for MySQL)支持的备份有很多种，根据不同维度，有如下分类。 按照数据量：分为全量备份和增量备份。 表1 全量备份和增量备份对比 备份类型 全量备份 增量备份 描述 全量备份是备份数据库所有数据。 增量备份是备份某个时间段内变化的数据。 是否默认开启 是 是 保留时长 如果在新的全量备份未超过保留天数前系统会一直保留，直至新的全量备份超过保留天数后才会删除。 超出备份保留天数的会自动被删除。 特点 对当前状态下的数据库实例中的所有数据进行一次完整的备份。 用户可在任意时刻使用全量备份恢复创建备份时的完整数据。 包含自动备份和手动备份。 系统自动每5分钟或一定数据量时会对上一次自动备份或增量备份后更新的数据进行备份。 全部为自动备份。 查看备份大小 单击实例名称，在“备份恢复”的“全量备份”页签查看备份大小。 单击实例名称，在“备份恢复”的“增量备份”页签查看备份大小。 按照执行方式：分为手动备份和自动备份。 表2 手动备份和自动备份对比 备份类型 自动备份 手动备份 是否默认开启 是 是 保留时长 1～732天 说明： 备份保留时长可联系客服申请开通至最大3660天。 一直保存，直到用户手动删除。 特点 根据您指定的备份保留期保存数据库实例的自动备份。 手动备份是由用户启动的数据库实例的全量备份，会一直保存，直到用户手动删除。 设置方法 设置自动备份策略 创建手动备份 按照备份区域：分为同区域备份和跨区域备份。 设置跨区域备份策略需要开通白名单，请联系客服人员申请权限。 表3 同区域备份和跨区域备份对比 备份类型 同区域备份 跨区域备份 描述 备份存储在同一个区域。 备份存储在除当前区域外的其他区域。 是否默认开启 是 否 保留时长 1～732天 说明： 备份保留时长可联系客服申请开通至最大3660天。 1～1825天 特点 支持将备份文件存放到和实例相同的区域存储，系统默认开启自动备份（同区域）策略，暂不支持关闭。 支持将备份文件存放到另一个区域存储，开启跨区域备份策略后，会自动将该实例的备份文件备份到目标区域。 设置方法 设置同区域备份策略 设置跨区域备份策略 查看备份大小 已开通跨区域备份白名单 单击“备份恢复管理”，在“数据库同区域备份”页签查看目标实例的备份大小。 未开通跨区域备份白名单 单击“备份恢复管理”，查看目标实例的备份大小。 单击“备份恢复管理”，在“数据库跨区域备份”页签查看目标实例的备份大小。 父主题： 数据备份

语法 创建一个或多个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 子分区名称，同一个表中不可重复。

使用示例 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) ) );

语法 创建一个或多个KEY-KEY分区表，其中每个分区可能有一个或一个以上的子分区。 CREATE TABLE [ schema. ]table_name table_definition PARTITION BY [LINEAR] KEY(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 子分区名称， 同一个表中不可重复。

使用示例 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) ) );

语法 创建一个或多个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) ) );

不支持同步的DDL 在创建的同步库中，支持同步表及数据，不支持同步数据库，表空间，索引，外键，函数，存储过程，触发器，视图，分区（删除），主键（增加/删除/修改），事务，用户，角色，权限，事件等对象的操作。 表1和表2提供了不支持同步的索引和分区表相关的操作。这些不支持同步的操作不会影响在HTAP实例上查询和分析数据。 建表语句不能包含CHECK，表选项等。 在数据同步过程中，表3中的操作会导致HTAP中数据和GaussDB(for MySQL) 中数据不一致，应避免使用。 表1 不支持同步的索引相关操作 DDL名称 SQL样例 添加索引 ALTER TABLE tbl_name ADD INDEX name; 重命名索引 ALTER TABLE tbl_name RENAME INDEX old_index_name TO new_index_name; 删除索引 DROP INDEX name ON table; 增加全文索引 CREATE FULLTEXT INDEX name ON table(column); 增加空间索引 ALTER TABLE geom ADD SPATIAL INDEX(g); 修改索引类型 ALTER TABLE tbl_name DROP INDEX i1, ADD INDEX i1(key_part,...) USING BTREE; 添加索引约束 ALTER TABLE tbl_name ADD CONSTRAINT UNIQUE USING BTREE (column); ALTER TABLE tbl_name ADD CONSTRAINT UNIQUE USING HASH(column); 表2 不支持同步的分区表相关操作 DDL名称 SQL样例 分析表分区 ALTER TABLE {db}.tp ANALYZE PARTITION p0; 检查表分区 ALTER TABLE {db}.tp CHECK PARTITION p0; 优化表分区 ALTER TABLE {db}.tp OPTIMIZE PARTITION p0; 重建表分区 ALTER TABLE {db}.tp REBUILD PARTITION p0; 修复表分区 ALTER TABLE {db}.tp REPAIR PARTITION p0; 创建数据库 CREATE DATABASE ddl_test_2; 修改行格式 ALTER TABLE tbl_name ROW_FORMAT = row_format; 设置持久表统计信息 ALTER TABLE tbl_name STATS_PERSISTENT=0, STATS_SAMPLE_PAGES=20,STATS_AUTO_RECALC=1, ALGORITHM=INPLACE, LOCK=NONE; 设置表的字符集 ALTER TABLE tbl_name CHARACTER SET = charset_name; 转换表的字符集 ALTER TABLE tbl_name CONVERT TO CHARACTER SET charset_name; 优化表 OPTIMIZE TABLE tbl_name; 使用“强制”选项重建表 ALTER TABLE tbl_name FORCE; 执行空重建 ALTER TABLE tbl_name ENGINE=InnoDB; 重命名表空间 ALTER TABLESPACE tablespace_name RENAME TO new_tablespace_name; 增加表分区 ALTER TABLE {db}.tp ADD PARTITION (PARTITION p3 VALUES LESS THAN (2006) ); 设置表默认字符集和校对规则 ALTER TABLE tbl_name DEFAULT CHARACTER SET = utf8 COLLATE = utf8_general_ci; 表3 导致数据不一致的DDL操作说明 DDL名称 SQL样例 删除主键 ALTER TABLE tbl_name DROP PRIMARY KEY; 增加主键 ALTER TABLE {db}.t1 ADD PRIMARY KEY (id); 增加删除主键 ALTER TABLE tbl_name DROP PRIMARY KEY, ADD PRIMARY KEY (column); 主键允许为NULL ALTER TABLE tbl_name MODIFY COLUMN key_column_name data_type; 修改主键类型 ALTER TABLE tbl_name MODIFY COLUMN key_column_name data_type not null; 增加外键 ALTER TABLE tbl1 ADD CONSTRAINT fk_name FOREIGN KEY index (col1)REFEREN CES tbl2(col2) referential_actions; 删除外键 ALTER TABLE tbl DROP FOREIGN KEY fk_name; 增加列 说明： 支持一般的列增加，但不支持缺省值为如下取值的场景： 双引号 包含HTAP中不存在的函数，字符串，标志符 ALTER TABLE tbl_name ADD COLUMN column_name column_definition c VARCHAR(10) DEFAULT (CONCAT('1', '2')); 设置列的缺省值 说明： 支持缺省值的设置，但不支持缺省值为如下取值的场景： 双引号 包含HTAP中不存在的函数，字符串，标志符 ALTER TABLE tbl_name ALTER COLUMN col SET DEFAULT literal; 修改列不允许为NULL ALTER TABLE tbl_name MODIFY COLUMN column_name data_type NOT NULL; 同时修改列名和类型 ALTER TABLE t1 CHANGE b b1 VARCHAR(100); 修改列名 ALTER TABLE t1 RENAME COLUMN a TO b; 创建无主键的表 ALTER TABLE t1 ADD COLUMN (c2 INT GENERATED ALWAYS AS (c1 + 1)STORED); 增加存储型衍生列 ALTER TABLE {db}.t1 ADD COLUMN (st2 INT GENERATED ALWAYS AS (c2 + 2)STORED), ALGORITHM=COPY; 增加虚拟型衍生列 ALTER TABLE t1 ADD COLUMN (c2 INT GENERATED ALWAYS AS (c1 + 1)VIRTUAL); 删除表分区 ALTER TABLE {db}.tp DROP PARTITION p4; 丢弃表分区 ALTER TABLE {db}.tp DISCARD PARTITION p2 TABLESPACE; 导入表分区 ALTER TABLE {db}.tp IMPORT PARTITION p2 TABLESPACE; 截断表分区 ALTER TABLE {db}.tp TRUNCATE PARTITION p2; 截断分区表 TRUNCATE {db}.tp; 联合表分区 ALTER TABLE {db}.tp_hash COALESCE PARTITION 2; 重新组织表分区 ALTER TABLE {db}.tp REORGANIZE PARTITION p0,p1,p2,p3 INTO ( ... ); 交换表分区 ALTER TABLE {db}.tp EXCHANGE PARTITION p0 WITH TABLE {db}.tp2; 删除表分区 ALTER TABLE {db}.tp REMOVE PARTITIONING; 使用REPLACE子句 CREATE OR REPLACE TABLE; 父主题： 数据同步

语法 创建一个或多个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 子分区名称， 同一个表中不可重复。

使用示例 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) ) );

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

使用示例 HASH-RANGE类型的使用示例 CREATE TABLE tbl_hash_range ( col1 INT, col2 INT, col3 varchar(20), col4 DATE ) PARTITION BY HASH(col1) SUBPARTITION BY RANGE(col2) ( PARTITION p0 ( SUBPARTITION s0 VALUES LESS THAN(4), SUBPARTITION s1 VALUES LESS THAN(7), SUBPARTITION s2 VALUES LESS THAN(10), SUBPARTITION s3 VALUES LESS THAN(13) ), PARTITION p1 ( SUBPARTITION s4 VALUES LESS THAN(4), SUBPARTITION s5 VALUES LESS THAN(7), SUBPARTITION s6 VALUES LESS THAN(10), SUBPARTITION s7 VALUES LESS THAN(13) ), PARTITION p2 ( SUBPARTITION s8 VALUES LESS THAN(4), SUBPARTITION s9 VALUES LESS THAN(7), SUBPARTITION s10 VALUES LESS THAN(10), SUBPARTITION s11 VALUES LESS THAN(13) ) );

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

使用示例 LIST-LIST类型的使用示例 CREATE TABLE tbl_list_list ( col1 INT, col2 INT, col3 varchar(20), col4 DATE ) PARTITION BY LIST (col1) SUBPARTITION BY LIST (col2) ( PARTITION p0 VALUES in (1, 2)( SUBPARTITION partno0 VALUES in (1, 2), SUBPARTITION partno1 VALUES in (3, 4), SUBPARTITION partno2 VALUES in (5, 6) ), PARTITION p1 VALUES in (3, 4)( SUBPARTITION partno3 VALUES in (1, 2), SUBPARTITION partno4 VALUES in (3, 4), SUBPARTITION partno5 VALUES in (5, 6) ), PARTITION p2 VALUES in (5, 6)( SUBPARTITION partno6 VALUES in (1, 2), SUBPARTITION partno7 VALUES in (3, 4), SUBPARTITION partno8 VALUES in (5, 6) ) ); LIST COLUMNS-LIST类型的使用示例 CREATE TABLE tbl_list_columns_list ( col1 INT, col2 INT, col3 varchar(20), col4 DATE ) PARTITION BY LIST COLUMNS(col3) SUBPARTITION BY LIST (col1) ( PARTITION europe VALUES in ('FRANCE', 'ITALY')( SUBPARTITION p0 VALUES in (1, 2), SUBPARTITION p1 VALUES in (3, 4), SUBPARTITION p2 VALUES in (5, 6) ), PARTITION asia VALUES in ('INDIA', 'PAKISTAN')( SUBPARTITION p3 VALUES in (1, 2), SUBPARTITION p4 VALUES in (3, 4), SUBPARTITION p5 VALUES in (5, 6) ), PARTITION americas VALUES in ('US', 'CANADA')( SUBPARTITION p6 VALUES in (1, 2), SUBPARTITION p7 VALUES in (3, 4), SUBPARTITION p8 VALUES in (5, 6) ) );

约束与限制 GaussDB(for MySQL)的HTAP实例在使用上有如下约束限制，用来提高实例的稳定性和安全性。 数据库名、表名、视图名、用户名、角色名大小写敏感，列名和分区名大小写不敏感。 表必须定义主键才支持同步，否则会跳过。 GaussDB(for MySQL)上执行的DDL，部分不支持同步到HTAP，可能会导致同步失败或数据不一致，使用时需注意。 同步的数据库名称和表名称不支持中文字符。 父主题： HTAP实时分析（标准版）

支持同步的DDL 表1 支持同步的DDL相关操作 DDL名称 SQL样例 创建表 CREATE TABLE tbl_name (c_id int not null, c_d_id integer not null, primary key (c_id)); 删除表 DROP TABLE tbl_name; 重命名表 RENAME TABLE tbl_name to new_tbl_name; ALTER TABLE tbl_name RENAME TO new_tbl_name; 清空表数据 TRUNCATE TABLE tbl_name; 修改表注释 ALTER TABLE tbl_name COMMENT='test'; 添加列（非主键列） ALTER TABLE tbl_name ADD c_varchar varchar(2000) AFTER c_tinytext; 删除列（非主键列） ALTER TABLE tbl_name DROP c_vchar; 修改列类型、列顺序（非主键列） ALTER TABLE tbl_name CHANGE c_vchar c_vchar varchar(2000) default 'test' AFTER c_tinytext; 注意： 不支持修改列名及默认值， DDL语句列名和默认值必须为旧值。 ALTER TABLE tbl_name MODIFY c_vchar varchar(2100) default 'test' AFTER c_tinytext; 注意： 不支持修改默认值，DDL语句默认值必须为旧值。 父主题： 数据同步

数据类型对应关系 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