GreatSQL 5.7升级到8.0


本文介绍如何从GreatSQL 5.7/MySQL 5.7版本升级到GreatSQL 8.0版本。

1. 为什么要升级

GreatSQL 8.0相对于5.7有着众多优秀新特性,包括且不仅限以下:

特性GreatSQL 8.0GreatSQL/MySQL 5.7
MGR投票节点/仲裁节点
MGR快速单主模式
MGR地理标签
MGR优化流控算法
MGR网络分区异常处理
MGR节点异常退出处理
MGR节点磁盘满处理
InnoDB并行查询优化
秒级加新列
Hash Join
Anti Join优化
直方图
倒序索引
不可见索引
函数索引/表达式索引
多值索引
CTE
窗口函数
EXPLAIN ANALYZE
Clone Plugin
全新数据字典
DDL原子性
升级更灵活
数个安全增强
数个InnODB增强
数个优化器增强

2. 升级前准备

2.1 注意事项

从5.7版本升级到8.0,有以下相关注意事项,请认真核对是否产生冲突或不兼容:

  1. 最好是先升级到5.7.x的最新版本,再升级到8.0.x的最新版本,不要从5.7的小版本直接升级到8.0,尤其是非GA的版本。
  2. 在8.0中,除了 general_logslow_log 之外,其他所有元数据的字典数据都存储在InnoDB引擎表中,不再采用MyISAM引擎表存储。
  3. 在8.0中,默认采用 caching_sha2_password 密码插件,这可能导致部分版本较早的连接驱动、连接客户端无法连接8.0的服务端,也需要同步升级。
  4. 在8.0中,默认采用 utf8mb4 字符集,而5.7版本默认字符集是 utf8(也是 utf8mb3),在做数据迁移时要注意前后对照校验。
  5. 在8.0中,启动时务必先设定好 lower_case_table_names 选项值,且实例启动后不可再更改,在个别不区分大小写的旧系统中前移时要特别谨慎。
  6. 新增保留字、关键字,详情请见:2.6 保留字、关键字
  7. 除InnoDB、NDB外,其他引擎不再支持表分区。
  8. SQL Mode不再支持 NO_AUTO_CREATE_USER,也就是不能直接利用 GRANT 创建新用户并授权,需要先 CREATE USER 创建用户,再授权。
  9. 部分参数选项不再支持,例如:innodb_locks_unsafe_for_binlog, old_passwords, query cache相关参数等。
  10. 部分功能、函数不再支持,例如:query cache, PASSWORD(), ENCODE(), DECODE(), ENCRYPT()等。

更多详情请见:What Is New in MySQL 8.0GreatSQL 5.7升级到8.0 - 图1 (opens new window)

2.2 升级准备

首先下载GreatSQL 8.0版本安装包,推荐选择最新的GreatSQL 8.0.32-24版本GreatSQL 5.7升级到8.0 - 图2 (opens new window),至于选择RPM还是二进制包看具体情况及个人喜好。

本文假定升级前后都是二进制包方式安装。

正式升级之前,务必做好数据备份,可以采用以下几种方式:

  1. 停机维护,复制当前的数据库目录,做一个全量物理备份,这种方式恢复起来最快。
  2. 利用mysqldump/xtrabackup等备份工具,执行一个全量备份。
  3. 利用主从复制或MGR,在其中一个节点执行备份,或者令某个节点临时下线/退出,作为备用节点。

需要特别注意的事,您原先运行中的GreatSQL/MySQL 5.7版本,可能也是从其他旧版本中升级而来的,此时有可能MySQL系统库下的部分元数据表还是旧格式。这种情况下,需要先在原来的环境下执行 mysql_upgrade 进行升级修复旧格式。例如:

  1. # 切换到当前运行的数据库实例datadir下
  2. $ cd /data/GreatSQL
  3. # 执行mysql_upgrade程序
  4. # 参数 -s 表示只升级MySQL系统库表文件,不升级其他用户数据文件,一般建议去掉,对所有数据都进行升级
  5. # 参数 -f 表示强制升级,如果升级过程中遇到报错,也会继续升级后面的库表文件,而不会直接退出
  6. # 假定socket文件路径是 /data/GreatSQL/mysql.sock,用参数 -S 指向
  7. $ /usr/local/GreatSQL-5.7.36-39-Linux-glibc2.28-x86_64/bin/mysql_upgrade -s -f -S/data/GreatSQL/mysql.sock
  8. /usr/local/GreatSQL-5.7.36-39-Linux-glibc2.28-x86_64/bin/mysql_upgrade -s -S./mysql.sock
  9. The --upgrade-system-tables option was used, databases won't be touched.
  10. Checking if update is needed.
  11. Checking server version.
  12. Running queries to upgrade MySQL server.
  13. ...
  14. mysql.time_zone_transition_type OK
  15. mysql.user OK
  16. The sys schema is already up to date (version 1.5.2).
  17. Checking databases.
  18. sys.sys_config OK
  19. test.sbtest1 OK
  20. Upgrade process completed successfully.
  21. Checking if update is needed.

