Feedback-ID: i0fe9450f:Fastmail
Date: Wed, 11 Dec 2024 09:18:48 +0900
From: Michael Paquier <michael@paquier.xyz>
To: Fujii Masao <masao.fujii@oss.nttdata.com>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Clarify old WAL files cannot be removed until they are summarized
Message-ID: <Z1jaaLi2vq-Wpk9y@paquier.xyz>
References: <fd0eb0a5-f43b-4e06-b450-cbca011b6cff@oss.nttdata.com>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="kYGdEeOgSx560N2N"
Content-Disposition: inline
In-Reply-To: <fd0eb0a5-f43b-4e06-b450-cbca011b6cff@oss.nttdata.com>
Archived-At: 
 <https://www.postgresql.org/message-id/Z1jaaLi2vq-Wpk9y%40paquier.xyz>
Precedence: bulk


--kYGdEeOgSx560N2N
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Fri, Oct 18, 2024 at 02:25:15AM +0900, Fujii Masao wrote:
> The documentation in wal.sgml explains that old WAL files cannot be
> removed or recycled until they are archived (when WAL archiving is used)
> or replicated (when using replication slots). However, it did not
> mention that, similarly, old WAL files are also kept until they are summarized
> if WAL summarization is enabled. Attached patch adds that clarification to
> the documentation. Thought?
>
> @@ -643,6 +643,8 @@
>     until the situation is resolved. A slow or failed standby server that
>     uses a replication slot will have the same effect (see
>     <xref linkend="streaming-replication-slots"/>).
> +   Similarly, if WAL summarization is enabled, old segments are kept
> +   until they are summarized.
>    </para>

Sounds like a good idea to me.  I'd suggest to add a link to
runtime-config-wal-summarization as it is the first reference to WAL
summarization in this file.
--
Michael

--kYGdEeOgSx560N2N
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAmdY2mgACgkQnvQgOdby
QH2WZQ/8C4fCRApd08Bg37QrzQHVa85UTTtdHgxCuhaXas0tuLOEtIWzUNxp+9Id
MSwHUcQEOJW8lFSk5hEVwTqq5TFriq0y2sGi7z00VPoXAqa9PwCgrf/FzI4vaj8I
NXR1e1oGzrAK4tHTSTxGLC9rqN/+HYoPR2ebXpdXiFmZHTDyrQl1OBFpqxUCh6iH
j0nBiVsYnoFNZX3AtywuqFWkovzZXVwTBoAfNZj6BfZi18v9+1LbK/oovxPWOByu
J5V/qK2aPML29gZXzPpsDptuGhyzltslF0S3/jBHLF5XEJT9YYRbBTTnTAaoKn3v
dEC9NKlptrRiyfSpcFR5hDJ/SUHPYHbbIvOo/wJyG/HY/m4NX7e+4wX+XhE+DtqR
ey6Y7oc4VtymlLZgUHdq77RISPd/YoO5mbV4eW3CAI2TsgBtzYDVvRmV0yn9r8Un
VBbAExJcmcpA7ROFcMurMpI0H2mJKJkrYSA8vvyVW/JxEZUtjGKOu2TDpWKm9amZ
LknugjrCcEM8gwzQdv5MofQs1hBm9alIH/krDXFTMln9QbN7SmgIvnd9hZ8Gsn+4
XwP7puatbXWPQNW8DSS1/+UHkJ/yLHSJ5kJ9TqdeBEYG3i3AYP2dr8oLPMrWQ68Y
bQlkeGIne7Zahkdpd/WJ+v7W1gIxwbn/d7FijhsgLW2hEmZZN3Q=
=LJAg
-----END PGP SIGNATURE-----

--kYGdEeOgSx560N2N--