doc: Mention clock synchronization recommendation for hot_standby_feedback
authorPeter Eisentraut <[email protected]>
Mon, 31 Mar 2025 14:54:50 +0000 (16:54 +0200)
committerPeter Eisentraut <[email protected]>
Mon, 31 Mar 2025 14:54:50 +0000 (16:54 +0200)
hot_standby_feedback mechanics assume that clocks are synchronized,
but it was not clear from documentation.

Author: Jakub Wartak <[email protected]>
Reviewed-by: Euler Taveira <[email protected]>
Reviewed-by: Amit Kapila <[email protected]>
Reviewed-by: vignesh C <[email protected]>
Discussion: https://postgr.es/m/CAKZiRmwBcALLrDgCyEhHP1enUxtPMjyNM_d1A2Lng3_6Rf4Qfw%40mail.gmail.com

doc/src/sgml/config.sgml

index 0d02e21a1ab1101d6ac6933a638e17c305bdd4d1..fea683cb49ce0c17920c48568db43beb2b208cde 100644 (file)
@@ -5068,6 +5068,13 @@ ANY <replaceable class="parameter">num_sync</replaceable> ( <replaceable class="
         until it eventually reaches the primary.  Standbys make no other use
         of feedback they receive other than to pass upstream.
        </para>
+       <para>
+        Note that if the clock on standby is moved ahead or backward, the
+        feedback message might not be sent at the required interval.  In
+        extreme cases, this can lead to a prolonged risk of not removing dead
+        rows on the primary for extended periods, as the feedback mechanism is
+        based on timestamps.
+       </para>
       </listitem>
      </varlistentry>