From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
---|---|
To: | PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
Subject: | doc: Bring mention of unique index forced transaction wait behavior outside of the internal section |
Date: | 2022-06-09 23:58:48 |
Message-ID: | CAKFQuwZpbdzceO41VE-xt1Xh8rWRRfgopTAK1wL9EhCo0Am-Sw@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
Hi.
The fact that one transaction will wait on another if they are trying to
claim the same unique value is presently relegated to a subchapter of the
documentation where the typical reader will not even understand (rightly
so) the main chapter's title. This has prompted a number of questions
being sent to the mailing list over the years about a topic we do cover in
some detail in the documentation, most recently here:
Attached is a proposal for incorporating some high-level detail within the
MVCC Chapter, where readers are already looking to learn about how
transactions interact with each other and are "isolated" (or not, in this
case) from each other.
I'm neither married to the verbiage nor location but it seems better than
nothing and a modest improvement for not much effort. It's basically a
glorified cross-reference. I didn't dislike directing the reader to the
internals section enough to try and establish a better location for
the main content. It just needs better navigation to it from places the
reader is expected to peruse.
David J.
Attachment | Content-Type | Size |
---|---|---|
0001-doc-cross-reference-to-unique-indexes-internals-from.patch | application/octet-stream | 1.5 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | Peter Geoghegan | 2022-06-09 23:59:47 | Re: Collation version tracking for macOS |
Previous Message | Jacob Champion | 2022-06-09 23:29:38 | Re: [PoC] Let libpq reject unexpected authentication requests |