このページの手順は上級ユーザー向けに設計されており、環境に応じて調整が必要になる場合があります。主キーへのアップグレードには時間とリソースがかかることがあります。十分な空きディスク容量があることを確認してください。データベースのサイズと保存されているデータによっては、この処理に履歴テーブルで現在使用している容量の最大 2.5 倍が必要になる場合があります。

Zabbix 6.0 以降では、新規インストール時のすべてのテーブルで主キーが使用されます。

主キーへの自動データベースアップグレードはありません。ただし、既存のインストール環境は、Zabbix サーバーを 6.0 以降にアップグレードした後であれば、手動でアップグレードできます。

Zabbix 7.0 以降では、テーブルを主キーにアップグレードすると、同時にテーブルが倍精度データ型を使用するようにもアップグレードされます。

Zabbix 7.0（またはそれ以降）を使用している場合、テーブルはすでに倍精度を使用しています。ただし、このページの手順は、すでに倍精度を使用しているテーブルに影響を与えることなく、テーブルを主キーにアップグレードするために引き続き実行できます。

Zabbix 6.4（またはそれ以前）を使用している場合は、先にテーブルを倍精度にアップグレードすることを検討してください。詳細については、Zabbix 7.0 ドキュメントの拡張範囲の数値へのアップグレードを参照してください。

手順が用意されているデータベースは次のとおりです。

MariaDB/MySQL
PostgreSQL
TimescaleDB

重要な注意事項

データベースのアップグレードを実行するには:

Zabbixサーバーを停止します。

アップグレード中はZabbixサーバーを停止することを強く推奨します。ただし、どうしても必要な場合は、サーバーが稼働している間にアップグレードを実行することもできます（MySQL、MariaDB、およびTimescaleDBなしのPostgreSQLのみ）。

データベースのバックアップを取ります。
Zabbixのバージョンに対応した最新のzabbix-sql-scriptsパッケージをインストールします（例：RHELの場合：dnf install zabbix-sql-scripts）。
データベース用のスクリプトを実行します。
Zabbixサーバーを起動します。

サーバーデータベースのみに対してスクリプトを実行してください。プロキシにはこのアップグレードの恩恵はありません。

データベースでパーティションを使用している場合は、DB管理者またはZabbixサポートにお問い合わせください。

CSVファイルは、主キーへのアップグレードが正常に完了した後に削除できます。

オプションで、Zabbixフロントエンドをメンテナンスモードに切り替えることができます。

MariaDB/MySQL

エクスポートとインポートは、セッションが切断されないように tmux/screen で実行する必要があります。

参照: 重要な注意事項

MySQL 8.0+ with mysqlsh

この方法は稼働中の Zabbix サーバーでも使用できますが、アップグレード中はサーバーを停止することを推奨します。
MySQL Shell (mysqlsh) はインストールされており、DB に接続できる必要があります。

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

データをエクスポートおよびインポートします。

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 is not supported" というメッセージが表示される場合、MySQL Shell のインストールには JS サポートが含まれていません。
その場合は、Oracle から公式の MySQL Shell パッケージをインストールするか、ソースからビルドして、JavaScript モードが有効になるようにしてください。

古いテーブルを削除するには、移行後の手順に従います。

MariaDB/MySQL 8.0+ を mysqlsh なしで実行する場合

このアップグレード方法は時間がかかるため、mysqlsh を使用したアップグレードが不可能な場合にのみ使用してください。

テーブルのアップグレード

MySQL コンソールに root（推奨）または FILE 権限を持つ任意のユーザーでログインします。
稼働中の Zabbix サーバーで移行を行う場合は、local_infile 変数を有効にして MySQL を起動します。
history_upgrade_prepare.sql を実行して、古いテーブルの名前を変更し、新しいテーブルを作成します。

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

サーバー停止中の移行

移行中のタイムアウトを避けるため、データ移行の前に MySQL の max_execution_time または MariaDB の max_statement_time を無効にする必要があります。

MySQL の場合:

SET @@max_execution_time=0;

MariaDB の場合:

SET @@max_statement_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;

古いテーブルを削除するには、移行後の手順に従ってください。

サーバー稼働中の移行

インポート/エクスポートが有効なパスを確認します:

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 documentation または MariaDB documentation を参照してください。

データのエクスポート中のタイムアウトを避けるため、エクスポートの前に MySQL の max_execution_time または MariaDB の max_statement_time を無効にする必要があります。

MySQL の場合:

SET @@max_execution_time=0;

MariaDB の場合:

SET @@max_statement_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

サーバー停止中の移行

現在の履歴をエクスポートして一時テーブルにインポートし、その後、重複を無視しながら新しいテーブルにデータを挿入します:

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: Bulk Loading Huge Amounts of Data, Checkpoint Distance and Amount of WAL。

古いテーブルを削除するには、移行後の手順に従ってください。

稼働中のサーバーでの移行

現在の履歴をエクスポートし、一時テーブルにインポートした後、重複を無視しながら新しいテーブルにデータを挿入します:

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

旧いテーブルを削除するには、移行後の手順に従ってください。

PostgreSQL + TimescaleDB

エクスポートとインポートは、セッションが切断されないように tmux/screen 内で実行する必要があります。
アップグレード中は Zabbix サーバーを停止しておく必要があります。

移行後

すべてのデータベースで、移行が完了したら、次のことを行います。

すべてが期待通りに動作することを確認します。
古いテーブルを削除します。

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

TimescaleDBの場合は、次の古いテーブルも削除します。

DROP TABLE trends_old;

こちらもご参照ください

パーティショニングのためのauditlogテーブルの準備

What’s next?

4 監査ログテーブルのパーティション化の準備

Docs

3 プライマリキーへのデータベースのアップグレード

概要

重要な注意事項

MariaDB/MySQL

MySQL 8.0+ with mysqlsh

MariaDB/MySQL 8.0+ を mysqlsh なしで実行する場合

テーブルのアップグレード

サーバー停止中の移行

サーバー稼働中の移行

PostgreSQL

テーブルのアップグレード

サーバー停止中の移行

稼働中のサーバーでの移行

PostgreSQL + TimescaleDB

移行後

こちらもご参照ください

What’s next?

Suggest edit

Suggest an example

Thank you!