기술 자료

MySQL에 연결할 때 "[MySQL][ODBC 5.3(w) Driver]Unknown character set: 'utf8mb4'" 오류 발생


게시 날짜: 30 Oct 2019
마지막 수정 날짜: 06 Mar 2023

문제

Tableau Desktop 또는 Tableau Server를 사용하거나 DNS 테스트를 통해 MySQL에 연결할 때 MySQL 유니코드 드라이버가 오류를 반환합니다.

"[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 드라이버를 사용하여 연결합니다. 참고로, 일반 ODBC 커넥터를 사용한 연결은 지원되지 않으며 기능이 제한될 수 있습니다. 

원인

버전 5.3.11 이상부터 MySQL ODBC 드라이버는 UTF8 대신 UTF8MB4 문자 집합을 사용하기 시작했습니다. 그러나 UTF8MB4 문자 집합에 대한 지원은 버전 5.5.3이 될 때까지 MySQL 서버에 추가되지 않았으므로 이보다 이전 버전의 서버에 연결하면 위의 오류가 발생합니다.

추가 정보

이 변경 사항에 대한 자세한 내용은 다음 MySQL 설명서를 참조하십시오.
  • MySQL 커넥터/ODBC 5.3.11 릴리스 정보:
    • "The Unicode version now uses the UTF8MB4 character set as a transport character set between the MySQL server and the ODBC driver.(유니코드 버전은 이제 UTF8MB4 문자 집합을 MySQL 서버와 ODBC 드라이버 간의 전송 문자 집합으로 사용합니다.)"
  • MySQL 5.5.3 서버 릴리스 정보:
    • "The utf8mb4 character set has been added. This is similar to utf8, but its encoding allows up to four bytes per character to enable support for supplementary characters.(utf8mb4 문자 집합이 추가되었습니다. 이 문자 집합은 utf8과 유사하지만 인코딩이 문자당 최대 4바이트를 허용하여 보충 문자를 지원합니다.)"
이 문서로 문제가 해결되었습니까?