database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-30 11:03:19 +03:00
Code Activity

Be more prescriptive in new doc about re-archiving of same WAL file.

Browse Source 
Nathan Bossart, reviewed by David Steele.

Discussion: https://postgr.es/m/20220731065156.GA3694276@rfd.leadboat.com
This commit is contained in:
Noah Misch
2022-08-05 08:30:55 -07:00
parent 90a4b64134
commit d263ced225
1 changed files with 8 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
doc/src/sgml/backup.sgml
View File

@ -688,16 +688,14 @@ test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_wal/0
<para> <para>
In rare cases, <productname>PostgreSQL</productname> may attempt to In rare cases, <productname>PostgreSQL</productname> may attempt to
re-archive a WAL file that was previously archived. For example, if the re-archive a WAL file that was previously archived. For example, if the
system crashes before the server makes a durable record of archival success, system crashes before the server makes a durable record of archival
the server will attempt to archive the file again after restarting (provided success, the server will attempt to archive the file again after
archiving is still enabled). When an archive library encounters a restarting (provided archiving is still enabled). When an archive library
pre-existing file, it may return <literal>true</literal> if the WAL file has encounters a pre-existing file, it should return <literal>true</literal>
identical contents to the pre-existing archive and the pre-existing archive if the WAL file has identical contents to the pre-existing archive and the
is fully persisted to storage. Alternatively, the archive library may pre-existing archive is fully persisted to storage. If a pre-existing
return <literal>false</literal> anytime a pre-existing file is encountered, file contains different contents than the WAL file being archived, the
but this will require manual action by an administrator to resolve. If a archive library <emphasis>must</emphasis> return
pre-existing file contains different contents than the WAL file being
archived, the archive library <emphasis>must</emphasis> return
<literal>false</literal>. <literal>false</literal>.
</para> </para>