Re: pg_copy_logical_replication_slot doesn't copy the failover property

From: Amit Kapila <amit(dot)kapila16(at)gmail(dot)com>
To: Shlok Kyal <shlok(dot)kyal(dot)oss(at)gmail(dot)com>
Cc: Masahiko Sawada <sawada(dot)mshk(at)gmail(dot)com>, Nisha Moond <nisha(dot)moond412(at)gmail(dot)com>, duffieldzane(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: pg_copy_logical_replication_slot doesn't copy the failover property
Date: 2025-02-24 02:46:20
Message-ID: CAA4eK1+wJeK12_pCaFCvCO=WRj-xb2BoT=JZov7vjCqmAfJkkw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Sat, Feb 22, 2025 at 11:26 AM Shlok Kyal <shlok(dot)kyal(dot)oss(at)gmail(dot)com> wrote:
>
> Adding Amit to the thread.
>

Thanks.

Looking at the original complaint:

> It says
> * To avoid potential issues with the slot synchronization where the
> * restart_lsn of a replication slot can go backward, we set the
> * failover option to false here. This situation occurs when a slot
> * on the primary server is dropped and immediately replaced with a
> * new slot of the same name, created by copying from another existing
> * slot. However, the slot synchronization will only observe the
> * restart_lsn of the same slot going backward.

It would be better to update the comments as well to make the
potential issues with slot synchronization clear or mention the
reference of other place where we have comments related to this race
condition. Also, I think it is better to write about two_phase in the
comments as well as in docs unless already mentioned. If you agree
with updating the comments as well, shall we redirect this to hackers?

> >
> > IIUC the two_phase field is also not copied from the source slot. I
> > think we can clarify in the doc that these two fields are not copied.
> >

+1.

--
With Regards,
Amit Kapila.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2025-02-24 06:52:25 correction
Previous Message jian he 2025-02-23 06:27:26 Re: substring synopsis section, third argument is optional doc didn't show that

Browse pgsql-hackers by date

  From Date Subject
Next Message Andy Alsup 2025-02-24 03:23:45 Re: Update docs for UUID data type
Previous Message Peter Smith 2025-02-24 02:08:55 Re: Conflict detection for multiple_unique_conflicts in logical replication