Re: doc: add note that wal_level=logical doesn't set up logical replication in itself - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: doc: add note that wal_level=logical doesn't set up logical replication in itself
Date
Msg-id CAKFQuwaUyN8LeFXmwD2ZiR3M3GZ66kELsTU3JBvGuyS0Ombvww@mail.gmail.com
Whole thread Raw
In response to Re: doc: add note that wal_level=logical doesn't set up logical replication in itself  ("Euler Taveira" <euler@eulerto.com>)
List pgsql-hackers
On Wed, Mar 4, 2026 at 7:11 AM Euler Taveira <euler@eulerto.com> wrote:
>
> Something like:
> Note that setting this parameter only enables the required WAL format;
> it does not configure logical replication by itself.
>

I don't think such note should be added. If the DBA doesn't know how to setup
logical replication, it should read the Logical Replication chapter.


Yeah, I don't think this change is directly warranted.  But in trying to figure out what we can do to improve matters I find that the documentation here has some room to improve that may indeed reduce confusion and be more informative than the proposed single line addition.  In particular, now that we have effective_wal_level it is unclear why people would even be here changing wal_level in the first place.  The quick start guide to logical replication is at least partially at fault in that regard.

Since the suggestion made here don't directly apply to the subject of this email thread, and I've some other suggestions as well, I've started a new thread here:


David J.

pgsql-hackers by date:

Previous
From: Andres Freund
Date:
Subject: Re: Don't keep closed WAL segment in page cache after replay
Next
From: Melanie Plageman
Date:
Subject: Re: Correcting freeze conflict horizon calculation