From: | "Hayato Kuroda (Fujitsu)" <kuroda(dot)hayato(at)fujitsu(dot)com> |
---|---|
To: | 'Peter Smith' <smithpb2250(at)gmail(dot)com> |
Cc: | pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>, Amit Kapila <amit(dot)kapila16(at)gmail(dot)com>, "shiy(dot)fnst(at)fujitsu(dot)com" <shiy(dot)fnst(at)fujitsu(dot)com>, Melih Mutlu <m(dot)melihmutlu(at)gmail(dot)com>, vignesh C <vignesh21(at)gmail(dot)com>, Euler Taveira <euler(at)eulerto(dot)com>, Bharath Rupireddy <bharath(dot)rupireddyforpostgres(at)gmail(dot)com>, "Takamichi Osumi (Fujitsu)" <osumi(dot)takamichi(at)fujitsu(dot)com> |
Subject: | RE: PGdoc: add missing ID attribute to create_subscription.sgml |
Date: | 2023-03-28 03:04:47 |
Message-ID: | TYAPR01MB586613F0CE8C060FD2381B07F5889@TYAPR01MB5866.jpnprd01.prod.outlook.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
Dear Peter,
Thank you for reviewing. PSA new version.
> ////////
> v3-0001
> ////////
>
> This patch looks good, but I think there are a couple of other places
> where you could add links:
>
> ~~~
>
> 1.1 doc/src/sgml/logical-replication.sgml (31.5 Conflicts)
>
> "When the streaming mode is parallel, the finish LSN ..."
>
> Maybe you can add a "streaming" link there.
Added. It could not be detected because this is not tagged as <literal>.
> 1.2. doc/src/sgml/logical-replication.sgml (31.5 31.8. Monitoring)
>
> "Moreover, if the streaming transaction is applied in parallel, there
> may be additional parallel apply workers."
>
> Maybe you can add a "streaming" link there.
Added.
> ////////
> v3-0002
> ////////
>
> There is one bug, and I think there are a couple of other places where
> you could add links:
>
> ~~~
>
> 2.1 doc/src/sgml/logical-replication.sgml (31.4. Column Lists blurb)
>
> For partitioned tables, the publication parameter
> publish_via_partition_root determines which column list is used.
>
> ~
>
> Maybe you can add a "publish_via_partition_root" link there.
Added. I'm not sure why I missed it...
> 2.2 doc/src/sgml/logical-replication.sgml (31.6. Restrictions)
>
> Publications can also specify that changes are to be replicated using
> the identity and schema of the partitioned root table instead of that
> of the individual leaf partitions in which the changes actually
> originate (see CREATE PUBLICATION).
>
> ~
>
> Maybe that text can be changed now to say something like "(see
> publish_via_partition_root parameter of CREATE PUBLICATION)” -- so
> only the parameter part has the link, not the CREATE PUBLICATION part.
Seems better, added.
> 2.3 doc/src/sgml/logical-replication.sgml (31.9. Security)
>
> + subscription <link
> linkend="sql-createpublication-for-all-tables"><literal>FOR ALL
> TABLES</literal></link>
> + or <link
> linkend="sql-createpublication-for-tables-in-schema"><literal>FOR
> TABLES IN SCHEMA</literal></link><literal>FOR TABLES IN
> SCHEMA</literal>
> + only when superusers trust every user permitted to create a non-temp table
> + on the publisher or the subscriber.
>
> There is a cut/paste typo here -- it renders badly with "FOR TABLES IN
> SCHEMA" appearing 2x.
>
That's my fault, fixed.
Best Regards,
Hayato Kuroda
FUJITSU LIMITED
Attachment | Content-Type | Size |
---|---|---|
v4-0001-Add-XML-ID-attributes-to-create_subscription.sgml.patch | application/octet-stream | 17.4 KB |
v4-0002-Add-XML-ID-attributes-to-create_publication.sgml.patch | application/octet-stream | 16.1 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | Peter Geoghegan | 2023-03-28 03:12:11 | Re: Why mark empty pages all visible? |
Previous Message | Stephen Frost | 2023-03-28 02:56:58 | Re: Moving forward with TDE |