データベースレプリケーションログのパージ

MySQL データベースのバイナリログは時間の経過とともに蓄積し、大量のディスク容量を消費することがあります。デフォルトでは、これらのログは 3 日ごとに自動的にパージ されるよう設定されています。ただし、容量を解放するために手動でパージする必要がある場合は、次の手順に従ってください。

1. データベースのバックアップを手動で作成する

まず、問題が発生した場合に備えて復元ポイントを確保するため、データベースのバックアップを作成します。

1. porta-onprem-bundle\porta-helpers\porta-database\action ディレクトリに移動します。
   • Porta バージョン 2.3.115 以降では、代わりに porta-onprem-bundle\porta-helpers\porta-database\actions\create-backup.bat になります。
2. create-backup.bat スクリプトをダブルクリックして実行します。

ヒント

作成されたバックアップファイルの名前を控えておいてください。次のステップで必要になります。

2. 障害に備えてバックアップをホストマシンにエクスポートする

porta コンテナからホストマシンにファイルをコピーします。これにより、WSL 環境の外にバックアップのローカルコピーを確保できます。

1. PowerShell を開きます。
2. 次のコマンドを実行し、以下を置き換えます。
   • filename.zip : ステップ 1 で作成したバックアップの名前に
   • D:\destination\path : バックアップを保存したい場所に

   docker cp porta:/var/www/storage/app/Porta-Backups/filename.zip D:\destination\path

ヒント

ファイル名を覚えていない場合、またはバックアップ後に出力されなかった場合は、PowerShell で次を実行して既存のバックアップの一覧を表示できます。

docker exec -it porta ls -al storage/app/Porta-Backups/

3. MySQL バイナリログをパージする

ヒント

パージ前の確認

バイナリログが容量を消費している原因であることを確認するため、1 日あたりに生成される binlog ファイルの典型的な数を把握しておくと役立ちます。これらのファイルは Docker Desktop の UI で確認できます。

1. 左側のサイドバーで Volumes に移動します。
2. porta-db-volume を検索して選択します。
3. ファイルをスクロールして binlog ファイルを表示します。

2025 年 12 月 5 日時点:

• binlog ファイルの最大サイズは約 500MB であるべきです。
  • このサイズを時折超えるのは問題ありませんが、500MB を大きく超えるファイルが多数ある場合は、何か問題があることを示しています。
• 3 日 より古い binlog ファイルは存在しないはずです。
• 1 日あたり 3〜6 個の binlog が作成されるのが通常です。

3a. マシン上でレプリケーションを停止する

1. porta-onprem-bundle\porta-helpers\porta-database\action ディレクトリに移動します。
   • Porta バージョン 2.3.115 以降では、これは代わりに porta-onprem-bundle\porta-helpers\porta-database\actions になります。
2. STOP-repl.bat スクリプトをダブルクリックして実行します。

3b. 3 日以上前に作成された MySQL バイナリログを手動でパージする

注意

レプリケーションが実行されている場合、PURGE コマンドはグループ内のすべてのデータベースに対して実行されますが、変数の変更は実行 されません。

SET sql_log_bin = {OFF|ON} を使用して、現在のデータベースのみで PURGE を実行します。

1. porta-onprem-bundle\porta-helpers\porta-run ディレクトリに移動します。
   • Porta バージョン 2.3.115 以降では、これは代わりに porta-onprem-bundle\porta-helpers\porta-run\sysadmin\CLI になります。
2. access-mysql.bat スクリプトをダブルクリックして実行し、MySQL シェルにアクセスします。
3. MySQL シェルで、次のコマンドを実行して 3 日より古いログを削除します。
   • コマンド内の日付を 3 日前に編集 し、3 日以上前の すべてのログが含まれるようにすることを忘れないでください。

   • SET sql_log_bin=OFF;

     PURGE BINARY LOGS BEFORE '2025-12-05 00:00:00';

     SET sql_log_bin=ON;

注意

ERROR 1227 (42000): Access denied; you need (at least one of) the SUPER or BINLOG_ADMIN privilege(s) for this operation が発生した場合

この場合は、MySQL サーバーに手動でアクセスする必要があります。

1. porta-onprem-bundle\porta-helpers\porta-run ディレクトリに移動します。
   • Porta バージョン 2.3.115 以降では、これは代わりに porta-onprem-bundle\porta-helpers\porta-run\sysadmin\CLI になります。
2. access-db-shell.bat スクリプトをダブルクリックして実行し、サーバーシェルにアクセスします。
3. mysql -u root -p を実行して、root ユーザーとして MySQL にログインします。
4. パスワードの入力を求められたら、データベースのパスワードを入力し、Enter を押して送信します。
   • mysql> プロンプトが表示されれば、ログインに成功したことを意味します。
5. 上記の SET sql_log_bin および PURGE コマンドを再度実行します（上記のステップ 3 を参照）。
6. このガイドの手順を続行します。

4. binlog の有効期限を短縮する

ヒント

有効期限がすでに正しく設定されている場合は、このステップをスキップできます。設定が正しいことを確認するには、次の手順で現在の値を確認できます。

1. porta-onprem-bundle\porta-helpers\porta-run ディレクトリに移動します。
   • Porta バージョン 2.3.115 以降では、これは代わりに porta-onprem-bundle\porta-helpers\porta-run\sysadmin\CLI になります。
2. access-mysql.bat スクリプトをダブルクリックして実行し、MySQL シェルにアクセスします。
3. MySQL シェルで SELECT @@binlog_expire_logs_seconds; コマンドを実行して、現在の有効期限を秒単位で表示します。
4. 値が 259200 より大きい場合（桁数に注意）、以下の手順に進んで変更します。

次のような結果が表示されます。

+------------------------------+
| @@binlog_expire_logs_seconds |
+------------------------------+
|                   259200000  |
+------------------------------+
1 row in set (0.00 sec)

1. porta-onprem-bundle\porta-helpers\porta-run ディレクトリに移動します。
   • Porta バージョン 2.3.115 以降では、これは代わりに porta-onprem-bundle\porta-helpers\porta-run\sysadmin\CLI になります。
2. access-mysql.bat スクリプトをダブルクリックして実行し、MySQL シェルにアクセスします。
3. MySQL シェルで SET PERSIST binlog_expire_logs_seconds=259200; コマンドを実行します。

5. マシン上でレプリケーションを開始する

1. porta-onprem-bundle\porta-helpers\porta-database\action ディレクトリに移動します。
   • Porta バージョン 2.3.115 以降では、これは代わりに porta-onprem-bundle\porta-helpers\porta-database\actions になります。
2. START-repl.bat スクリプトをダブルクリックして実行します。