「nz manualvacuum」コマンド
nz manualvacuum コマンドは、 NPSaaS インスタンス内のすべてのデータベースに対して、包括的なバキュームおよび再インデックス処理を実行します。 このメンテナンス作業では、不要なデータを削除し、インデックスを再構築することで、ディスク領域を解放し、データベースのパフォーマンスを最適化します。 このコマンドは、nzcli バージョン 11.3.1.3 で導入されました。
概要
手動による真空操作は、以下の点において極めて重要な保守作業です：
- NPS システムを停止します（
nzstop） - カタログデータのバックアップを作成します
- すべてのデータベースに対して、バキュームおよび再インデックス処理を実行します
- NPS システムを再起動します（
nzstart）
この処理中はシステムをご利用いただけません。処理にかかる時間は、データベースのサイズによってかなり長くなる場合があります。
前提条件
手動真空操作を実行する前に、以下の点を確認してください：
- NPSaaS インスタンスに対する管理者権限をお持ちです
nzコマンドラインツールのバージョン 11.3.1.3 以降- 必要な環境変数（
APISERVER_URL、NZ_USER、NZ_PASSWORD）を設定済みであるか、あるいはそれらをコマンドオプションとして指定する準備ができています - システムは作業中に利用できなくなるため、メンテナンス期間を設定しました
- カタログのバックアップを行うのに十分なディスク容量があります
構文
nz manualvacuum [options]
オプション
| オプション | 説明 |
|---|---|
-apiserver <APISERVER> |
APIサーバーの URL。 APISERVER_URL 環境変数を使用して設定できます。（必須） |
-u <USER> |
NPSのユーザー名。 NZ_USER 環境変数を使用して設定できます。（必須） |
-pw <PASSWORD> |
NPSのパスワード。 NZ_PASSWORD 環境変数を使用して設定できます。（必須） |
-force |
確認のメッセージをスキップして、すぐに操作を実行する |
-format <FORMAT> |
コマンド結果の出力形式 |
-host <HOST> |
APIサーバーの URL。 NZ_HOST 環境変数を使用して設定できます |
例
確認プロンプトを表示して手動真空引きを実行する
./nz manualvacuum -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>
このコマンドは警告を表示し、確認を求めます：
WARNING: Manual Vacuum Operation
=====================================
This operation will:
1. Stop NPS (nzstop)
2. Run nz_manual_vacuum
3. Start NPS (nzstart)
This process may take significant time and will restart the system.
The system will be unavailable during this operation.
Do you want to continue? (yes/no):
確認なしに手動真空操作を実行する
確認のプロンプトをスキップするには、 -force オプションを使用します：
./nz manualvacuum -force -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>
環境変数の使用
コマンドで認証情報を指定する必要がないように、環境変数を設定します：
export APISERVER_URL=<apiserver-url>
export NZ_USER=<nps-admin-user>
export NZ_PASSWORD=<nps-admin-user-password>
./nz manualvacuum -force
運用ワークフロー
nz manualvacuum コマンドを実行すると、以下のワークフローが実行されます。 内部的には、このコマンドはNPSホスト上で nz_manual_vacuum システムバイナリを呼び出します。
- システムの停止 ：
nzstopコマンドを使用して、NPSシステムを停止します - カタログのバックアップ ：カタログデータのバックアップは、以下の場所に作成されます。
/nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz - バキュームと再インデックス ：この操作では、以下の対象に対してバキュームと再インデックスを実行します：
_T_OBJECTシステムテーブル- すべてのユーザーおよびシステムデータベースを順番に
- システムの起動 ：
nzstartコマンドを使用して、NPSシステムを再起動します - 完了 ：処理が完了し、結果の概要が表示されます
出力とログ
手動による真空操作では、以下のものが発生します：
- ログファイル ：
/nz/manual_vacuum/nz_manual_vacuum.<timestamp>.log - バックアップファイル ：
/nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz - コンソール出力 ：以下の内容を含む詳細な進行状況情報：
- 操作ハンドルとタイムスタンプ
- コマンドの実行状況
- 各データベースのタイミング情報
- サイズ比較（変更前と変更後）
- 完了状況
出力例
Manual vacuum completed successfully
Output:
================================================================================
Manual Vacuum Workflow Started
Handle: nzrest.68n6kkr8.manual_vacuum
User: admin
Timestamp: 2026-06-09 14:08:12,790
================================================================================
# Database 1 of 19 SYSTEM
TIMINGS (vacuum ): Elapsed Time: 0.21
TIMINGS (reindex ): Elapsed Time: 0.39
...
###############################################################################
Size Before Size After Pathname
=============== =============== =========================================================
3924887043 3915646467 /data/catalog/data.1.0
###############################################################################
log file: /nz/manual_vacuum/nz_manual_vacuum.20260609_140932.log
backup file: /nz/manual_vacuum/nz_manual_vacuum.20260609_140932.tar.gz
================================================================================
Manual Vacuum Workflow Completed Successfully
All commands executed without errors
================================================================================
ベスト・プラクティス
- システムをオフラインにできるメンテナンス時間帯に、手動による真空操作をスケジュールしてください
- カタログのバックアップに十分な空き容量を確保するため、操作を実行する前にディスク容量を確認してください
- 完了後にログファイルを確認し、正常に実行されたことを確認してください
- メンテナンスの実施時間帯を計画する際は、データベースのサイズを考慮してください。データベースが大きいほど、より多くの時間が必要となるためです
- 操作が正常に完了したことを確認するまでは、復旧に備えてバックアップファイルを保管しておいてください