diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index 356419e2d08..e4ef90ed9dd 100644 --- a/doc/src/sgml/ref/alter_table.sgml +++ b/doc/src/sgml/ref/alter_table.sgml @@ -326,9 +326,13 @@ ALTER TABLE [ IF EXISTS ] name as NOT VALID, 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. + + + Validation can be a long process on larger tables and currently requires + an ACCESS EXCLUSIVE 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.