Re: pg_recvlogical cannot create slots with failover=true

From: Masahiko Sawada <sawada(dot)mshk(at)gmail(dot)com>
To: Peter Eisentraut <peter(at)eisentraut(dot)org>
Cc: Amit Kapila <amit(dot)kapila16(at)gmail(dot)com>, "Zhijie Hou (Fujitsu)" <houzj(dot)fnst(at)fujitsu(dot)com>, "Hayato Kuroda (Fujitsu)" <kuroda(dot)hayato(at)fujitsu(dot)com>, "pgsql-hackers(at)lists(dot)postgresql(dot)org" <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: pg_recvlogical cannot create slots with failover=true
Date: 2025-06-17 18:19:55
Message-ID: CAD21AoAvEZuGjRwgLa2J7DNyN67zB_1YBQ7yG+vB545KMu5Yiw@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Tue, Jun 17, 2025 at 12:59 AM Peter Eisentraut <peter(at)eisentraut(dot)org> wrote:
>
> On 14.06.25 07:26, Amit Kapila wrote:
> > On Sat, Jun 14, 2025 at 3:11 AM Masahiko Sawada <sawada(dot)mshk(at)gmail(dot)com> wrote:
> >>
> >> On Thu, Jun 12, 2025 at 10:42 PM Peter Eisentraut <peter(at)eisentraut(dot)org> wrote:
> >>>>>
> >>>>> - The <option>--two-phase</option> and <option>--falover</option> options
> >>>>> + The <option>--two-phase</option> and <option>--failover</option> options
> >>>>
> >>>> Thank you for the report and the patch! Pushed.
> >>>
> >>> I wonder if the option name --failover is ideal. To me, it sounds like
> >>> an action "do a failover!". Also consider that pg_recvlogical has other
> >>> action options such as --start and --create-slot, so it sounds a bit
> >>> like those.
> >>
> >> Fair point.
> >>
> >>> Maybe something like --enable-failover would be better?
> >>
> >> Sounds better, but probably the --two-phase option has the same issue?
> >>
> >
> > Ideally, we should change both to maintain consistency across various
> > slot options. OTOH, as we have already described these options as: "
> > The --two-phase and --failover options can be specified with
> > --create-slot.", it is clear that these are slot options. The previous
> > version docs have a description: "The --two-phase can be specified
> > with --create-slot to enable decoding of prepared transactions." which
> > makes it even more clear that the two-phase is a slot option. The
> > options are named similarly in pg_create_logical_replication_slot API
> > and during CREATE SUBSCRIPTION, so, to some level, there is a
> > consistency in naming of these options across all APIs/tools. But,
> > their usage in a tool like pg_recvlogical could be perceived
> > differently as well, so it is also okay to consider naming them
> > differently.
>
> Also note that we have a new pg_createsubscriber --enable-two-phase.

Yeah, I also noticed the precedent.

> It would be nice if there was more consistency between similar/related
> tools.

I've attached the patch. Feedback is very welcome.

Regards,

--
Masahiko Sawada
Amazon Web Services: https://aws.amazon.com

Attachment Content-Type Size
v1-0001-pg_recvlogical-Rename-two-phase-and-failover-opti.patch application/octet-stream 7.2 KB

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Andres Freund 2025-06-17 18:23:44 Re: minimum Meson version
Previous Message Jeff Davis 2025-06-17 18:14:58 Re: Add CASEFOLD() function.