mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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

Browse Source 
"supplementary storage table".
This commit is contained in:
Tom Lane 2010-05-13 18:54:23 +00:00
parent a5389c1ad5
commit 099aff05c3
2 changed files with 14 additions and 13 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.106 2009/05/03 20:45:43 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.106.2.1 2010/05/13 18:54:23 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -163,7 +163,8 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
<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,
@ -171,9 +172,9 @@ where <replaceable class="PARAMETER">action</replaceable> is one of:
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.

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

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.114.2.1 2009/10/27 14:00:15 alvherre Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.114.2.2 2010/05/13 18:54:23 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -696,11 +696,12 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
indexes are documented in <xref linkend="SQL-CREATEINDEX" indexes are documented in <xref linkend="SQL-CREATEINDEX"
endterm="sql-createindex-title">. The storage parameters currently endterm="sql-createindex-title">. 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>
@ -719,8 +720,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
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>