D 的个人博客

全职做开源,自由职业者

  menu

MySQL 迁移 utf8 到 utf8mb4

MySQL 版本和驱动

  • MySQL 至少是 5.5.3+
  • mysql-connector-java 至少是 5.1.13,修改连接串参数 characterEncoding=UTF-8

历史数据迁移

生成表字符迁移 SQL:

 1SELECT
 2	CONCAT(
 3		'ALTER TABLE `',
 4		TABLE_NAME,
 5		'` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;'
 6	) AS mySQL
 7FROM
 8	INFORMATION_SCHEMA. TABLES
 9WHERE
10	TABLE_SCHEMA = 'your_schema'

生成后执行一把,这样表和列的字符集就改完了。我这里通过修改表的字符集就自动修改列的了,最好自己确认下列是否已经改对。

修改库字符集:

1ALTER DATABASE `your_schema` CHARACTER
2SET = utf8mb4 COLLATE = utf8mb4_general_ci;

上面示例代码中的 COLLATE(排序规则)请按需修改。

关于连接串参数 characterEncoding

有的时候可能会觉得是写错了,应该用 characterEncoding=utf8。其实 UTF-8 是允许客户端发送多种字符集(三字节 utf8 /四字节 utf8mb4)的配置。

如果要使用 utf8mb4 有两种方案:

  1. 在连接串中指定 characterEncoding=UTF-8,MySQL 服务端不用做任何修改
  2. 修改 MySQL 服务端配置后重启,连接串中移除 characterEncoding=utf8
1[mysql]
2default-character-set = utf8mb4
3[mysqld]
4character-set-server = utf8mb4
5collation-server = utf8mb4_general_ci

具体细节请参考这里这里