Date: Wed, 6 Sep 2023 10:34:24 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Peter Eisentraut <peter@eisentraut.org>
Cc: Euler Taveira <euler@eulerto.com>, yanliang lei <msdnchina@163.com>,
	pgsql-docs@lists.postgresql.org
Subject: Re: Replica vs standby
Message-ID: <ZPiN8PB6JH7OlLP2@momjian.us>
References: <169279891191.621.15758133625753505628@wrigleys.postgresql.org>
 <b151f622-86c4-429e-8629-e48b7038c6c1@app.fastmail.com>
 <ZPfY+C28UF0oGDx2@momjian.us>
 <d1896085-05e6-5f22-041c-658e3f3313c9@eisentraut.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <d1896085-05e6-5f22-041c-658e3f3313c9@eisentraut.org>
Archived-At: 
 <https://www.postgresql.org/message-id/ZPiN8PB6JH7OlLP2%40momjian.us>
Precedence: bulk

On Wed, Sep  6, 2023 at 09:02:02AM +0200, Peter Eisentraut wrote:
> On 06.09.23 03:42, Bruce Momjian wrote:
> > There are other cases in our docs where we call something a standby and
> > mean only a physical standby/replica.  Should these be clarified?
> 
> When "hot standby" was added, I argued that it's not really a standby if
> it's hot.  The response was that this is sort of a standard industry term,
> and we should read "standby" to be equivalent to "replica".  Which I think
> is good enough.  Obviously, the term "standby" is baked into many
> user-visible interfaces, so it's not clear whether there is a clean path to
> improving anything here.

If we don't want to change the standby == replica assumption, we still
need improvement.

How do we describe physical replicas in the docs?

	https://www.postgresql.org/docs/devel/runtime-config-wal.html#RUNTIME-CONFIG-WAL-SETTINGS
	wal_level (enum)

	wal_level determines how much information is written to the WAL. The
	default value is replica, which writes enough data to support WAL
	archiving and replication, including running read-only queries on a
	standby server.
	--------------

That is clearly not a logical standby/replica.

If a server subscribes to one table via logical replication, is it a
replica/standby server?

	https://www.postgresql.org/docs/devel/runtime-config-replication.html#RUNTIME-CONFIG-REPLICATION-SENDER
	max_wal_senders (integer)

	Specifies the maximum number of concurrent connections from standby
	                                                            -------
	servers or streaming base backup clients (i.e., the maximum number of
	-------
	simultaneously running WAL sender processes). 

The email that started this thread was caused by confusion that logical
subscribers are part of the max_wal_senders allocation.  While logical
replication _can_ be used for standby purposes, it has many other uses.

For physical replication, a hot standby can still be used for standby
purposes, while for logical replication, most of its uses cannot be used
for standby purposes.

My initial recommendation is that we keep "standby" for physical
replicas, hot and warm, and we use "replica" for physical and logical
replication receivers.  In this case, replica == "receiver of
replication".

I am ready to prepare a patch to clarify all this once we decide what is
appropriate.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.