Re: Confused about stream replication protocol documentation - Mailing list pgsql-hackers

From Li Japin
Subject Re: Confused about stream replication protocol documentation
Date
Msg-id E3008770-67FD-44E5-A348-D0E7C3674225@hotmail.com
Whole thread Raw
In response to Re: Confused about stream replication protocol documentation  (Fujii Masao <masao.fujii@oss.nttdata.com>)
Responses Re: Confused about stream replication protocol documentation
List pgsql-hackers

On Dec 23, 2020, at 8:11 PM, Fujii Masao <masao.fujii@oss.nttdata.com> wrote:


On 2020/12/23 11:08, Li Japin wrote:
On Dec 22, 2020, at 11:13 PM, Fujii Masao <masao.fujii@oss.nttdata.com <mailto:masao.fujii@oss.nttdata.com>> wrote:

‘B’ means a backend and ‘F’ means a frontend. Maybe as [1] does, we should
add the note like "Each is marked to indicate that it can be sent by
a frontend (F) and a backend (B)" into the description about each message
format for START_REPLICATION.

[1]
https://www.postgresql.org/docs/devel/protocol-message-formats.html <https://www.postgresql.org/docs/devel/protocol-message-formats.html>
Thanks for your clarify.  Maybe we should move the "protocol message formats”
before “stream replication protocol” or referenced it in "stream replication protocol”.

I like the latter. And maybe it's better to reference to also
"53.6. Message Data Types" there because the messages for
START_REPLICATION use the message data types.

Add reference about “protocol message types” and “protocol message formats”.

index 4899bacda7..5793936b42 100644
--- a/doc/src/sgml/protocol.sgml
+++ b/doc/src/sgml/protocol.sgml
@@ -2069,8 +2069,9 @@ The commands accepted in replication mode are:
      </para>

      <para>
-      WAL data is sent as a series of CopyData messages.  (This allows
-      other information to be intermixed; in particular the server can send
+      WAL data is sent as a series of CopyData messages
+      (See <xref linkend="protocol-message-types"/> and <xref linkend="protocol-message-formats"/>).
+      (This allows other information to be intermixed; in particular the server can send
       an ErrorResponse message if it encounters a failure after beginning
       to stream.)  The payload of each CopyData message from server to the
       client contains a message of one of the following formats:

--
Best regards
Japin Li

Attachment

pgsql-hackers by date:

Previous
From: Michael Paquier
Date:
Subject: Re: Fail Fast In CTAS/CMV If Relation Already Exists To Avoid Unnecessary Rewrite, Planning Costs
Next
From: Noah Misch
Date:
Subject: Re: [PATCH] Logical decoding of TRUNCATE