知识库

连接到 MySQL 时出现“[MySQL][ODBC 5.3(w) Driver]Unknown character set: 'utf8mb4'”错误


发布时间: 30 Oct 2019
上次修改日期: 06 Mar 2023

问题

通过 Tableau Desktop 或 Tableau Server 或者通过 DNS 测试连接到 MySQL 时,MySQL Unicode 驱动程序返回错误

“[MySQL][ODBC 5.3(w) Driver]Unknown character set: 'utf8mb4'”([MySQL][ODBC 5.3(w) 驱动程序]未知字符集:‘utf8mb4’)。


有关此情形的其他信息:

  • 仅当连接到 MySQL 服务器 5.5.3 之前的版本时才会出现此错误。
  • 只有 MySQL ODBC 驱动程序版本 5.3.11 或更高版本才会出现此错误。

环境

  • Tableau Desktop
  • Tableau Server
  • MySQL

解决方案

为了避免此错误,请使用以下解决方案之一:
选项 1
降级到较早的 MySQL 驱动程序版本(5.3.11 之前)。
选项 2
将 MySQL 服务器升级到支持 UTF8MB4 字符集的 5.5.3 或更高版本。
选项 3
使用 Tableau 中的通用 ODBC 连接器,并使用 MySQL ANSI 驱动程序而不是默认的 Unicode 驱动程序进行连接(请注意,使用通用 ODBC 连接器的连接不受支持,可能会导致功能受限)。

原因

从版本 5.3.11 及更高版本开始,MySQL ODBC 驱动程序开始使用 UTF8MB4 字符集,而不是 UTF8。但是,MySQL 服务器直到版本 5.5.3 才增加了对 UTF8MB4 字符集的支持,因此连接到低于此版本的任何服务器版本都会导致上述错误。

其他信息

有关此更改的详细信息,请参见以下 MySQL 文档:
此文章是否已解决问题?