Table of Contents

3 数据库升级至主键

3 数据库升级至主键

概览

本节提供手动将现有安装中的表升级到主键的指导。

升级到主键优化了数据的索引和访问方式，这可能加快查询速度并节省空间。它还改善了集群设置中的数据管理和同步，有助于扩展，并确保即使某些服务器出现故障，系统仍保持可靠。

本页提供的指导适用于高级用户，可能需要根据您的具体配置进行调整。升级到主键可能耗时且资源密集。确保有足够的可用磁盘空间；根据您的数据库大小和存储的数据，此过程可能需要历史表当前使用空间的2.5倍。

自Zabbix 6.0以来，新安装中所有表都使用主键。

没有自动的数据库升级到主键；但是，现有安装可以在将Zabbix服务器升级到6.0或更高版本之后手动升级。

自Zabbix 7.0起，将表升级到主键同时将表升级为使用双精度数据类型。

如果您使用的是Zabbix 7.0，表已经使用双精度。但是，本页上的指导仍然可以遵循，以将表升级到主键，而不影响已经使用双精度的表。

如果您使用的是Zabbix 6.4（或更早版本），请考虑首先将表升级到双精度。更多信息，请参阅升级到扩展范围的数值。

提供以下指导：

MySQL
PostgreSQL
TimescaleDB
Oracle

重要说明

执行数据库升级：

停止Zabbix server。

强烈建议在升级期间停止Zabbix server。然而，如果绝对必要，您可以在服务器运行时执行升级（仅适用于MySQL，MariaDB，以及没有TimescaleDB的PostgreSQL）。

备份您的数据库。

如果使用PostgreSQL或TimescaleDB，请参阅已知问题以恢复在Zabbix 7.0.0-7.0.4中创建的PostgreSQL或TimescaleDB备份。

安装与您的Zabbix版本兼容的最新zabbix-sql-scripts包（例如，对于RHEL：dnf install zabbix-sql-scripts）。
运行适用于您数据库的脚本。
启动Zabbix server。

仅运行适用于server数据库的脚本。proxy不会从此次升级中获益。

如果数据库使用分区，请联系DB管理员或Zabbix支持获取帮助。

成功升级到主键后，可以移除CSV文件。

可选地，Zabbix前端可以切换到维护模式。

MySQL

导出和导入必须在 tmux/screen 中执行，以确保会话不会被丢弃。

另请参阅：重要说明

MySQL 8.0+ 与 mysqlsh

此方法可用于运行中的 Zabbix 服务器，但建议在升级期间停止服务器。必须安装 MySQL Shell (mysqlsh) 并能够连接到数据库。

以 root（推荐）或具有 FILE 特权的任何用户身份登录到 MySQL 控制台。
使用 local_infile 变量启用的方式启动 MySQL。
通过运行 history_upgrade_prepare.sql 重命名旧表并创建新表。

mysql -uzabbix -p<密码> zabbix < /usr/share/zabbix-sql-scripts/mysql/option-patches/history_upgrade_prepare.sql

导出和导入数据。

通过 mysqlsh 连接。如果使用套接字连接，可能需要指定路径。

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

使用以下命令切换到 JavaScript 模式：

\js

然后运行以下代码（可根据需要更改 CSVPATH）：

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" });

如果收到 "JavaScript 不受支持" 的消息，说明您的 MySQL Shell 安装缺少 JS 支持。在这种情况下，从 Oracle 安装官方 MySQL Shell 包（或从源代码构建）以启用 JavaScript 模式。

遵循迁移后说明以删除旧表。

没有 mysqlsh 的 MariaDB/MySQL 8.0+

这种升级方法需要更多时间，只有在无法使用 mysqlsh 进行升级时才应使用。

表升级

以 root（推荐）或任何具有 FILE 权限的用户身份登录 MySQL 控制台。
启用 local_infile 变量启动 MySQL。
通过运行 history_upgrade_prepare.sql 重命名旧表并创建新表：

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

停止server 的迁移

max_execution_time 必须在迁移数据之前禁用以避免迁移期间超时。

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;

按照迁移后说明删除旧表。

在server 运行的情况下迁移

检查启用了哪些路径导入/导出：

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

如果 secure_file_priv 值是目录路径，则将对该目录中的文件执行导出/导入。在这种情况下，相应地编辑查询中文件的路径或将secure_file_priv 值设置为升级时间的空字符串。

如果 secure_file_priv 值为空，则可以从任何位置执行导出/导入。

如果 secure_file_priv 值为 NULL，将其设置为包含导出表数据的路径（上例中的“/var/lib/mysql-files/”）。

有关详细信息，请参阅 MySQL 文档。

max_execution_time 必须在导出数据之前禁用以避免导出期间超时。

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';

按照迁移后说明删除旧表。

PostgreSQL

导出和导入必须在 tmux/screen 中执行，以确保会话不会被丢弃。对于使用 TimescaleDB 的安装，请跳过此部分并继续阅读 PostgreSQL + TimescaleDB。

另请参阅：重要说明

表升级

使用 history_upgrade_prepare.sql 重命名表：

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

停止server 的迁移

