BASE DE DADOS DE CONHECIMENTO

Erro "[MySQL][ODBC 5.3(w) Driver]Unknown character set: 'utf8mb4'" ao se conectar ao MySQL


Publicado: 30 Oct 2019
Data da última modificação: 06 Mar 2023

Problemas

Ao conectar ao MySQL, por meio do Tableau Desktop ou Tableau Server, ou de um teste DNS, o driver MySQL Unicode retorna o erro

"[MySQL][ODBC 5.3(w) Driver]Unknown character set: 'utf8mb4'". ([MySQL][Driver ODBC 5.3(w)]Conjunto de caracteres desconhecido: 'utf8mb4)


Informações adicionais sobre este cenário:

  • Este erro ocorrerá apenas ao conectar ao servidor MySQL anterior à versão 5.5.3.
  • Este erro ocorrerá apenas com drivers MySQL ODBC versão 5.3.11 ou superior.

Ambiente

  • Tableau Desktop
  • Tableau Server
  • MySQL

Resolução

Para evitar esse erro, use uma das seguintes soluções:
Opção 1
Faça o downgrade para uma versão anterior do driver MySQL (anterior a 5.3.11).
Opção 2
Atualize seu servidor MySQL para a versão 5.5.3 ou posterior, onde o conjunto de caracteres UTF8MB4 é compatível.
Opção 3
Use o conector ODBC genérico do Tableau e conecte usando o driver MySQL ANSI, em vez do driver Unicode padrão (observe que as conexões usando o conector ODBC genérico não são compatíveis e podem resultar em funcionalidade limitada).

Causa

A partir da versão 5.3.11 e superior, o driver MySQL ODBC começou a usar o conjunto de caracteres UTF8MB4, em vez de UTF8. No entanto, o suporte para o conjunto de caracteres UTF8MB4 não foi adicionado ao servidor até a versão 5.5.3, portanto, conectar-se a qualquer versão do servidor anterior a esta resultará no erro acima.

Informações adicionais

Para obter mais informações, consulte a seguinte documentação do MySQL:
  • Notas de versão do Conector MySQL/ODBC 5.3.11:
    • ""A versão Unicode agora usa o conjunto de caracteres UTF8MB4 como um conjunto de caracteres de transporte entre o MySQL servidor e o driver ODBC."
  • Notas de versão do servidor MySQL 5.5.3:
    • ""O conjunto de caracteres utf8mb4 foi adicionado. É semelhante ao utf8, mas sua codificação permite até quatro bytes por caractere para habilitar o suporte para caracteres suplementares."
Este artigo resolveu o problema?