Use "TOAST table" in place of the vague, not-used-elsewhere phrase
"supplementary storage table".
This commit is contained in:
parent
9ead05b7c3
commit
a4bbfb1aac
|
@ -1,5 +1,5 @@
|
||||||
<!--
|
<!--
|
||||||
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.112 2010/04/03 07:22:57 petere Exp $
|
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.113 2010/05/13 18:54:18 tgl Exp $
|
||||||
PostgreSQL documentation
|
PostgreSQL documentation
|
||||||
-->
|
-->
|
||||||
|
|
||||||
|
@ -200,7 +200,8 @@ ALTER TABLE <replaceable class="PARAMETER">name</replaceable>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
This form sets the storage mode for a column. This controls whether this
|
This form sets the storage mode for a column. This controls whether this
|
||||||
column is held inline or in a supplementary table, and whether the data
|
column is held inline or in a secondary <acronym>TOAST</> table, and
|
||||||
|
whether the data
|
||||||
should be compressed or not. <literal>PLAIN</literal> must be used
|
should be compressed or not. <literal>PLAIN</literal> must be used
|
||||||
for fixed-length values such as <type>integer</type> and is
|
for fixed-length values such as <type>integer</type> and is
|
||||||
inline, uncompressed. <literal>MAIN</literal> is for inline,
|
inline, uncompressed. <literal>MAIN</literal> is for inline,
|
||||||
|
@ -208,9 +209,9 @@ ALTER TABLE <replaceable class="PARAMETER">name</replaceable>
|
||||||
uncompressed data, and <literal>EXTENDED</literal> is for external,
|
uncompressed data, and <literal>EXTENDED</literal> is for external,
|
||||||
compressed data. <literal>EXTENDED</literal> is the default for most
|
compressed data. <literal>EXTENDED</literal> is the default for most
|
||||||
data types that support non-<literal>PLAIN</literal> storage.
|
data types that support non-<literal>PLAIN</literal> storage.
|
||||||
Use of <literal>EXTERNAL</literal> will
|
Use of <literal>EXTERNAL</literal> will make substring operations on
|
||||||
make substring operations on <type>text</type> and <type>bytea</type>
|
very large <type>text</type> and <type>bytea</type> values run faster,
|
||||||
columns faster, at the penalty of increased storage space. Note that
|
at the penalty of increased storage space. Note that
|
||||||
<literal>SET STORAGE</> doesn't itself change anything in the table,
|
<literal>SET STORAGE</> doesn't itself change anything in the table,
|
||||||
it just sets the strategy to be pursued during future table updates.
|
it just sets the strategy to be pursued during future table updates.
|
||||||
See <xref linkend="storage-toast"> for more information.
|
See <xref linkend="storage-toast"> for more information.
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
<!--
|
<!--
|
||||||
$PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.126 2010/04/16 02:22:33 momjian Exp $
|
$PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.127 2010/05/13 18:54:18 tgl Exp $
|
||||||
PostgreSQL documentation
|
PostgreSQL documentation
|
||||||
-->
|
-->
|
||||||
|
|
||||||
|
@ -803,13 +803,15 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable class="PAR
|
||||||
for tables, and for indexes associated with a <literal>UNIQUE</literal>,
|
for tables, and for indexes associated with a <literal>UNIQUE</literal>,
|
||||||
<literal>PRIMARY KEY</literal>, or <literal>EXCLUDE</> constraint.
|
<literal>PRIMARY KEY</literal>, or <literal>EXCLUDE</> constraint.
|
||||||
Storage parameters for
|
Storage parameters for
|
||||||
indexes are documented in <xref linkend="SQL-CREATEINDEX">. The storage parameters currently
|
indexes are documented in <xref linkend="SQL-CREATEINDEX">.
|
||||||
|
The storage parameters currently
|
||||||
available for tables are listed below. For each parameter, unless noted,
|
available for tables are listed below. For each parameter, unless noted,
|
||||||
there is an additional, identically named parameter, prefixed with
|
there is an additional parameter with the same name prefixed with
|
||||||
<literal>toast.</literal> which can be used to control the behavior of the
|
<literal>toast.</literal>, which can be used to control the behavior of the
|
||||||
supplementary storage table, if any; see <xref linkend="storage-toast">.
|
table's secondary <acronym>TOAST</> table, if any
|
||||||
Note that the supplementary storage table inherits the
|
(see <xref linkend="storage-toast"> for more information about TOAST).
|
||||||
<literal>autovacuum</literal> values from its parent table, if there are
|
Note that the TOAST table inherits the
|
||||||
|
<literal>autovacuum_*</literal> values from its parent table, if there are
|
||||||
no <literal>toast.autovacuum_*</literal> settings set.
|
no <literal>toast.autovacuum_*</literal> settings set.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
@ -828,8 +830,7 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable class="PAR
|
||||||
original, which is more efficient than placing it on a different page.
|
original, which is more efficient than placing it on a different page.
|
||||||
For a table whose entries are never updated, complete packing is the
|
For a table whose entries are never updated, complete packing is the
|
||||||
best choice, but in heavily updated tables smaller fillfactors are
|
best choice, but in heavily updated tables smaller fillfactors are
|
||||||
appropriate. This parameter cannot be set for the supplementary
|
appropriate. This parameter cannot be set for TOAST tables.
|
||||||
storage table.
|
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
Loading…
Reference in New Issue