diff options
author | Amit Kapila <akapila@postgresql.org> | 2021-03-24 11:10:12 +0530 |
---|---|---|
committer | Amit Kapila <akapila@postgresql.org> | 2021-03-24 11:29:15 +0530 |
commit | 26acb54a1368bf3706294400abca85b15c9233a6 (patch) | |
tree | 435436137df934ae0d011d271ab73a4710b4c893 /doc/src/sgml/ref/create_table.sgml | |
parent | 84007043fc1b1be68dad5d0a78269347c12094b6 (diff) | |
download | postgresql-26acb54a1368bf3706294400abca85b15c9233a6.tar.gz postgresql-26acb54a1368bf3706294400abca85b15c9233a6.zip |
Revert "Enable parallel SELECT for "INSERT INTO ... SELECT ..."."
To allow inserts in parallel-mode this feature has to ensure that all the
constraints, triggers, etc. are parallel-safe for the partition hierarchy
which is costly and we need to find a better way to do that. Additionally,
we could have used existing cached information in some cases like indexes,
domains, etc. to determine the parallel-safety.
List of commits reverted, in reverse chronological order:
ed62d3737c Doc: Update description for parallel insert reloption.
c8f78b6161 Add a new GUC and a reloption to enable inserts in parallel-mode.
c5be48f092 Improve FK trigger parallel-safety check added by 05c8482f7f.
e2cda3c20a Fix use of relcache TriggerDesc field introduced by commit 05c8482f7f.
e4e87a32cc Fix valgrind issue in commit 05c8482f7f.
05c8482f7f Enable parallel SELECT for "INSERT INTO ... SELECT ...".
Discussion: https://postgr.es/m/E1lMiB9-0001c3-SY@gemulon.postgresql.org
Diffstat (limited to 'doc/src/sgml/ref/create_table.sgml')
-rw-r--r-- | doc/src/sgml/ref/create_table.sgml | 31 |
1 files changed, 2 insertions, 29 deletions
diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml index c6c248f1e91..44e50620fd1 100644 --- a/doc/src/sgml/ref/create_table.sgml +++ b/doc/src/sgml/ref/create_table.sgml @@ -1369,9 +1369,8 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM If a table parameter value is set and the equivalent <literal>toast.</literal> parameter is not, the TOAST table will use the table's parameter value. - These parameters, with the exception of - <literal>parallel_insert_enabled</literal>, are not supported on partitioned - tables, but may be specified for individual leaf partitions. + Specifying these parameters for partitioned tables is not supported, + but you may specify them for individual leaf partitions. </para> <variablelist> @@ -1441,32 +1440,6 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM </listitem> </varlistentry> - <varlistentry id="reloption-parallel-insert-enabled" xreflabel="parallel_insert_enabled"> - <term><literal>parallel_insert_enabled</literal> (<type>boolean</type>) - <indexterm> - <primary><varname>parallel_insert_enabled</varname> storage parameter</primary> - </indexterm> - </term> - <listitem> - <para> - Enables or disables the query planner's use of parallel insert for - this table. When enabled (and provided that - <xref linkend="guc-enable-parallel-insert"/> is also <literal>true</literal>), - the planner performs additional parallel-safety checks on the table's - attributes and indexes, in order to determine if it's safe to use a - parallel plan for <command>INSERT</command>. The default is - <literal>true</literal>. In cases such as when the table has a large - number of partitions, and particularly also when that table uses a - parallel-unsafe feature that prevents parallelism, the overhead of these - checks may become prohibitively high. To address this potential overhead - in these cases, this option can be used to disable the use of parallel - insert for this table. Note that if the target table of the parallel - insert is partitioned, the <literal>parallel_insert_enabled</literal> - option values of the partitions are ignored. - </para> - </listitem> - </varlistentry> - <varlistentry id="reloption-autovacuum-enabled" xreflabel="autovacuum_enabled"> <term><literal>autovacuum_enabled</literal>, <literal>toast.autovacuum_enabled</literal> (<type>boolean</type>) <indexterm> |