Re: Inaccurate statement about log shipping replication mode - Mailing list pgsql-docs

From Laurenz Albe
Subject Re: Inaccurate statement about log shipping replication mode
Date
Msg-id 568ff8638e011b2726d06a4b95124ec51ee1e5af.camel@cybertec.at
Whole thread Raw
In response to Inaccurate statement about log shipping replication mode  (PG Doc comments form <noreply@postgresql.org>)
List pgsql-docs
On Thu, 2025-08-21 at 15:20 +0000, PG Doc comments form wrote:
> Page: https://www.postgresql.org/docs/17/warm-standby.html
>
> The documentation page about Log-Shipping Standby Servers after describing
> that there are file-based log shipping and record-based log shipping
> (streaming replication) states: "It should be noted that log shipping is
> asynchronous, i.e., the WAL records are shipped after transaction commit.".
> This statement is misleading because the same page includes a section about
> configuring synchronous streaming replication. To avoid confusion, I think
> it makes sense to specify that record-based log shipping can be configured
> as either asynchronous or synchronous.

I think that the statement you quote is not only misleading, but wrong.
WAL can get shipped before the transaction commits.  Perhaps the sentence
had better be

  It should be noted that by default, log shipping is asynchronous, i.e.,
  the primary server does not wait until the standby receives the data.

Yours,
Laurenz Albe



pgsql-docs by date:

Previous
From: Wim Bertels
Date:
Subject: Re: Example on difference between CREATE MATERIALIZED VIEW and standard VIEW has typo