华为云 GaussDB(for MySQL) 与原生 MySQL 的兼容性差异实操记录

举报
yd_271063030 发表于 2026/11/19 00:03:39 2026/11/19
【摘要】 我们有个业务系统原来跑在自建 MySQL 5.7 上,数据量涨到 2TB 以后,单机备份和扩容越来越难受。评估了一圈,决定迁到华为云 GaussDB for MySQL 。选它的原因很直接:官方说兼容

我们有个业务系统原来跑在自建 MySQL 5.7 上,数据量涨到 2TB 以后,单机备份和扩容越来越难受。评估了一圈,决定迁到华为云 GaussDB(for MySQL)。选它的原因很直接:官方说兼容 MySQL 8.0 协议,应用层改动小,而且存储和计算分离,扩容不用搬数据。听起来很美,实际迁的时候还是踩了不少兼容性的坑。这篇把我从建实例到业务跑通的过程、遇到的报错和绕法记下来,给准备迁的人做个参考。

一、背景:为什么关心"兼容性"而不是"是不是 MySQL"

GaussDB(for MySQL) 不是原生 MySQL 改的,它是华为自研的云原生数据库,计算节点做 SQL 解析和执行,存储层是独立的分布式存储。对外它走 MySQL 协议,客户端用 mysql 命令行、JDBC、各种 ORM 都能连,所以"连得上、简单 SQL 能跑"不代表"完全等价"。

真正会出问题的是这几类:系统表/information_schema 的字段差异、部分函数行为、权限模型、以及一些依赖存储引擎特性的用法(比如 MyISAM、MEMORY 引擎,或者强依赖 innodb 某些参数)。我这次迁移的原则是:先用官方兼容性清单过一遍,再拿真实业务 SQL 在测试实例上跑回归。

二、环境准备与迁移配置

先建实例。控制台上选 GaussDB(for MySQL),规格按业务峰值来,我这里选了 8U32G 的通用型,一主两只读。创建完拿到内网地址,用 MySQL 8.0 客户端连:

mysql -h 192.168.10.20 -P 3306 -u root -p --default-character-set=utf8mb4

连接本身没问题。接下来确认版本和关键参数:

SELECT VERSION();
-- 8.0.22 左右(以实例实际为准)

SHOW VARIABLES LIKE 'lower_case_table_names';
SHOW VARIABLES LIKE 'sql_mode';
SHOW VARIABLES LIKE 'transaction_isolation';

这里第一个要注意的点:lower_case_table_names 在 GaussDB(for MySQL) 上一般是 1(大小写不敏感),而且创建后不可修改。我们原库是 Linux 上 lower_case_table_names=0,表名大小写敏感。迁过去之前我专门扫了一遍业务里有没有靠大小写区分表名的写法,还好没有,否则会直接冲突。

字符集和排序规则也要对齐:

SHOW VARIABLES LIKE 'character_set_server';
SHOW VARIABLES LIKE 'collation_server';

建议建库时就显式指定,避免默认排序规则和原库不一致导致 ORDER BY 结果顺序变化:

CREATE DATABASE biz DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

数据迁移我用的 DRS(数据复制服务)做全量加增量。源库是自建 MySQL 5.7,目标 GaussDB(for MySQL)。DRS 建任务时选"MySQL -> GaussDB(for MySQL)"链路,它会做一次预检查。预检查里就暴露了第一个兼容性问题,见下一节。

三、踩坑记录

坑 1:预检查报 MyISAM 表不支持

DRS 预检查直接报:

源库存在不支持的表引擎: MyISAM,表名: t_log_archive

GaussDB(for MySQL) 只有 InnoDB 一种存储引擎,MyISAM、MEMORY、CSV 这些都不支持。我们那张日志归档表历史遗留是 MyISAM。处理办法是在源库先转引擎:

ALTER TABLE t_log_archive ENGINE=InnoDB;

转之前确认表没有 FULLTEXT 索引(MyISAM 才支持的那种老写法),有的话要先删掉重建。这个改动在源库做,不涉及目标端。

坑 2:information_schema 字段和统计值对不上

业务里有个慢查询监控脚本,读 information_schema.tables 的 data_length、index_length 算表大小。迁完后发现这些值明显偏小,甚至为 0。原因很直接:GaussDB(for MySQL) 是存储计算分离,数据落在共享存储上,information_schema 里这些"表物理大小"的统计口径和单机 InnoDB 不一样,不能拿来当真实占用。