导出当前历史，将其导入临时表，然后将数据插入新表，同时忽略重复项：

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;

查看提高 INSERT 性能的技巧：PostgreSQL：批量加载大量数据，检查点距离和 WAL 的数量。

按照 post-migration instructions 删除旧表。

迁移正在运行的server

导出当前历史，将其导入临时表，然后将数据插入新表，同时忽略重复项：

\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;

按照 post-migration instructions 删除旧表。

PostgreSQL + TimescaleDB

导出和导入必须在 tmux/screen 中执行，以确保会话不会被丢弃。Zabbix server应该在升级期间关闭。

另请参阅：重要说明

使用 history_pk_prepare.sql 重命名表。

sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql

基于压缩设置运行 TimescaleDB 超表迁移脚本（兼容 TSDB v2.x 和 v1.x 版本）： · * 如果启用了压缩（默认安装），从 database/postgresql/tsdb_history_pk_upgrade_with_compression 运行脚本： · {.bash} · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk.sql | sudo -u zabbix psql zabbix · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_log.sql | sudo -u zabbix psql zabbix · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_str.sql | sudo -u zabbix psql zabbix · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_text.sql | sudo -u zabbix psql zabbix · · * 如果压缩被禁用，从database/postgresql/tsdb_history_pk_upgrade_no_compression运行脚本： · {.bash} · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk.sql | sudo -u zabbix psql zabbix · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_log.sql | sudo -u zabbix psql zabbix · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_str.sql | sudo -u zabbix psql zabbix · cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_text.sql | sudo -u zabbix psql zabbix ·

另请参阅：Tips 以提高 INSERT 性能。

按照 post-migration instructions 删除旧表。

Oracle

自 Zabbix 7.0 起，对 Oracle 数据库的支持已被废弃。

导出和导入操作必须在 tmux/screen 中执行，以确保会话不会被中断。在升级期间，Zabbix 服务器应处于关闭状态。

另请参阅：重要说明

表升级

安装 Oracle 数据泵（可在即时客户端工具包中找到）。

请参阅 Oracle 数据泵文档以获取性能提示。

使用 history_upgrade_prepare.sql 重命名表。

cd /path/to/zabbix-sources/database/oracle/option-patches
       sqlplus zabbix/password@oracle_host/service
       sqlplus> @history_upgrade_prepare.sql

####历史表批量迁移

Data Pump 必须对这些目录具有读写权限。

例子：

mkdir -pv /export/history
       chown -R oracle:oracle /export

创建一个目录对象，并将该对象的读写权限授予用于 Zabbix 身份验证的用户（下例中的“zabbix”）。在 sysdba 角色下，运行：

create directory history as '/export/history';
       grant read,write on directory history to zabbix;

导出表。将 N 替换为所需的线程数。

expdp zabbix/password@oracle_host/service \
        · DIRECTORY=history \
        · TABLES=history_old,history_uint_old,history_str_old,history_log_old,history_text_old \
        · PARALLEL=N

导入表。将 N 替换为所需的线程数。

impdp zabbix/password@oracle_host/service \
        · DIRECTORY=history \
        · TABLES=history_uint_old \
        REMAP_TABLE=history_old:history,history_uint_old:history_uint,history_str_old:history_str,history_log_old:history_log,history_text_old:history_text \
        · data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND · PARALLEL=N CONTENT=data_only

按照 post-migration instructions 删除旧表。

####历史表的单独迁移

为每个历史表准备数据泵目录。Data Pump 必须对这些目录具有读写权限。

例子：

mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text
       chown -R oracle:oracle /导出

创建一个目录对象，并将该对象的读写权限授予用于 Zabbix 身份验证的用户（下例中的“zabbix”）。在 sysdba 角色下，运行：

create directory history as '/export/history';
       grant read,write on directory history to zabbix;
       
       create directory history_uint as '/export/history_uint';
       grant read,write on directory history_uint to zabbix;
       
       create directory history_str as '/export/history_str';
       grant read,write on directory history_str to zabbix;
       
       create directory history_log as '/export/history_log';
       grant read,write on directory history_log to zabbix;
       
       create directory history_text as '/export/history_text';
       grant read,write on directory history_text to zabbix;

导出和导入每个表。将 N 替换为所需的线程数。

expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N
       
       impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only
       
       expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N
       
       impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only
       
       expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N
       
       impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only
       
       expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N
       
       impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only
       
       expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N
       
       impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=history_text_old:history_text data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only

按照 post-migration instructions 删除旧表。

迁移后

对于所有数据库，迁移完成后，执行以下操作：

验证一切是否按预期工作。
删除旧表：

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

另请参阅

准备用于分区的审计日志表

Documentation

3 数据库升级至主键

概览

重要说明

MySQL

MySQL 8.0+ 与 mysqlsh

没有 mysqlsh 的 MariaDB/MySQL 8.0+

表升级

停止server 的迁移

在server 运行的情况下迁移

PostgreSQL

表升级

停止server 的迁移

迁移正在运行的server

PostgreSQL + TimescaleDB

Oracle

表升级

迁移后

另请参阅