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

doc: Update outdated descriptions of wal_status in pg_replication_slots.

Browse Source 
The documentation for pg_replication_slots previously mentioned only
max_slot_wal_keep_size as a condition under which the wal_status column
could show unreserved or lost. However, since commit be87200,
replication slots can also be invalidated due to horizon or wal_level,
and since commit ac0e33136a, idle_replication_slot_timeout can also
trigger this state.

This commit updates the description of the wal_status column to
reflect that max_slot_wal_keep_size is not the only cause of the lost state.

Back-patched to v16, where the additional invalidation cases were introduced.

Author: Fujii Masao <masao.fujii@gmail.com>
Reviewed-by: Hayato Kuroda <kuroda.hayato@fujitsu.com>
Reviewed-by: Nisha Moond <nisha.moond412@gmail.com>
Discussion: https://postgr.es/m/78b34e84-2195-4f28-a151-5d204a382fdd@oss.nttdata.com
Backpatch-through: 16
This commit is contained in:
Fujii Masao
2025-07-03 23:07:23 +09:00
parent 647cffd2f3
commit ff3007c66d
1 changed files with 4 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
doc/src/sgml/system-views.sgml
View File

@ -2819,20 +2819,18 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
<para> <para>
<literal>unreserved</literal> means that the slot no longer <literal>unreserved</literal> means that the slot no longer
retains the required WAL files and some of them are to be removed at retains the required WAL files and some of them are to be removed at
the next checkpoint. This state can return the next checkpoint. This typically occurs when
<xref linkend="guc-max-slot-wal-keep-size"/> is set to
a non-negative value. This state can return
to <literal>reserved</literal> or <literal>extended</literal>. to <literal>reserved</literal> or <literal>extended</literal>.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<literal>lost</literal> means that some required WAL files have <literal>lost</literal> means that this slot is no longer usable.
been removed and this slot is no longer usable.
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
The last two states are seen only when
<xref linkend="guc-max-slot-wal-keep-size"/> is
non-negative.
</para></entry> </para></entry>
</row> </row>