3 Actualización de la base de datos a claves primarias

Descripción general

Esta sección proporciona instrucciones para actualizar manualmente las tablas en instalaciones existentes a claves primarias.

Actualizar a claves primarias optimiza cómo se indexan y acceden los datos, lo que puede acelerar las consultas y ahorrar espacio. También mejora la gestión y sincronización de datos en configuraciones en clúster, ayudando con la escalabilidad y asegurando que el sistema siga siendo fiable incluso si algunos servidores fallan.

Las claves primarias se utilizan para todas las tablas en instalaciones nuevas desde Zabbix 6.0.

No existe una actualización automática de la base de datos a claves primarias; sin embargo, las instalaciones existentes pueden actualizarse manualmente después de actualizar el servidor Zabbix a la versión 6.0 o posterior.

Las instrucciones están disponibles para:

• MySQL
• PostgreSQL
• TimescaleDB

Notas importantes

Para realizar la actualización de la base de datos:

1. Detenga el servidor Zabbix.

Se recomienda encarecidamente detener el servidor Zabbix durante el tiempo de la actualización. Sin embargo, si es absolutamente necesario, puede realizar la actualización mientras el servidor está en funcionamiento (solo para MySQL, MariaDB y PostgreSQL sin TimescaleDB).

2. Realice una copia de seguridad de su base de datos.
3. Instale el paquete zabbix-sql-scripts más reciente compatible con su versión de Zabbix (por ejemplo, para RHEL: dnf install zabbix-sql-scripts).
4. Ejecute los scripts para su base de datos.
5. Inicie el servidor Zabbix.

Si la base de datos utiliza particiones, contacte al administrador de la base de datos o al Soporte de Zabbix para obtener ayuda.

Los archivos CSV pueden eliminarse después de una actualización exitosa a claves primarias.

Opcionalmente, la interfaz web de Zabbix puede cambiarse a modo de mantenimiento.

MySQL

La exportación e importación deben realizarse en tmux/screen para asegurarse de que la sesión no se interrumpa.

Consulte también: Notas importantes

MySQL 8.0+ con mysqlsh

Este método se puede utilizar con un servidor Zabbix en funcionamiento, pero se recomienda detener el servidor durante la actualización. El MySQL Shell (mysqlsh) debe estar instalado y poder conectarse a la base de datos.

• Inicie sesión en la consola de MySQL como root (recomendado) o como cualquier usuario con privilegios FILE.

• Inicie MySQL con la variable local_infile habilitada.

• Cambie el nombre de las tablas antiguas y cree nuevas tablas ejecutando history_upgrade_prepare.sql.

mysql -uzabbix -p<contraseña> zabbix < /usr/share/zabbix/sql-scripts/mysql/option-patches/history_upgrade_prepare.sql

• Exporte e importe los datos.

Conéctese a través de mysqlsh. Si utiliza una conexión por socket, puede ser necesario especificar la ruta.

sudo mysqlsh -uroot -S /run/mysqld/mysqld.sock --no-password -Dzabbix

Cambie al modo JavaScript usando:

\js

Luego ejecute el siguiente código (CSVPATH se puede cambiar según sea necesario):

CSVPATH="/var/lib/mysql-files";
       
       util.exportTable("history_old", CSVPATH + "/history.csv", { dialect: "csv" });
       util.importTable(CSVPATH + "/history.csv", {"dialect": "csv", "table": "history" });
       
       util.exportTable("history_uint_old", CSVPATH + "/history_uint.csv", { dialect: "csv" });
       util.importTable(CSVPATH + "/history_uint.csv", {"dialect": "csv", "table": "history_uint" });
       
       util.exportTable("history_str_old", CSVPATH + "/history_str.csv", { dialect: "csv" });
       util.importTable(CSVPATH + "/history_str.csv", {"dialect": "csv", "table": "history_str" });
       
       util.exportTable("history_log_old", CSVPATH + "/history_log.csv", { dialect: "csv" });
       util.importTable(CSVPATH + "/history_log.csv", {"dialect": "csv", "table": "history_log" });
       
       util.exportTable("history_text_old", CSVPATH + "/history_text.csv", { dialect: "csv" });
       util.importTable(CSVPATH + "/history_text.csv", {"dialect": "csv", "table": "history_text" });

Si recibe el mensaje "JavaScript is not supported", su instalación de MySQL Shell no tiene soporte para JS. En ese caso, instale el paquete oficial de MySQL Shell de Oracle (o compílelo desde el código fuente) para que el modo JavaScript esté habilitado.

• Siga las instrucciones posteriores a la migración para eliminar las tablas antiguas.

MariaDB/MySQL 8.0+ sin mysqlsh

