Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 7a9328e

Browse files
committed
docs: Update HOT update docs for 19d8e23
Commit 19d8e23 changed when the HOT update optimization is possible but neglected to update the Heap-Only Tuples (HOT) documentation. This patch updates that documentation accordingly. Author: Elizabeth Christensen Backpatch-through: 16 Reviewed-By: Stephen Frost, Alvaro Herrera Discussion: https://postgr.es/m/CABoUFXRjisr58Ct_3VsFEdQx+fJeQTWTdJnM7XAp=8MUbtoa9A@mail.gmail.com
1 parent c7ea3f4 commit 7a9328e

File tree

1 file changed

+11
-10
lines changed

1 file changed

+11
-10
lines changed

doc/src/sgml/storage.sgml

+11-10
Original file line numberDiff line numberDiff line change
@@ -1097,8 +1097,10 @@ data. Empty in ordinary tables.</entry>
10971097
<itemizedlist>
10981098
<listitem>
10991099
<para>
1100-
The update does not modify any columns referenced by the table's
1101-
indexes, including expression and partial indexes.
1100+
The update does not modify any columns referenced by the table's indexes,
1101+
not including summarizing indexes. The only summarizing index method in
1102+
the core <productname>PostgreSQL</productname> distribution is <link
1103+
linkend="brin">BRIN</link>.
11021104
</para>
11031105
</listitem>
11041106
<listitem>
@@ -1114,7 +1116,8 @@ data. Empty in ordinary tables.</entry>
11141116
<itemizedlist>
11151117
<listitem>
11161118
<para>
1117-
New index entries are not needed to represent updated rows.
1119+
New index entries are not needed to represent updated rows, however,
1120+
summary indexes may still need to be updated.
11181121
</para>
11191122
</listitem>
11201123
<listitem>
@@ -1130,14 +1133,12 @@ data. Empty in ordinary tables.</entry>
11301133
</para>
11311134

11321135
<para>
1133-
In summary, heap-only tuple updates can only be created
1134-
if columns used by indexes are not updated. You can
1135-
increase the likelihood of sufficient page space for
1136+
You can increase the likelihood of sufficient page space for
11361137
<acronym>HOT</acronym> updates by decreasing a table's <link
1137-
linkend="reloption-fillfactor"><literal>fillfactor</literal></link>.
1138-
If you don't, <acronym>HOT</acronym> updates will still happen because
1139-
new rows will naturally migrate to new pages and existing pages with
1140-
sufficient free space for new row versions. The system view <link
1138+
linkend="reloption-fillfactor"><literal>fillfactor</literal></link>. If you
1139+
don't, <acronym>HOT</acronym> updates will still happen because new rows
1140+
will naturally migrate to new pages and existing pages with sufficient free
1141+
space for new row versions. The system view <link
11411142
linkend="monitoring-pg-stat-all-tables-view">pg_stat_all_tables</link>
11421143
allows monitoring of the occurrence of HOT and non-HOT updates.
11431144
</para>

0 commit comments

Comments
 (0)