doc: alter table references bogus table-specific planner parameters
Justin Pryzby <pryzby@telsasoft.com>
From: Justin Pryzby <pryzby@telsasoft.com>
To: pgsql-hackers@lists.postgresql.org
Cc: Simon Riggs <simon@2ndQuadrant.com>
Date: 2020-01-06T02:56:23Z
Lists: pgsql-hackers, pgsql-performance
Attachments
- v1-0001-Fixes-for-commit-6f3a13ff.patch (text/x-diff)
commit 6f3a13ff058f15d565a30c16c0c2cb14cc994e42 Enhance docs for ALTER TABLE lock levels of storage parms
Author: Simon Riggs <simon@2ndQuadrant.com>
Date: Mon Mar 6 16:48:12 2017 +0530
<varlistentry>
<term><literal>SET ( <replaceable class="PARAMETER">storage_parameter</replaceable> = <replaceable class="PARAMETER">value</replaceable> [, ... ] )</literal></term>
...
- Changing fillfactor and autovacuum storage parameters acquires a <literal>SHARE UPDATE EXCLUSIVE</literal> lock.
+ <literal>SHARE UPDATE EXCLUSIVE</literal> lock will be taken for
+ fillfactor and autovacuum storage parameters, as well as the
+ following planner related parameters:
+ effective_io_concurrency, parallel_workers, seq_page_cost
+ random_page_cost, n_distinct and n_distinct_inherited.
effective_io_concurrency, seq_page_cost and random_page_cost cannot be set for
a table - reloptions.c shows that they've always been RELOPT_KIND_TABLESPACE.
n_distinct lock mode seems to have been changed and documented at e5550d5f ;
21d4e2e2 claimed to do the same, but the LOCKMODE is never used.
See also:
commit 21d4e2e20656381b4652eb675af4f6d65053607f Reduce lock levels for table storage params related to planning
Author: Simon Riggs <simon@2ndQuadrant.com>
Date: Mon Mar 6 16:04:31 2017 +0530
commit 47167b7907a802ed39b179c8780b76359468f076 Reduce lock levels for ALTER TABLE SET autovacuum storage options
Author: Simon Riggs <simon@2ndQuadrant.com>
Date: Fri Aug 14 14:19:28 2015 +0100
commit e5550d5fec66aa74caad1f79b79826ec64898688 Reduce lock levels of some ALTER TABLE cmds
Author: Simon Riggs <simon@2ndQuadrant.com>
Date: Sun Apr 6 11:13:43 2014 -0400
commit 2dbbda02e7e688311e161a912a0ce00cde9bb6fc Reduce lock levels of CREATE TRIGGER and some ALTER TABLE, CREATE RULE actions.
Author: Simon Riggs <simon@2ndQuadrant.com>
Date: Wed Jul 28 05:22:24 2010 +0000
commit d86d51a95810caebcea587498068ff32fe28293e Support ALTER TABLESPACE name SET/RESET ( tablespace_options ).
Author: Robert Haas <rhaas@postgresql.org>
Date: Tue Jan 5 21:54:00 2010 +0000
Justin
Commits
-
Doc: Fix list of storage parameters available for ALTER TABLE
- b9a9cb1bfd6e 10.12 landed
- b9988facaec8 11.7 landed
- c4c76d198e3d 12.2 landed
- 6de7bcb76f65 13.0 landed
-
Enhance docs for ALTER TABLE lock levels of storage parms
- 6f3a13ff058f 10.0 cited
-
Reduce lock levels for table storage params related to planning
- 21d4e2e20656 10.0 cited
-
Reduce lock levels for ALTER TABLE SET autovacuum storage options
- 47167b7907a8 9.6.0 cited
-
Reduce lock levels of some ALTER TABLE cmds
- e5550d5fec66 9.4.0 cited
-
Reduce lock levels of CREATE TRIGGER and some ALTER TABLE, CREATE RULE actions.
- 2dbbda02e7e6 9.1.0 cited
-
Support ALTER TABLESPACE name SET/RESET ( tablespace_options ).
- d86d51a95810 9.0.0 cited