From: Tom Lane Date: Thu, 13 May 2010 18:54:23 +0000 (+0000) Subject: Use "TOAST table" in place of the vague, not-used-elsewhere phrase X-Git-Tag: REL8_4_4~4 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=099aff05c3468de94626d1827ea1b39bda4ed6da;p=postgresql Use "TOAST table" in place of the vague, not-used-elsewhere phrase "supplementary storage table". --- diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index cccbfd2da6..ad7080139d 100644 --- a/doc/src/sgml/ref/alter_table.sgml +++ b/doc/src/sgml/ref/alter_table.sgml @@ -1,5 +1,5 @@ @@ -163,7 +163,8 @@ where action is one of: 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 TOAST table, and + whether the data should be compressed or not. PLAIN must be used for fixed-length values such as integer and is inline, uncompressed. MAIN is for inline, @@ -171,9 +172,9 @@ where action is one of: uncompressed data, and EXTENDED is for external, compressed data. EXTENDED is the default for most data types that support non-PLAIN storage. - Use of EXTERNAL will - make substring operations on text and bytea - columns faster, at the penalty of increased storage space. Note that + Use of EXTERNAL will make substring operations on + very large text and bytea values run faster, + at the penalty of increased storage space. Note that SET STORAGE doesn't itself change anything in the table, it just sets the strategy to be pursued during future table updates. See for more information. diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml index ad64cd32b7..1d0b8a4904 100644 --- a/doc/src/sgml/ref/create_table.sgml +++ b/doc/src/sgml/ref/create_table.sgml @@ -1,5 +1,5 @@ @@ -696,11 +696,12 @@ and table_constraint is: indexes are documented in . The storage parameters currently available for tables are listed below. For each parameter, unless noted, - there is an additional, identically named parameter, prefixed with - toast. which can be used to control the behavior of the - supplementary storage table, if any; see . - Note that the supplementary storage table inherits the - autovacuum values from its parent table, if there are + there is an additional parameter with the same name prefixed with + toast., which can be used to control the behavior of the + table's secondary TOAST table, if any + (see for more information about TOAST). + Note that the TOAST table inherits the + autovacuum_* values from its parent table, if there are no toast.autovacuum_* settings set. @@ -719,8 +720,7 @@ and table_constraint is: original, which is more efficient than placing it on a different page. For a table whose entries are never updated, complete packing is the best choice, but in heavily updated tables smaller fillfactors are - appropriate. This parameter cannot be set for the supplementary - storage table. + appropriate. This parameter cannot be set for TOAST tables.