aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorSimon Riggs <simon@2ndQuadrant.com>2013-06-18 12:09:39 +0100
committerSimon Riggs <simon@2ndQuadrant.com>2013-06-18 12:09:39 +0100
commit073d7cb513f5de44530f4bdbaaa4b5d4cce5f984 (patch)
treea50b74117b9168d2f246e075433138ea66913d99 /doc/src
parentc3c86ae2aff67676a49ec84240f1d6a482f359cb (diff)
downloadpostgresql-073d7cb513f5de44530f4bdbaaa4b5d4cce5f984.tar.gz
postgresql-073d7cb513f5de44530f4bdbaaa4b5d4cce5f984.zip
Fix docs on lock level for ALTER TABLE VALIDATE
ALTER TABLE .. VALIDATE CONSTRAINT previously gave incorrect details about lock levels and therefore incomplete reasons to use the option. Initial bug report and fix from Marko Tiikkaja Reworded by me to include comments by Kevin Grittner
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/alter_table.sgml10
1 files changed, 7 insertions, 3 deletions
diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index 5437626c3fe..7ee0aa8ca07 100644
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -324,9 +324,13 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable>
as <literal>NOT VALID</literal>, by scanning the table to ensure there
are no rows for which the constraint is not satisfied.
Nothing happens if the constraint is already marked valid.
- The value of separating validation from initial creation of the
- constraint is that validation requires a lesser lock on the table
- than constraint creation does.
+ </para>
+ <para>
+ Validation can be a long process on larger tables and currently requires
+ an <literal>ACCESS EXCLUSIVE</literal> lock. The value of separating
+ validation from initial creation is that you can defer validation to less
+ busy times, or can be used to give additional time to correct pre-existing
+ errors while preventing new errors.
</para>
</listitem>
</varlistentry>