postgres_fdw "parallel_commit" docs
Jonathan S. Katz <jkatz@postgresql.org>
From: "Jonathan S. Katz" <jkatz@postgresql.org>
To: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Cc: etsuro.fujita@gmail.com
Date: 2022-05-09T15:37:35Z
Lists: pgsql-hackers
Attachments
- parallel-commit-docs.patch (text/plain) patch
Hi, While researching PG15 features, I was trying to read through the docs[1] for the "parallel_commit" (04e706d4) feature in postgres_fdw to better understand what it does. I found myself becoming lost with the references to (sub)transaction and a few other items that, while accurate, may be overly specific in this context. Attached is a patch to try to simplify the language for the description of the "parallel_commit" option. A few notes: * I stated that this feature applies to both transactions and subtransactions. * I tried to condense some of the language around remote/local transactions. If this makes the statement inaccurate, let's revise. * I removed the "Be careful with this option" and instead clarified an explanation of the case that could cause performance impacts. This feature seems like it will be impactful for distributed workloads using "postgres_fdw" so I want to ensure that we both accurately and clearly capture what it can do. Thanks! Jonathan [1] https://www.postgresql.org/docs/devel/postgres-fdw.html#id-1.11.7.47.11.7
Commits
-
Doc: Improve description of the "parallel_commit" option for postgres_fdw.
- 8c8d307f8297 15.0 landed