WAL archiving
=============



.. raw:: html

   <!-- SPDX-License-Identifier: CC-BY-4.0 -->

CloudNativePGでの書き込み先行ログWALアーカイブは、PostgreSQLプライマリから指定されたオブジェクトストアにWALファイルを継続的にシップするプロセスです。これらのアーカイブは、ポイントインタイムリカバリーPITRを有効にするために必要であり、オブジェクトストアとボリュームスナップショットベースのバックアップ戦略の両方の基本的なコンポーネントです。

プラグインベースのアーキテクチャ
--------------------------------

CloudNativePGは、 :ref:`spec.pluginConfiguration <API Reference>` で定義された
**プラグインベースのメカニズム** を介してWALアーカイブをサポートします

``Cluster`` リソースのセクション。

**一度に1つのプラグインのみ**
がWALアーカイブを担当できます。これは、プラグイン構成内で\ ``isWALArchiver``
フィールドを\ ``true`` に設定することにより構成されます。

サポートされているプラグイン
----------------------------

現在、 **Barman Cloud Plugin**
は、CloudNativePGコミュニティによって維持されている唯一の公式にサポートされているWALアーカイブプラグインです。完全なドキュメント、構成オプション、およびベストプラクティスについては、
`Barman Cloud Plugin documentation <https://cloudnative-pg.io/plugin-barman-cloud/docs/intro/>`_ を参照してください。

非推奨の通知 ネイティブBarman Cloud
-----------------------------------

CloudNativePGは、 ``.spec.backup.barmanObjectStore``
フィールドを介してWALアーカイブをネイティブにサポートしています。まだ機能していますが、
**このインターフェイスは非推奨**
であり、将来のリリースでは削除される予定です。

..  Note::
   すべての新しい展開は、より柔軟で保守可能なアプローチを提供するプラグインベースのアーキテクチャを採用することを強くお勧めします。 　

現在ネイティブの\ ``.spec.backup.barmanObjectStore``
アプローチを使用している場合、スムーズな移行のための公式ガイド
`Migrating from Built-in CloudNativePG Backup <https://cloudnative-pg.io/plugin-barman-cloud/docs/migration/>`_  を参照してください。

アーカイブタイムアウトについて
------------------------------

デフォルトでは、CloudNativePGは\ ``archive_timeout`` を\ ``5min``
に設定し、ワークロードが低い場合でもWALファイルが少なくとも5分ごとに閉じてアーカイブされ、目標リカバリポイント
:ref:`PgBouncerPoolMode <PgBouncerPoolMode>`  の決定論的な時間ベースの値を提供します。

`archive_timeout <https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-ARCHIVE-TIMEOUT>`_ の値を変更する場合でも、私たちの経験から、オペレーターが設定したデフォルト値がほとんどのユースケースに適していることが示唆されています。