v1-0001-Doc-indexUnchanged-is-strictly-a-hint.patch
application/octet-stream
Filename: v1-0001-Doc-indexUnchanged-is-strictly-a-hint.patch
Type: application/octet-stream
Part: 0
Patch
Same data as JSON:
GET /api/v1/attachments/:id/patch
the parsed metadata as JSON — format, series position, per-file stats; never the diff bytes.
API reference →
Format: format-patch
Series: patch v1-0001
Subject: Doc: indexUnchanged is strictly a hint.
| File | + | − |
|---|---|---|
| doc/src/sgml/indexam.sgml | 7 | 3 |
From 80bf0f3fc8e894c5f2e24728ca6aa75a0de665d7 Mon Sep 17 00:00:00 2001
From: Peter Geoghegan <pg@bowt.ie>
Date: Mon, 23 Oct 2023 15:00:42 -0700
Subject: [PATCH v1] Doc: indexUnchanged is strictly a hint.
---
doc/src/sgml/indexam.sgml | 10 +++++++---
1 file changed, 7 insertions(+), 3 deletions(-)
diff --git a/doc/src/sgml/indexam.sgml b/doc/src/sgml/indexam.sgml
index e813e2b62..30eda37af 100644
--- a/doc/src/sgml/indexam.sgml
+++ b/doc/src/sgml/indexam.sgml
@@ -332,9 +332,13 @@ aminsert (Relation indexRelation,
modify any columns covered by the index, but nevertheless requires a
new version in the index. The index AM may use this hint to decide
to apply bottom-up index deletion in parts of the index where many
- versions of the same logical row accumulate. Note that updating a
- non-key column does not affect the value of
- <literal>indexUnchanged</literal>.
+ versions of the same logical row accumulate. Note that updating a non-key
+ column or a column that only appears in a partial index predicate does not
+ affect the value of <literal>indexUnchanged</literal>. The core code
+ determines each tuple's <literal>indexUnchanged</literal> value using a low
+ overhead approach that allows both false positives and false negatives.
+ Index AMs must not treat <literal>indexUnchanged</literal> as an
+ authoritative source of information about tuple visibility or versioning.
</para>
<para>
--
2.42.0