]> granicus.if.org Git - postgresql/commit
Doc: document that we expect CHECK constraint conditions to be immutable.
authorTom Lane <tgl@sss.pgh.pa.us>
Fri, 7 Dec 2018 21:40:58 +0000 (16:40 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Fri, 7 Dec 2018 21:40:58 +0000 (16:40 -0500)
commit1f66c657f2b4eb55c68593d5c14256115aa6a0ea
tree676ddb2c22016dc429747e71161ffc0b5e3c45e3
parent1464755fc490a9911214817fe83077a3689250ab
Doc: document that we expect CHECK constraint conditions to be immutable.

This restriction is implicit in the check-only-once implementation we use
for table and domain constraints, but it wasn't spelled out anywhere, nor
was there any advice about how to alter a constraint's behavior safely.
Improve that.

I was also dissatisfied with the documentation of ALTER DOMAIN VALIDATE
CONSTRAINT, which entirely failed to explain the use of that feature; and
thence decided that ALTER TABLE VALIDATE CONSTRAINT could be documented
better as well.

Perhaps we should back-patch this, along with the related commit 36d442a25,
but for now I refrained.

Discussion: https://postgr.es/m/12539.1544107316@sss.pgh.pa.us
doc/src/sgml/ddl.sgml
doc/src/sgml/ref/alter_domain.sgml
doc/src/sgml/ref/alter_table.sgml
doc/src/sgml/ref/create_domain.sgml