另外,推荐采用MySQL Shell提供的 util.checkForServerUpgrade() 方法做升级前的检查,它主要是从实例的基础数据本身来判定实例是否满足升级条件,譬如是否使用了移除的函数、表名是否存在冲突等。该工具的详细介绍可参考社区用户 芬达 的几篇文章:

3. 升级过程

从GreatSQL/MySQL 5.7升级到8.0需要注意以下几点变化:

  1. 升级前的版本要求是GA版本,即5.7.9之后的版本。如果不是的话,要先在5.7大版本内升级小版本。
  2. 建议先把当前的5.7升级到最新的子版本,截止本文时间,最新版本是5.7.43。
  3. 升级到8.0版本后,主要区别是默认密码验证插件(default_authentication_plugin)从 mysql_native_password 变成了 caching_sha2_password,会影响一些版本比较低的API/驱动,在创建用户时仍旧指定为 mysql_native_password 即可,或者在 my.cnf 中设置 default_authentication_plugin=mysql_native_password
  4. 在8.0中,不能直接利用 GRANT 创建新用户,需要手动先 CREATE USER 才能 GRANT,对应 SQL_MODE = NO_AUTO_CREATE_USER
  5. 在8.0中,除了InnoDB引擎,其他引擎表都不支持原生PARTITION特性。
  6. 默认字符集、校验集分别从 latin1 & latin1_swedish_ci 升级成 utf8mb4 & utf8mb4_0900_ai_ci注意 ,在5.7版本中,utf8mb4 默认的校验集是 utf8mb4_general_ci,而在8.0中,对应的默认校验集则变成 utf8mb4_0900_ai_ci。如果有数据库、表、存储函数等数据对象没有显式声明校验集的话,注意是否发生变化。

只要注意上述这几点区别,做到心中有数,升级到8.0就不慌了。

升级的方法有以下几种可选。

3.1 原地升级

如果数据库能停机维护,则采用原地升级(in-place upgrade)方法最为简单。

备份完成后,关闭数据库实例,在关闭数据库实例前,务必确保设置选项 innodb_fast_shutdown=0,以确保得到的是个干净的、正常关闭的数据库文件集。

首先修改 my.cnf,增加一行

  1. upgrade = FORCE

然后修改正确的 basedir 指向新版本二进制文件路径,再次启动GreatSQL 8.0服务,即可实现自动升级,除了系统表,用户表也会全部升级。

注意: 这种方法不支持从5.6版本直接升级到8.0。

升级过程的日志输入类似下面这样:

  1. ...
  2. [System] [MY-011012] [Server] Starting upgrade of data directory.
  3. ...
  4. [System] [MY-011003] [Server] Finished populating Data Dictionary tables with data.
  5. [System] [MY-013381] [Server] Server upgrade from '50700' to '80025' started.
  6. [System] [MY-013381] [Server] Server upgrade from '50700' to '80025' completed.
  7. ...
  8. [System] [MY-010931] [Server] /usr/local/GreatSQL-8.0.32-24-Linux-glibc2.28-x86_64/bin/mysqld: ready for connections. Version: '8.0.32-24' socket: 'mysql.sock' port: 3306 GreatSQL, Release 24, Revision 3714067bc8c.

是不是觉得有点惊喜,有点意外,怎么怎么简单,事实的确如此。

