データベースのプライマリキーへのアップグレード
概要
このセクションでは、既存のインストール環境のテーブルを主キーに手動でアップグレードする手順を説明します。
主キーへのアップグレードにより、データのインデックス作成とアクセス方法が最適化され、クエリの高速化と容量の節約につながる場合があります。 また、クラスタ構成におけるデータ管理と同期も改善され、スケーリングの支援や、一部のサーバーが障害を起こしてもシステムの信頼性を維持しやすくなります。
このページに記載されている手順は上級ユーザー向けに設計されており、環境に応じて調整が必要になる場合があります。 主キーへのアップグレードには時間とリソースがかかることがあります。 十分な空きディスク容量があることを確認してください。データベースのサイズと保存されているデータによっては、この処理に history テーブルで現在使用している容量の最大 2.5 倍が必要になる場合があります。
Zabbix 6.0 以降では、新規インストール時のすべてのテーブルで主キーが使用されます。
主キーへの自動データベースアップグレードはありませんが、既存のインストール環境は Zabbix サーバーを 6.0 以降にアップグレードした後であれば、手動でアップグレードできます。
Zabbix 7.0 以降では、テーブルを主キーにアップグレードすると、テーブルは倍精度データ型も使用するようになります。
Zabbix 7.0(またはそれ以降)を使用している場合、テーブルはすでに倍精度を使用しています。
ただし、このページの手順は、すでに倍精度を使用しているテーブルに影響を与えることなく、テーブルを主キーにアップグレードするために引き続き実行できます。
Zabbix 6.4(またはそれ以前)を使用している場合は、先にテーブルを倍精度にアップグレードすることを検討してください。
詳細については、Zabbix 7.0 ドキュメントの 拡張範囲の数値へのアップグレード を参照してください。
以下の手順が利用できます。
重要な注意事項
データベースのアップグレードを実行するには:
- 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.4+ と 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 モードが有効になるようにしてください。
- 古いテーブルを削除するには、移行後の手順 に従ってください。
mysqlshを使用しないMariaDB/MySQL 8.4以降
このアップグレード方法は時間がかかるため、mysqlshを使用したアップグレードができない場合にのみ使用してください。
テーブルのアップグレード
-
root(推奨)またはFILE権限を持つ任意のユーザーとしてMySQLコンソールにログインします。
-
稼働中の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
サーバーを停止した状態での移行
移行中のタイムアウトを回避するため、データを移行する前にmax_execution_time(MySQLの場合)またはmax_statement_time(MariaDBの場合)を無効にする必要があります。
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のドキュメントまたはMariaDBのドキュメントを参照してください。
エクスポート中のタイムアウトを回避するため、データをエクスポートする前にmax_execution_time(MySQLの場合)またはmax_statement_time(MariaDBの場合)を無効にする必要があります。
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 サーバーを停止しておく必要があります。
See also: Important notes
-
history_upgrade_prepare.sqlを使用してテーブル名を変更します。- 圧縮が有効な場合(デフォルトインストール)、
/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 - 圧縮が無効な場合、
/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
- 圧縮が有効な場合(デフォルトインストール)、
-
圧縮設定に基づいて TimescaleDB の hypertable 移行スクリプトを実行します:
- 圧縮が有効な場合(デフォルトインストール)、
/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 - 圧縮が無効な場合、
/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
- 圧縮が有効な場合(デフォルトインストール)、
See also: INSERT パフォーマンスを改善するための Tips。
- 古いテーブルを削除するには、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;
- TimescaleDBの場合は、次の古いテーブルも削除します。
DROP TABLE trends_old;