Este método de actualización toma más tiempo y debe usarse solo si una actualización con mysqlsh no es posible.

Actualización de tablas

• Inicie sesión en la consola de MySQL como root (recomendado) o cualquier usuario con privilegios FILE.

• Inicie MySQL con la variable local_infile habilitada.

• Renombre las tablas antiguas y cree nuevas tablas ejecutando history_upgrade_prepare.sql:

mysql -uzabbix -p<contraseña> zabbix < /usr/share/zabbix/sql-scripts/mysql/option-patches/history_upgrade_prepare.sql

Migración con el servidor detenido

max_execution_time debe estar deshabilitado antes de migrar los datos para evitar el tiempo de espera durante la migración.

SET @@max_execution_time=0;
       
       INSERT IGNORE INTO history SELECT * FROM history_old;
       INSERT IGNORE INTO history_uint SELECT * FROM history_uint_old;
       INSERT IGNORE INTO history_str SELECT * FROM history_str_old;
       INSERT IGNORE INTO history_log SELECT * FROM history_log_old;
       INSERT IGNORE INTO history_text SELECT * FROM history_text_old;

Siga las instrucciones posteriores a la migración para eliminar las tablas antiguas.

Migración con el servidor en ejecución

Verifique para qué rutas está habilitada la importación/exportación:

mysql> SELECT @@secure_file_priv;
       +-----------------------+
       | @@secure_file_priv    |
       +-----------------------+
       | /var/lib/mysql-files/ |
       +-----------------------+

Si el valor de secure_file_priv es una ruta a un directorio, la exportación/importación se realizará para los archivos en ese directorio. En este caso, edite las rutas a los archivos en las consultas en consecuencia o establezca el valor de secure_file_priv en una cadena vacía durante el tiempo de actualización.

Si el valor de secure_file_priv está vacío, la exportación/importación puede realizarse desde cualquier ubicación.

Si el valor de secure_file_priv es NULL, establézcalo en la ruta que contiene los datos de la tabla exportada ('/var/lib/mysql-files/' en el ejemplo anterior).

Para más información, consulte la documentación de MySQL.

max_execution_time debe estar deshabilitado antes de exportar los datos para evitar el tiempo de espera durante la exportación.

SET @@max_execution_time=0;
       
       SELECT * INTO OUTFILE '/var/lib/mysql-files/history.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_old;
       LOAD DATA INFILE '/var/lib/mysql-files/history.csv' IGNORE INTO TABLE history FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';
       
       SELECT * INTO OUTFILE '/var/lib/mysql-files/history_uint.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_uint_old;
       LOAD DATA INFILE '/var/lib/mysql-files/history_uint.csv' IGNORE INTO TABLE history_uint FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';
       
       SELECT * INTO OUTFILE '/var/lib/mysql-files/history_str.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_str_old;
       LOAD DATA INFILE '/var/lib/mysql-files/history_str.csv' IGNORE INTO TABLE history_str FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';
       
       SELECT * INTO OUTFILE '/var/lib/mysql-files/history_log.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_log_old;
       LOAD DATA INFILE '/var/lib/mysql-files/history_log.csv' IGNORE INTO TABLE history_log FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';
       
       SELECT * INTO OUTFILE '/var/lib/mysql-files/history_text.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_text_old;
       LOAD DATA INFILE '/var/lib/mysql-files/history_text.csv' IGNORE INTO TABLE history_text FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';

Siga las instrucciones posteriores a la migración para eliminar las tablas antiguas.

PostgreSQL

La exportación e importación deben realizarse en tmux/screen para asegurar que la sesión no se interrumpa. Para instalaciones con TimescaleDB, omita esta sección y continúe con PostgreSQL + TimescaleDB.

Véase también: Notas importantes

Actualización de tablas

• Renombre las tablas usando history_upgrade_prepare.sql:

sudo -u zabbix psql zabbix < /usr/share/zabbix/sql-scripts/postgresql/option-patches/history_upgrade_prepare.sql

Migración con el servidor detenido

• Exporte el historial actual, impórtelo en la tabla temporal, luego inserte los datos en las nuevas tablas ignorando los duplicados:

INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) DO NOTHING;
       
       INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) DO NOTHING;
       
       INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) DO NOTHING;
       
       INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) DO NOTHING;
       
       INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) DO NOTHING;

Consulte consejos para mejorar el rendimiento de INSERT: PostgreSQL: Bulk Loading Huge Amounts of Data, Checkpoint Distance and Amount of WAL.

• Siga las instrucciones posteriores a la migración para eliminar las tablas antiguas.

Migración con el servidor en ejecución

• Exporte el historial actual, impórtelo en la tabla temporal, luego inserte los datos en las nuevas tablas ignorando los duplicados:

\copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV
       CREATE TEMP TABLE temp_history (
           itemid                   bigint                                    NOT NULL,
           clock                    integer         DEFAULT '0'               NOT NULL,
           value                    DOUBLE PRECISION DEFAULT '0.0000'          NOT NULL,
           ns                       integer         DEFAULT '0'               NOT NULL
       );
       \copy temp_history FROM '/tmp/history.csv' DELIMITER ',' CSV
       INSERT INTO history SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) DO NOTHING;
       
       \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV
       CREATE TEMP TABLE temp_history_uint (
           itemid                   bigint                                    NOT NULL,
           clock                    integer         DEFAULT '0'               NOT NULL,
           value                    numeric(20)     DEFAULT '0'               NOT NULL,
           ns                       integer         DEFAULT '0'               NOT NULL
       );
       \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER ',' CSV
       INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) DO NOTHING;
       
       \copy history_str_old TO '/tmp/history_str.csv' DELIMITER ',' CSV
       CREATE TEMP TABLE temp_history_str (
           itemid                   bigint                                    NOT NULL,
           clock                    integer         DEFAULT '0'               NOT NULL,
           value                    varchar(255)    DEFAULT ''                NOT NULL,
           ns                       integer         DEFAULT '0'               NOT NULL
       );
       \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER ',' CSV
       INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) DO NOTHING;
       
       \copy history_log_old TO '/tmp/history_log.csv' DELIMITER ',' CSV
       CREATE TEMP TABLE temp_history_log (
           itemid                   bigint                                    NOT NULL,
           clock                    integer         DEFAULT '0'               NOT NULL,
           timestamp                integer         DEFAULT '0'               NOT NULL,
           source                   varchar(64)     DEFAULT ''                NOT NULL,
           severity                 integer         DEFAULT '0'               NOT NULL,
           value                    text            DEFAULT ''                NOT NULL,
           logeventid               integer         DEFAULT '0'               NOT NULL,
           ns                       integer         DEFAULT '0'               NOT NULL
       );
       \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER ',' CSV
       INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) DO NOTHING;
       
       \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV
       CREATE TEMP TABLE temp_history_text (
           itemid                   bigint                                    NOT NULL,
           clock                    integer         DEFAULT '0'               NOT NULL,
           value                    text            DEFAULT ''                NOT NULL,
           ns                       integer         DEFAULT '0'               NOT NULL
       );
       \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER ',' CSV
       INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) DO NOTHING;

• Siga las instrucciones posteriores a la migración para eliminar las tablas antiguas.

PostgreSQL + TimescaleDB

La exportación e importación deben realizarse en tmux/screen para asegurar que la sesión no se pierda. El servidor Zabbix debe estar detenido durante la actualización.

Ver también: Notas importantes

• Renombrar las tablas usando history_upgrade_prepare.sql.

  • Si la compresión está habilitada (en la instalación por defecto), ejecute el script desde /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression:

    cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression/history_upgrade_prepare.sql | sudo -u zabbix psql zabbix

  • Si la compresión está deshabilitada, ejecute el script desde /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression:

    cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression/history_upgrade_prepare.sql | sudo -u zabbix psql zabbix

• Ejecute los scripts de migración de hypertable de TimescaleDB según la configuración de compresión:

  • Si la compresión está habilitada (en la instalación por defecto), ejecute los scripts desde /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression:

    cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression/history_upgrade.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression/history_upgrade_uint.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression/history_upgrade_log.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression/history_upgrade_str.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression/history_upgrade_text.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/with-compression/trends_upgrade.sql | sudo -u zabbix psql zabbix

  • Si la compresión está deshabilitada, ejecute los scripts desde /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression:

    cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression/history_upgrade.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression/history_upgrade_uint.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression/history_upgrade_log.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression/history_upgrade_str.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression/history_upgrade_text.sql | sudo -u zabbix psql zabbix
           cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/option-patches/without-compression/trends_upgrade.sql | sudo -u zabbix psql zabbix

Consulte también: Consejos para mejorar el rendimiento de las operaciones INSERT.

• Siga las instrucciones posteriores a la migración para eliminar las tablas antiguas.

Post-migración

Para todas las bases de datos, una vez completada la migración, haga lo siguiente:

• Verifique que todo funcione como se espera.

• Elimine las tablas antiguas:

DROP TABLE history_old;
       DROP TABLE history_uint_old;
       DROP TABLE history_str_old;
       DROP TABLE history_log_old;
       DROP TABLE history_text_old;

• Para TimescaleDB, elimine también la siguiente tabla antigua:

DROP TABLE trends_old;

Véase también

• Preparando la tabla auditlog para particionamiento