如果有强迫症的话,想要看到完整升级过程,还可以加上两个选项 log_error_verbosity=3 以及 innodb_print_ddl_logs = ON,输出的日志就会多很多:

  1. ...
  2. [System] [MY-011012] [Server] Starting upgrade of data directory.
  3. ...
  4. [Note] [MY-011088] [Server] Data dictionary initializing version '80023'.
  5. [Note] [MY-010337] [Server] Created Data Dictionary for upgrade
  6. ...
  7. [System] [MY-011003] [Server] Finished populating Data Dictionary tables with data.
  8. [Note] [MY-011008] [Server] Finished migrating TABLE statistics data.
  9. [Note] [MY-011008] [Server] Finished migrating TABLE statistics data.
  10. [Note] [MY-010006] [Server] Using data dictionary with version '80023'.
  11. [System] [MY-013381] [Server] Server upgrade from '50700' to '80025' started.
  12. [Note] [MY-013386] [Server] Running queries to upgrade MySQL server.
  13. ...
  14. [Note] [MY-012477] [InnoDB] DDL log insert : [DDL record: REMOVE CACHE, id=1, thread_id=5, table_id=1072, new_file_path=mysql/default_roles
  15. ]
  16. [Note] [MY-012478] [InnoDB] DDL log delete : 1
  17. [Note] [MY-012472] [InnoDB] DDL log insert : [DDL record: FREE, id=2, thread_id=5, space_id=4294967294, index_id=57, page_no=542]
  18. [Note] [MY-012478] [InnoDB] DDL log delete : 2
  19. [Note] [MY-012485] [InnoDB] DDL log post ddl : begin for thread id : 5
  20. [Note] [MY-012486] [InnoDB] DDL log post ddl : end for thread id : 5
  21. [Note] [MY-012477] [InnoDB] DDL log insert : [DDL record: REMOVE CACHE, id=3, thread_id=5, table_id=1073, new_file_path=mysql/role_edges]
  22. [Note] [MY-012478] [InnoDB] DDL log delete : 3
  23. [Note] [MY-012472] [InnoDB] DDL log insert : [DDL record: FREE, id=4, thread_id=5, space_id=4294967294, index_id=58, page_no=543]
  24. [Note] [MY-012478] [InnoDB] DDL log delete : 4
  25. [Note] [MY-012485] [InnoDB] DDL log post ddl : begin for thread id : 5
  26. [Note] [MY-012486] [InnoDB] DDL log post ddl : end for thread id : 5
  27. [Note] [MY-012477] [InnoDB] DDL log insert : [DDL record: REMOVE CACHE, id=744, thread_id=5, table_id=1171, new_file_path=mysql/help_relation]
  28. ...
  29. [Note] [MY-012478] [InnoDB] DDL log delete : 744
  30. [Note] [MY-012472] [InnoDB] DDL log insert : [DDL record: FREE, id=745, thread_id=5, space_id=4294967294, index_id=189, page_no=1183]
  31. [Note] [MY-012478] [InnoDB] DDL log delete : 745
  32. [Note] [MY-012485] [InnoDB] DDL log post ddl : begin for thread id : 5
  33. [Note] [MY-012479] [InnoDB] DDL log replay : [DDL record: DROP, id=743, thread_id=5, table_id=1146]
  34. [Note] [MY-012479] [InnoDB] DDL log replay : [DDL record: FREE, id=742, thread_id=5, space_id=4294967294, index_id=156, page_no=835]
  35. [Note] [MY-012486] [InnoDB] DDL log post ddl : end for thread id : 5
  36. [Note] [MY-013400] [Server] Upgrade of help tables completed.
  37. [Note] [MY-013394] [Server] Checking 'mysql' schema.
  38. [Note] [MY-013394] [Server] Checking 'greatsql' schema.
  39. [Note] [MY-013394] [Server] Checking 'sys' schema.
  40. [System] [MY-013381] [Server] Server upgrade from '50700' to '80025' completed.
  41. ...
  42. [System] [MY-010931] [Server] /usr/local/GreatSQL-8.0.32-24-Linux-glibc2.28-x86_64/bin/mysqld: ready for connections. Version: '8.0.32-24' socket: 'mysql.sock' port: 3306 GreatSQL, Release 24, Revision 3714067bc8c.

这样就完成升级了,非常便捷省事。

3.2 滚动升级

可借助主从复制或MGR架构,利用滚动升级方法,先在从节点升级验证无误后,再升级主节点,最终实现所有节点都升级到GreatSQL 8.0版本。

具体可参考文章:MySQL 5.7 MGR平滑升级到GreatSQL 5.7GreatSQL 5.7升级到8.0 - 图6 (opens new window)。根据该文章提供的思路,把MySQL 5.7平滑升级到GreatSQL 5.7之后,仍旧采用同样方法升级到GreatSQL 8.0版本。

最后要注意检查升级过程中输出的日志是否有报错信息,如果没有就说明升级过程很顺利。

确定升级完成后,记得注释掉 my.cnf 文件中的 upgrade = FORCE 选项,或者将其修改成 upgrade = AUTO

