rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Use "TOAST table" in place of the vague, not-used-elsewhere phrase 

"supplementary storage table".
This commit is contained in:
Tom Lane 2010-05-13 18:54:18 +00:00
parent 9ead05b7c3
commit a4bbfb1aac
2 changed files with 17 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/src/sgml/ref/alter_table.sgml
View File

@ -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.

21
doc/src/sgml/ref/create_table.sgml
View File

@ -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
--> -->
@ -152,7 +152,7 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } ] TABLE <replaceable class="PAR
table is going to be used in complex queries, it is wise to run table is going to be used in complex queries, it is wise to run
<command>ANALYZE</> on the temporary table after it is populated. <command>ANALYZE</> on the temporary table after it is populated.
</para> </para>
<para> <para>
Optionally, <literal>GLOBAL</literal> or <literal>LOCAL</literal> Optionally, <literal>GLOBAL</literal> or <literal>LOCAL</literal>
can be written before <literal>TEMPORARY</> or <literal>TEMP</>. can be written before <literal>TEMPORARY</> or <literal>TEMP</>.
@ -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>