此模块中定义的类创建数据库约束。它们被添加到模型中 Meta.constraints 选择权。
引用内置约束
约束定义在 django.db.models.constraints 但为了方便起见，它们被进口到 django.db.models . 标准惯例是使用 from django.db import models 并将约束条件称为 models.<Foo>Constraint .
抽象基类中的约束
您必须始终为约束指定唯一的名称。因此，通常不能在抽象Base上指定约束，因为 Meta.constraints 选项由子类继承，属性的值完全相同（包括 name ）每次。为了解决名称冲突，名称的一部分可能包含 '%(app_label)s' 和 '%(class)s' ，它们分别被具体模型的大写应用程序标签和类名称替换。例如 CheckConstraint(condition=Q(age__gte=18), name='%(app_label)s_%(class)s_is_adult') 。
约束条件的验证
约束在运行期间检查 model validation 。
BaseConstraint¶所有约束的基类。子类必须实现 constraint_sql() ， create_sql() ， remove_sql() 和 validate() 方法：研究方法。
自 5.0 版本弃用: 不建议使用对传递位置参数的支持。
所有约束都有以下共同参数：
name¶约束的名称。您必须始终为约束指定唯一的名称。
violation_error_code¶出现以下情况时使用的错误代码 ValidationError 是在过程中引发的 model validation 。默认为 None 。
violation_error_message¶在以下情况下使用的错误消息 ValidationError 是在过程中引发的 model validation 。默认为 "Constraint “%(name)s” is violated." 。
validate()¶验证在上定义的约束 model ，是受到尊重的 instance 。这将在数据库上执行查询，以确保遵守约束。如果 exclude 列表来验证约束，则忽略该约束。
提高一名 ValidationError 如果违反了约束。
此方法必须由子类实现。
CheckConstraint¶在数据库中创建检查约束。
condition¶A Q 对象或布尔值 Expression 它指定您希望约束强制执行的条件检查。
例如, CheckConstraint(condition=Q(age__gte=18), name='age_gte_18') 确保年龄范围永远不低于18岁。
表达顺序
Q 论点顺序不一定保留，但 Q 表情本身被保留。对于出于性能原因保留检查约束表达顺序的数据库来说，这可能很重要。例如，如果顺序很重要，请使用以下格式：：
CheckConstraint(
condition=Q(age__gte=18) & Q(expensive_check=condition),
name="age_gte_18_and_others",
)
Oracle <23 c
Oracle < 23c上对可空字段进行检查必须包括允许 NULL 值的顺序 validate() 与检查约束验证的行为相同。例如，如果 age 是一个可以为空的字段：：
CheckConstraint(condition=Q(age__gte=18) | Q(age__isnull=True), name="age_gte_18")
自 5.1 版本弃用: 这个 check 属性被废弃，支持 condition 。
UniqueConstraint¶在数据库中创建唯一约束。
expressions¶位置论元 *expressions 允许在表达式和数据库函数上创建函数唯一约束。
例如：：
UniqueConstraint(Lower("name").desc(), "category", name="unique_lower_name_category")
属性的小写值创建唯一约束。 name 字段按降序排列，而 category 字段以默认升序排列。
函数唯一约束具有与相同的数据库限制 Index.expressions 。
fields¶指定要强制约束的唯一列集的字段名称列表。
例如， UniqueConstraint(fields=['room', 'date'], name='unique_booking') 确保每个房间每个日期只能预订一次。
condition¶A Q 对象，指定要强制约束的条件。
例如：：
UniqueConstraint(fields=["user"], condition=Q(status="DRAFT"), name="unique_draft_user")
确保每个用户只有一个草稿。
这些条件的数据库限制与 Index.condition .
deferrable¶设置此参数以创建可推迟的唯一约束。接受的价值观是 Deferrable.DEFERRED 或 Deferrable.IMMEDIATE 。例如：：
from django.db.models import Deferrable, UniqueConstraint
UniqueConstraint(
name="unique_order",
fields=["order"],
deferrable=Deferrable.DEFERRED,
)
默认情况下，约束不会被推迟。直到事务结束才会强制执行延迟约束。每次命令后都会立即实施立即约束。
SQL、MariaDB和SQLite。
在SQL、MariaDB和SQLite上，延迟的唯一约束被忽略，因为两者都不支持它们。
警告
延迟的唯一约束可能会导致 performance penalty 。
include¶要作为非键列包含在覆盖唯一索引中的字段名称的列表或多元组。这允许将仅索引扫描用于仅选择包含字段的查询 (include ）并仅按唯一字段过滤 (fields )。
例如：：
UniqueConstraint(name="unique_booking", fields=["room", "date"], include=["full_name"])
将允许过滤 room 和 date ，还选择 full_name ，而仅从索引中获取数据。
对于除PostgreSQL之外的数据库，具有非键列的唯一约束将被忽略。
非关键列具有与 Index.include 。
opclasses¶的名字 PostgreSQL operator classes 用于此独特的索引。如果您需要自定义操作符类，则必须为索引中的每个字段提供一个操作符类。
例如：：
UniqueConstraint(
name="unique_username", fields=["username"], opclasses=["varchar_pattern_ops"]
)
创建唯一的索引 username 使用 varchar_pattern_ops 。
opclasses 除了postgresql之外的数据库都被忽略。
nulls_distinct¶行是否包含 NULL 唯一约束所涵盖的值应该被认为是彼此不同的。缺省值为 None 它使用的数据库缺省值是 True 在大多数后端上。
例如：：
UniqueConstraint(name="ordering", fields=["ordering"], nulls_distinct=False)
创建唯一约束，该约束仅允许一行存储 NULL 中的值 ordering 纵队。
独特的限制 nulls_distinct 对于除了PostgreSQL 15+之外的数据库来说，被忽略。
violation_error_code¶出现以下情况时使用的错误代码 ValidationError 是在过程中引发的 model validation 。默认为 None 。
此代码为 not used 为 UniqueConstraint S与 fields 如果没有一个 condition 。是这样的 UniqueConstraint S的错误代码与使用 Field.unique 或在 Meta.unique_together 。
violation_error_message¶在以下情况下使用的错误消息 ValidationError 是在过程中引发的 model validation 。默认为 BaseConstraint.violation_error_message 。
这条消息是 not used 为 UniqueConstraint S与 fields 如果没有一个 condition 。是这样的 UniqueConstraint S显示的消息与使用 Field.unique 或在 Meta.unique_together 。
7月 22, 2024