同样的,information_schema.innodb_metrics、部分 performance_schema 表在 GaussDB(for MySQL) 上要么不存在,要么字段是精简的。我的处理是:

-- 不要依赖这个算容量
SELECT table_name, data_length, index_length
FROM information_schema.tables
WHERE table_schema = 'biz';

改成走云监控 API 或者控制台的存储用量指标。监控脚本这部分单独改了逻辑,属于"能跑但语义变了"的隐性坑,不跑回归很难发现。

坑 3:sql_mode 默认值不同,GROUP BY 报错

业务里有条老 SQL,SELECT 的列没出现在 GROUP BY 里:

SELECT user_id, order_no, SUM(amount)
FROM t_order
GROUP BY user_id;

原库 sql_mode 里没有 ONLY_FULL_GROUP_BY,一直能跑。迁到新实例后直接报:

ERROR 1055 (42000): Expression #2 of SELECT list is not in GROUP BY clause and contains nonaggregated column 'biz.t_order.order_no' which is not functionally dependent on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by

有两种解法:一是改 SQL 让它合规(推荐,但工作量大);二是临时放宽会话级 sql_mode:

SET SESSION sql_mode = 'STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';

我选的是 SQL 治理,因为 ONLY_FULL_GROUP_BY 本身是好东西,能挡住歧义查询。但提醒一句:改 sql_mode 前先 SELECT @@sql_mode 看实例默认值,不同版本默认组合不一样,别照搬网上文章。

坑 4:权限模型差异,GRANT 语法受限

原来自建库为了省事,给应用账号授了 ALL PRIVILEGES ON *.*。迁过来后 DRS 同步账号、或者手工建账号时会遇到:

ERROR 1227 (42000): Access denied; you need (at least one of) the SUPER or SYSTEM_VARIABLES_ADMIN privilege(s) for this operation

GaussDB(for MySQL) 对超级权限管控更严,SUPER、FILE、PROCESS 这类全局权限在普通高权限账号上也不一定给全。应对方式是按最小权限重建账号:

CREATE USER 'app_user'@'%' IDENTIFIED BY '******';
GRANT SELECT, INSERT, UPDATE, DELETE ON biz.* TO 'app_user'@'%';
-- 需要建表再单独给 CREATE, ALTER, INDEX

应用账号一律不用 root,这个本来也是规范。另外触发器、存储过程里如果用了 DEFINER,迁移后 DEFINER 账号可能不存在,要 ALTER 改定义或者提前建好对应账号。

坑 5:部分函数和自增行为

大多数 MySQL 函数行为一致,但我在回归里发现两类差异。一是日期函数在边界值上的处理,比如 DATE_ADD 遇到 '0000-00-00' 这种脏数据,GaussDB(for MySQL) 在严格模式下报错更干脆,而原库可能静默返回 NULL。二是自增列:GaussDB(for MySQL) 主键自增值在故障切换后可能出现跳号,如果业务假设"自增 ID 严格连续"(比如拿 ID 做流水号),要提前改掉这个假设。

回归脚本我是这么跑的,把业务高频 SQL 抽出来批量执行、比对结果:

for f in ./sql_regression/*.sql; do
  echo "=== $f ==="
  mysql -h 192.168.10.20 -P 3306 -u app_user -p biz < "$f" 2>&1 | tee -a regress.log
done

regress.log 里出现 ERROR 或者结果行数和基线不一致的,逐条过。这一步花了大概两天,但比上线后出问题便宜太多。

四、小结

  1. 兼容的是协议,不是实现细节。连得上、简单 SQL 能跑,不等于完全等价。系统表、performance_schema、物理大小统计这些地方口径不同,监控类脚本要单独改。
  2. 迁移前先跑 DRS 预检查。存储引擎(MyISAM/MEMORY 不支持)、字符集、lower_case_table_names 这些硬约束,预检查大多能提前暴露,比数据搬了一半再回滚强。
  3. sql_mode 和权限模型要逐个对齐。ONLY_FULL_GROUP_BY、SUPER 权限受限是最常见的两类报错,治本方法是改 SQL 和按最小权限重建账号,而不是全局放宽。
  4. 自增连续性、函数边界行为要单独回归。这类差异不报错、只改结果,最容易被漏掉,拿真实业务 SQL 批量比对结果是最稳妥的办法。
  5. 改用例要留基线。回归日志和执行结果比对表是新旧库行为差异的唯一证据,出了问题能快速定位是迁移引入还是老问题。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。