streaming replication confusion

From: Josh Kupershmidt <schmiddy(at)gmail(dot)com>
To: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: streaming replication confusion
Date: 2012-11-09 02:56:00
Message-ID: CAK3UJRELGc4v_aoRstG8kY0JfCrt4xNUeW=uxtnwPSZ4zV5nMQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

I think there is at least[4] one confusing documentation leftover from
the 9.0 days at:
http://www.postgresql.org/docs/devel/static/warm-standby.html

First, we claim:

| Streaming replication is asynchronous, so there is still a small delay
| between committing a transaction in the primary and for the changes
| to become visible in the standby.

This unqualified statement, which has remained the same since 9.0,
suggests synchronous replication is not possible using streaming
replication. Further down we are closer to the truth:

| PostgreSQL streaming replication is asynchronous by default.

Proposed fix for this gripe attached. I'd be pleased to see this
particular doc patch backpatched to 9.2 and 9.1, given that the
replication docs are both important and fairly confusing.

The Streaming Replication wiki page[1] contains similar out-of-date
claims[2]; I can fix some of the egregious errors myself, though help
is welcome. The "Synchronous Replication" wiki page[3] is in even
worse shape, containing mostly info about a patch different than what
was committed... and it's currently the first Google search result for
"postgresql synchronous replication" :-(

Josh

[1] http://wiki.postgresql.org/wiki/Streaming_Replication
[2] such as "Currently SR supports only asynchronous log-shipping", or
already-released functionality described under the "Future release
section".
[3] http://wiki.postgresql.org/wiki/Synchronous_replication
[4] I have a larger gripe about the way this entire page is laid out,
with streaming rep. info bolted onto a page which is still named and
was intended to be about warm standby, but I'll try to make a separate
thread about that.

Attachment Content-Type Size
streaming_rep.docfix.diff application/octet-stream 1.4 KB

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Andreas.Heiduk 2012-11-11 18:35:35 BUG #7652: Documentation index lacks functions from "Additional Supplied Modules"
Previous Message Nikolaos Oikonomopoulos 2012-11-04 17:32:59 Re: CONSTRAINT on ARRAY ELEMENTS