summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/models/constraints.txt10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/ref/models/constraints.txt b/docs/ref/models/constraints.txt
index 6d24f43f67..aaadc78ee9 100644
--- a/docs/ref/models/constraints.txt
+++ b/docs/ref/models/constraints.txt
@@ -28,6 +28,16 @@ option.
(including ``name``) each time. Instead, specify the ``constraints`` option
on subclasses directly, providing a unique name for each constraint.
+.. admonition:: Validation of Constraints
+
+ In general constraints are **not** checked during ``full_clean()``, and do
+ not raise ``ValidationError``\s. Rather you'll get a database integrity
+ error on ``save()``. ``UniqueConstraint``\s are different in this regard,
+ in that they leverage the existing ``validate_unique()`` logic, and thus
+ enable two-stage validation. In addition to ``IntegrityError`` on
+ ``save()``, ``ValidationError`` is also raised during model validation when
+ the ``UniqueConstraint`` is violated.
+
``CheckConstraint``
===================