MySQL に接続するときのエラー "[MySQL][ODBC 5.3(w) Driver]Unknown character set: 'utf8mb4'"

問題

Tableau Desktop または Tableau Server を介して、あるいは DNS テストを介して MySQL に接続すると、MySQL Unicode ドライバーがエラーを返します。

"[MySQL][ODBC 5.3(w) Driver]Unknown character set (不明な文字セット): 'utf8mb4'".

このシナリオに関する追加情報:

このエラーは、MySQL サーバーのバージョン 5.5.3 より前のバージョンに接続している場合にのみ発生します。
このエラーは、MySQL ODBC ドライバーバージョン 5.3.11 以降でのみ発生します。

環境

Tableau Desktop
Tableau Server
MySQL

解決策

このエラーを回避するには、次のいずれかの解決策を使用してください。

オプション 1

以前の MySQL ドライバーバージョン (5.3.11 より前) にダウングレードします。

オプション 2

MySQL サーバーをバージョン 5.5.3 以降にアップグレードします。バージョン 5.5.3 以降では、UTF8MB4 文字セットがサポートされています。

オプション 3

Tableau の汎用 ODBC コネクタを使用し、デフォルトの Unicode ドライバの代わりに MySQL ANSI ドライバを使用して接続します (汎用 ODBC コネクタを使用した接続はサポートされておらず、機能が制限される可能性があることに注意してください)。

原因

バージョン 5.3.11 以降、MySQL ODBC ドライバーは UTF8 ではなく UTF8MB4 文字セットの使用を開始しました。ただし、UTF8MB4 文字セットのサポートはバージョン 5.5.3 まで MySQL サーバーに追加されなかったため、これより前のバージョンのサーバーに接続すると、上記のエラーが発生します。

詳細情報

変更点の詳細については、以下の MySQL のドキュメントを参照してください。

MySQL Connector/ODBC 5.3.11 リリースノート:
- 「Unicode バージョンでは、MySQL サーバーと ODBC ドライバー間のトランスポート文字セットとして UTF8MB4 文字セットを使用するようになりました。」
MySQL 5.5.3 サーバーリリースノート:
- 「utf8mb4 文字セットが追加されました。この文字セットは utf8 に似ていますが、補足文字をサポートできるように文字ごとに最大4バイトのエンコードが許可されます。」