4. 升级GreatSQL 8.0.25到8.0.32

GreatSQL 8.0.32相对于8.0.25版本,新增了更多SQL语法兼容性、MGR层支持绑定VIP、支持并行LOAD DATA、在安全方面支持国密加密&备份加密等非常不错的特性,强烈建议升级到最新的GreatSQL 8.0.32版本。

从GreatSQL 8.0.25升级到8.0.32版本过程较为简单:

  1. 下载最新GreatSQL 8.0.32二进制包GreatSQL 5.7升级到8.0 - 图7 (opens new window),并解压缩到相应目录下。

  2. 在数据库维护期间关闭GreatSQL 8.0.25版本数据库。关闭前,先执行 SET GLOBAL innodb_fast_shutdown = 0,确保停机时得到一份完整、干净的数据文件。

  3. 修改my.cnf,调整basedir,指向新版本二进制包路径。可参考这份my.cnf模板GreatSQL 5.7升级到8.0 - 图8 (opens new window)

  4. 重启新的GreatSQL 8.0.32版本数据库服务进程,即可实现原地升级(in-place upgrade),可以看到日志中有类似下面的内容:

  1. [Note] [MY-013327] [Server] MySQL server upgrading from version '80025' to '80032'.
  2. [Note] [MY-012357] [InnoDB] Reading DD tablespace files
  3. [Note] [MY-012356] [InnoDB] Scanned 7 tablespaces. Validated 7.
  4. [Note] [MY-010006] [Server] Using data dictionary with version '80023'.
  5. [Note] [MY-011323] [Server] Plugin mysqlx reported: 'X Plugin ready for connections. socket: '/tmp/mysqlx.sock''
  6. [System] [MY-013381] [Server] Server upgrade from '80025' to '80032' started.
  7. [Note] [MY-013386] [Server] Running queries to upgrade MySQL server.
  8. [Note] [MY-013387] [Server] Upgrading system table data.
  9. [Note] [MY-013385] [Server] Upgrading the sys schema.
  10. [Note] [MY-013400] [Server] Upgrade of help tables started.
  11. [Note] [MY-013400] [Server] Upgrade of help tables completed.
  12. [Note] [MY-013394] [Server] Checking 'mysql' schema.
  13. [Note] [MY-013394] [Server] Checking 'sys' schema.
  14. [System] [MY-013381] [Server] Server upgrade from '80025' to '80032' completed.
  1. 如果设置选项 innodb_print_ddl_logs=1,则还能看到升级过程中有大量的DDL升级记录,例如:
  1. [System] [MY-013381] [Server] Server upgrade from '80025' to '80032' started.
  2. [Note] [MY-013386] [Server] Running queries to upgrade MySQL server.
  3. [Note] [MY-012477] [InnoDB] DDL log insert : [DDL record: REMOVE CACHE, id=6, thread_id=6, table_id=1062, new_file_path=mysql/replication_group_member_actions]
  4. [Note] [MY-012478] [InnoDB] DDL log delete : 6
  5. [Note] [MY-012472] [InnoDB] DDL log insert : [DDL record: FREE, id=7, thread_id=6, space_id=4294967294, index_id=156, page_no=1111]
  6. ...
  7. [Note] [MY-012479] [InnoDB] DDL log replay : [DDL record: FREE, id=792, thread_id=6, space_id=4294967294, index_id=259, page_n
  8. [Note] [MY-012486] [InnoDB] DDL log post ddl : end for thread id : 6
  9. [Note] [MY-013400] [Server] Upgrade of help tables completed.
  10. [Note] [MY-013394] [Server] Checking 'mysql' schema.
  11. [Note] [MY-013394] [Server] Checking 'sys' schema.
  12. [System] [MY-013381] [Server] Server upgrade from '80025' to '80032' completed.

这样就可以很方便完成原地升级GreatSQL版本。

提醒: 由于从MySQL 8.0.26开始新增选项 group_replication_view_change_uuid,因此不支持在一个MGR集群中,同时包含8.0.26以前及以后的版本。例如:在MGR集群中,不能并存8.0.25和8.0.26版本。这种情况下,版本号是8.0.25的MGR集群想要升级到8.0.32,就需要新建一个8.0.32版本的MGR集群,两个集群间再构建异步(或半同步)复制通道,采用这种方式才能实现平滑升级迁移,否则只能是安排离线停机维护时间,才能完成升级。

参考文档

问题反馈

联系我们

扫码关注微信公众号

greatsql-wx