2 Reparar el juego de caracteres y collation de la base de datos Zabbix

MySQL/MariaDB

Históricamente, MySQL y sus derivados usaban 'utf8' como alias para utf8mb3, la implementación propia de MySQL de 3 bytes del estándar UTF8, que es de 4 bytes. A partir de MySQL 8.0.28 y MariaDB 10.6.1, el juego de caracteres 'utf8mb3' está en desuso y en algún momento su soporte dejará de ser compatible, mientras que 'utf8' desaparecerá para convertirse en una referencia a 'utf8mb4'. Desde Zabbix 6.0, se admite 'utf8mb4'. Para evitar problemas futuros, se recomienda encarecidamente utilizar 'utf8mb4'. Otra ventaja de cambiar a 'utf8mb4' es la compatibilidad con los caracteres complementarios de Unicode .

Como las versiones anteriores a Zabbix 6.0 no reconocen utf8mb4, asegúrese de actualizar primero el Servidor Zabbix y el esquema de base de datos a 6.0.x o posterior antes de ejecutar la conversión a utf8mb4.

1. Verifique el juego de caracteres y collation de la base de datos.

Por ejemplo:

mysql> SELECT @@character_set_database, @@collation_database;
       +--------------------+---------------------- +
       | @@character_set_database | @@collation_database |
       +--------------------+---------------------- +
       | latín2 | latin2 _general_ci |
       +--------------------+---------------------- +
Copy
✔ Copied

O:

mysql> SELECT @@character_set_database, @@collation_database;
       +--------------------+---------------------- +
       | @@character_set_database | @@collation_database |
       +--------------------+---------------------- +
       | utf8 | utf8_bin |
       +--------------------+---------------------- +
Copy
✔ Copied

Como vemos, el conjunto de caracteres aquí no es 'utf8mb4' y collation no es 'utf8mb4_bin', por lo que debemos corregirlos.

2. Para Zabbix.

3. ¡Crea una copia de seguridad de la base de datos!

4. Corrige el juego de caracteres y collation en el nivel de la base de datos:

alter database <your DB name> character set utf8mb4 collate utf8mb4_bin;
Copy
✔ Copied

Valores corregidos:

mysql> SELECT @@character_set_database, @@collation_database;
       +--------------------+---------------------- +
       | @@character_set_database | @@collation_database |
       +--------------------+---------------------- +
       | utf8mb4 | utf8mb4_bin |
       +--------------------+---------------------- +
Copy
✔ Copied

5. Cargue el script para corregir el juego de caracteres y collation a nivel de tabla y columna:

mysql <your DB name> < utf8mb4_convert.sql
Copy
✔ Copied

6. Ejecute el script:

SET @ZABBIX_DATABASE = '<your DB name>';
       If MariaDB →set innodb_strict_mode = OFF;
       CALL zbx_convert_utf8();
       If MariaDB →set innodb_strict_mode = ON;
       drop procedure zbx_convert_utf8;
Copy
✔ Copied

Tenga en cuenta que se espera que 'utf8mb4' consuma un poco más de espacio en disco.

7. Si no hay errores, es posible que desee crear una copia de seguridad de la base de datos con la base de datos corregida.

8. Inicie Zabbix.

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.