Commit 11746900 authored by Simon Riggs's avatar Simon Riggs

Additional docs for toast_tuple_target changes

parent 59af8d43
...@@ -429,7 +429,7 @@ when a row value to be stored in a table is wider than ...@@ -429,7 +429,7 @@ when a row value to be stored in a table is wider than
<symbol>TOAST_TUPLE_THRESHOLD</symbol> bytes (normally 2 kB). <symbol>TOAST_TUPLE_THRESHOLD</symbol> bytes (normally 2 kB).
The <acronym>TOAST</acronym> code will compress and/or move The <acronym>TOAST</acronym> code will compress and/or move
field values out-of-line until the row value is shorter than field values out-of-line until the row value is shorter than
<symbol>TOAST_TUPLE_TARGET</symbol> bytes (also normally 2 kB) <symbol>TOAST_TUPLE_TARGET</symbol> bytes (also normally 2 kB, adjustable)
or no more gains can be had. During an UPDATE or no more gains can be had. During an UPDATE
operation, values of unchanged fields are normally preserved as-is; so an operation, values of unchanged fields are normally preserved as-is; so an
UPDATE of a row with out-of-line values incurs no <acronym>TOAST</acronym> costs if UPDATE of a row with out-of-line values incurs no <acronym>TOAST</acronym> costs if
...@@ -483,6 +483,11 @@ of that data type, but the strategy for a given table column can be altered ...@@ -483,6 +483,11 @@ of that data type, but the strategy for a given table column can be altered
with <link linkend="sql-altertable"><command>ALTER TABLE ... SET STORAGE</command></link>. with <link linkend="sql-altertable"><command>ALTER TABLE ... SET STORAGE</command></link>.
</para> </para>
<para>
<symbol>TOAST_TUPLE_TARGET</symbol> can be adjusted for each table using
<link linkend="sql-altertable"><command>ALTER TABLE ... SET (toast_tuple_target = N)</command></link>
</para>
<para> <para>
This scheme has a number of advantages compared to a more straightforward This scheme has a number of advantages compared to a more straightforward
approach such as allowing row values to span pages. Assuming that queries are approach such as allowing row values to span pages. Assuming that queries are
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment