{"title":"约束参考","version":"5.0","locale":"zh-hans","docname":"ref/models/constraints","url":"/zh-hans/5.0/ref/models/constraints/","canonical":"https://djangodocs.dev/zh-hans/5.0/ref/models/constraints/","summary":"本模块中定义的类可以创建数据库约束。它们被添加到模型中 Meta.constraints 选项中。","html":"<span id=\"constraints-reference\"></span><h1>约束参考<a class=\"heading-anchor\" href=\"#module-django.db.models.constraints\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>本模块中定义的类可以创建数据库约束。它们被添加到模型中 <code class=\"xref py py-attr docutils literal notranslate\">Meta.constraints</code> 选项中。</p>\n<aside class=\"admonition-referencing-built-in-constraints admonition\" role=\"note\">\n<p class=\"admonition-title\">引用内置约束</p>\n<p>约束是在 <code class=\"docutils literal notranslate\">django.db.models.constraint</code> 中定义的，但为了方便，它们被导入到 <a class=\"reference internal\" href=\"/zh-hans/5.0/topics/db/models/#module-django.db.models\" title=\"django.db.models\"><code class=\"xref py py-mod docutils literal notranslate\">django.db.models</code></a> 中。标准的惯例是使用 <code class=\"docutils literal notranslate\">from django.db import models</code> 作为 <code class=\"docutils literal notranslate\">models.&lt;Foo&gt;Constraint</code>。</p>\n</aside>\n<aside class=\"admonition-constraints-in-abstract-base-classes admonition\" role=\"note\">\n<p class=\"admonition-title\">抽象基类中的约束</p>\n<p>你必须始终为约束指定一个唯一的名称。因此，你通常不能在抽象基类上指定一个约束，因为 <code class=\"xref py py-attr docutils literal notranslate\">Meta.craces</code> 选项是由子类继承的，每次的属性值（包括 <code class=\"docutils literal notranslate\">name</code>）都完全相同。为了解决名称碰撞的问题，名称的一部分可能包含 <code class=\"docutils literal notranslate\">'%(app_label)s'</code> 和 <code class=\"docutils literal notranslate\">'%(class)s'</code>，它们分别被具体模型的小写应用标签和类名所代替。例如 <code class=\"docutils literal notranslate\">CheckConstraint(check=Q(age__gte=18)，name='%(app_label)s_%(class)s_is_adult')</code>。</p>\n</aside>\n<aside class=\"admonition-validation-of-constraints admonition\" role=\"note\">\n<p class=\"admonition-title\">约束的验证</p>\n<p>约束在 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/instances/#validating-objects\"><span class=\"std std-ref\">模型验证</span></a> 过程中进行检查。</p>\n</aside>\n<aside class=\"admonition-validation-of-constraints-with-jsonfield admonition\" role=\"note\">\n<p class=\"admonition-title\">对于 <code class=\"docutils literal notranslate\">JSONField</code> 的约束验证</p>\n<p>包含 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/fields/#django.db.models.JSONField\" title=\"django.db.models.JSONField\"><code class=\"xref py py-class docutils literal notranslate\">JSONField</code></a> 的约束可能不会引发验证错误，因为键、索引和路径转换具有许多与数据库相关的注意事项。这个问题 <a class=\"extlink-ticket reference external\" href=\"https://code.djangoproject.com/ticket/34059\">可能在以后被完全支持</a>。</p>\n<p>您应该始终检查是否有来自 <code class=\"docutils literal notranslate\">django.db.models</code> 记录器的日志消息，例如 <em>&quot;在...上调用 check() 时出现了数据库错误&quot;</em>，以确认它已正确验证。</p>\n</aside>\n<section id=\"baseconstraint\">\n<h2><code class=\"docutils literal notranslate\">BaseConstraint</code><a class=\"heading-anchor\" href=\"#baseconstraint\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.BaseConstraint\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">BaseConstraint</span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"o\">*</span>name</em>, <em class=\"sig-param\">violation_error_code<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">violation_error_message<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.BaseConstraint\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>所有约束的基类。子类必须实现 <code class=\"docutils literal notranslate\">constraint_sql()</code>, <code class=\"docutils literal notranslate\">create_sql()</code>, <code class=\"docutils literal notranslate\">remove_sql()</code> 和 <code class=\"docutils literal notranslate\">validate()</code> 方法。</p>\n<aside class=\"version-note version-deprecated\" data-version=\"5.0\" role=\"note\">\n<p class=\"version-note-title\">Deprecated since Django 5.0</p><p><span class=\"versionmodified deprecated\">Deprecated since version 5.0: </span>不再支持传递位置参数。</p>\n</aside>\n</dd></dl>\n\n<p>所有约束都有以下共同的参数：</p>\n<section id=\"name\">\n<h3><code class=\"docutils literal notranslate\">name</code><a class=\"heading-anchor\" href=\"#name\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.BaseConstraint.name\">\n<span class=\"sig-prename descclassname\">BaseConstraint.</span><span class=\"sig-name descname\">name</span><a class=\"heading-anchor\" href=\"#django.db.models.BaseConstraint.name\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>约束的名称。你必须始终为约束指定一个唯一的名称。</p>\n</section>\n<section id=\"violation-error-code\">\n<h3><code class=\"docutils literal notranslate\">violation_error_code</code><a class=\"heading-anchor\" href=\"#violation-error-code\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<aside class=\"version-note version-added\" data-version=\"5.0\" role=\"note\">\n<p class=\"version-note-title\">New in Django 5.0</p></aside>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.BaseConstraint.violation_error_code\">\n<span class=\"sig-prename descclassname\">BaseConstraint.</span><span class=\"sig-name descname\">violation_error_code</span><a class=\"heading-anchor\" href=\"#django.db.models.BaseConstraint.violation_error_code\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>在 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/instances/#validating-objects\"><span class=\"std std-ref\">模型验证</span></a> 过程中引发 <code class=\"docutils literal notranslate\">ValidationError</code> 时使用的错误代码。默认值为 <code class=\"docutils literal notranslate\">None</code>。</p>\n</section>\n<section id=\"violation-error-message\">\n<h3><code class=\"docutils literal notranslate\">violation_error_message</code><a class=\"heading-anchor\" href=\"#violation-error-message\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.BaseConstraint.violation_error_message\">\n<span class=\"sig-prename descclassname\">BaseConstraint.</span><span class=\"sig-name descname\">violation_error_message</span><a class=\"heading-anchor\" href=\"#django.db.models.BaseConstraint.violation_error_message\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>在 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/instances/#validating-objects\"><span class=\"std std-ref\">模型验证</span></a> 过程中引发 <code class=\"docutils literal notranslate\">ValidationError</code> 时使用的错误消息。默认为 <code class=\"docutils literal notranslate\">&quot;违反了约束“%(name)s”&quot;</code>。</p>\n</section>\n<section id=\"validate\">\n<h3><code class=\"docutils literal notranslate\">validate()</code><a class=\"heading-anchor\" href=\"#validate\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.BaseConstraint.validate\">\n<span class=\"sig-prename descclassname\">BaseConstraint.</span><span class=\"sig-name descname\">validate</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">model</em>, <em class=\"sig-param\">instance</em>, <em class=\"sig-param\">exclude<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">using<span class=\"o\">=</span><span class=\"default_value\">DEFAULT_DB_ALIAS</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.BaseConstraint.validate\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>验证在 <code class=\"docutils literal notranslate\">model</code> 上定义的约束是否在 <code class=\"docutils literal notranslate\">instance</code> 上被遵守。这将在数据库上执行一个查询，以确保该约束被遵守。如果需要使用 <code class=\"docutils literal notranslate\">exclude</code> 列表中的字段来验证约束，则会忽略该约束。</p>\n<p>如果违反了约束，则引发 <code class=\"docutils literal notranslate\">ValidationError</code>。</p>\n<p>这个方法必须由子类来实现。</p>\n</section>\n</section>\n<section id=\"checkconstraint\">\n<h2><code class=\"docutils literal notranslate\">CheckConstraint</code><a class=\"heading-anchor\" href=\"#checkconstraint\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.CheckConstraint\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">CheckConstraint</span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"keyword-only-separator o\"><abbr title=\"Keyword-only parameters separator (PEP 3102)\">*</abbr></span></em>, <em class=\"sig-param\">check</em>, <em class=\"sig-param\">name</em>, <em class=\"sig-param\">violation_error_code<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">violation_error_message<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.CheckConstraint\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>在数据库中创建一个检查约束</p>\n</dd></dl>\n\n<section id=\"check\">\n<h3><code class=\"docutils literal notranslate\">check</code><a class=\"heading-anchor\" href=\"#check\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.CheckConstraint.check\">\n<span class=\"sig-prename descclassname\">CheckConstraint.</span><span class=\"sig-name descname\">check</span><a class=\"heading-anchor\" href=\"#django.db.models.CheckConstraint.check\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>一个 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/querysets/#django.db.models.Q\" title=\"django.db.models.Q\"><code class=\"xref py py-class docutils literal notranslate\">Q</code></a> 对象或布尔值 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/expressions/#django.db.models.Expression\" title=\"django.db.models.Expression\"><code class=\"xref py py-class docutils literal notranslate\">Expression</code></a>，它指定了你要强制约束的检查。</p>\n<p>例如，<code class=\"docutils literal notranslate\">CheckConstraint(check=Q(age__gte=18), name='age_gte_18')</code> 确保年龄字段永远不小于 18。</p>\n<aside class=\"admonition-expression-order admonition\" role=\"note\">\n<p class=\"admonition-title\">表达式顺序</p>\n<p><code class=\"docutils literal notranslate\">Q</code> 参数的顺序未必会被保留，但 <code class=\"docutils literal notranslate\">Q</code> 表达式本身的顺序会被保留。这对于一些为了性能原因而保留检查约束表达式顺序的数据库可能很重要。例如，如果顺序很重要，请使用以下格式：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>CheckConstraint<span class=\"p\">(</span>\n    check<span class=\"o\">=</span>Q<span class=\"p\">(</span>age__gte<span class=\"o\">=</span><span class=\"mi\">18</span><span class=\"p\">)</span> <span class=\"o\">&amp;</span> Q<span class=\"p\">(</span>expensive_check<span class=\"o\">=</span>condition<span class=\"p\">),</span>\n    name<span class=\"o\">=</span><span class=\"s2\">&quot;age_gte_18_and_others&quot;</span><span class=\"p\">,</span>\n<span class=\"p\">)</span>\n</code></pre></div>\n</aside>\n<aside class=\"admonition-oracle admonition\" role=\"note\">\n<p class=\"admonition-title\">Oracle</p>\n<p>在 Oracle 上对可空字段进行检查时，必须包含一个允许 <code class=\"docutils literal notranslate\">NULL</code> 值的条件，以使 <a class=\"reference internal\" href=\"#django.db.models.BaseConstraint.validate\" title=\"django.db.models.BaseConstraint.validate\"><code class=\"xref py py-meth docutils literal notranslate\">validate()</code></a> 的行为与检查约束验证相同。例如，如果 <code class=\"docutils literal notranslate\">age</code> 是可空字段：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>CheckConstraint<span class=\"p\">(</span>check<span class=\"o\">=</span>Q<span class=\"p\">(</span>age__gte<span class=\"o\">=</span><span class=\"mi\">18</span><span class=\"p\">)</span> <span class=\"o\">|</span> Q<span class=\"p\">(</span>age__isnull<span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">),</span> name<span class=\"o\">=</span><span class=\"s2\">&quot;age_gte_18&quot;</span><span class=\"p\">)</span>\n</code></pre></div>\n</aside>\n</section>\n</section>\n<section id=\"uniqueconstraint\">\n<h2><code class=\"docutils literal notranslate\">UniqueConstraint</code><a class=\"heading-anchor\" href=\"#uniqueconstraint\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">UniqueConstraint</span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"o\">*</span>expressions</em>, <em class=\"sig-param\">fields<span class=\"o\">=</span><span class=\"default_value\">()</span></em>, <em class=\"sig-param\">name<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">condition<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">deferrable<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">include<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">opclasses<span class=\"o\">=</span><span class=\"default_value\">()</span></em>, <em class=\"sig-param\">nulls_distinct<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">violation_error_code<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">violation_error_message<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>在数据库中创建一个唯一约束。</p>\n</dd></dl>\n\n<section id=\"expressions\">\n<h3><code class=\"docutils literal notranslate\">expressions</code><a class=\"heading-anchor\" href=\"#expressions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.expressions\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">expressions</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.expressions\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>位置参数 <code class=\"docutils literal notranslate\">*expressions</code> 允许在表达式和数据库函数上创建功能性唯一约束。</p>\n<p>例子：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>UniqueConstraint<span class=\"p\">(</span>Lower<span class=\"p\">(</span><span class=\"s2\">&quot;name&quot;</span><span class=\"p\">)</span><span class=\"o\">.</span>desc<span class=\"p\">(),</span> <span class=\"s2\">&quot;category&quot;</span><span class=\"p\">,</span> name<span class=\"o\">=</span><span class=\"s2\">&quot;unique_lower_name_category&quot;</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>在降序中的 <code class=\"docutils literal notranslate\">name</code> 字段的小写值和默认升序中的 <code class=\"docutils literal notranslate\">category</code> 字段上创建了一个唯一约束。</p>\n<p>功能性唯一约束具有与 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/indexes/#django.db.models.Index.expressions\" title=\"django.db.models.Index.expressions\"><code class=\"xref py py-attr docutils literal notranslate\">Index.expressions</code></a> 相同的数据库限制。</p>\n</section>\n<section id=\"fields\">\n<h3><code class=\"docutils literal notranslate\">fields</code><a class=\"heading-anchor\" href=\"#fields\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.fields\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">fields</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.fields\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>一个字段名的列表，它指定了你要强制约束的唯一列集。</p>\n<p>例如，<code class=\"docutils literal notranslate\">UniqueConstraint(field=['room', 'date'], name='unique_booking')</code> 确保每个房间在每个日期只能被预订一次。</p>\n</section>\n<section id=\"condition\">\n<h3><code class=\"docutils literal notranslate\">condition</code><a class=\"heading-anchor\" href=\"#condition\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.condition\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">condition</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.condition\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>一个 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/querysets/#django.db.models.Q\" title=\"django.db.models.Q\"><code class=\"xref py py-class docutils literal notranslate\">Q</code></a> 对象，用于指定你想要强制执行的约束条件。</p>\n<p>例子：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>UniqueConstraint<span class=\"p\">(</span>fields<span class=\"o\">=</span><span class=\"p\">[</span><span class=\"s2\">&quot;user&quot;</span><span class=\"p\">],</span> condition<span class=\"o\">=</span>Q<span class=\"p\">(</span>status<span class=\"o\">=</span><span class=\"s2\">&quot;DRAFT&quot;</span><span class=\"p\">),</span> name<span class=\"o\">=</span><span class=\"s2\">&quot;unique_draft_user&quot;</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>确保每个用户只有一份草稿。</p>\n<p>这些条件与 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/indexes/#django.db.models.Index.condition\" title=\"django.db.models.Index.condition\"><code class=\"xref py py-attr docutils literal notranslate\">Index.condition</code></a> 具有相同的数据库限制。</p>\n</section>\n<section id=\"deferrable\">\n<h3><code class=\"docutils literal notranslate\">deferrable</code><a class=\"heading-anchor\" href=\"#deferrable\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.deferrable\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">deferrable</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.deferrable\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>设置该参数，可创建一个可推迟的唯一约束。接受的值是 <code class=\"docutils literal notranslate\">Deferrable.DEFERRED</code> 或 <code class=\"docutils literal notranslate\">Deferrable.IMMEDIATE</code>。例如：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span> <span class=\"nn\">django.db.models</span> <span class=\"kn\">import</span> Deferrable<span class=\"p\">,</span> UniqueConstraint\n\nUniqueConstraint<span class=\"p\">(</span>\n    name<span class=\"o\">=</span><span class=\"s2\">&quot;unique_order&quot;</span><span class=\"p\">,</span>\n    fields<span class=\"o\">=</span><span class=\"p\">[</span><span class=\"s2\">&quot;order&quot;</span><span class=\"p\">],</span>\n    deferrable<span class=\"o\">=</span>Deferrable<span class=\"o\">.</span>DEFERRED<span class=\"p\">,</span>\n<span class=\"p\">)</span>\n</code></pre></div>\n<p>默认情况下，约束条件是不推迟的。推迟的约束条件在事务结束前不会被强制执行。即时约束将在每条命令后立即执行。</p>\n<aside class=\"admonition-mysql-mariadb-and-sqlite admonition\" role=\"note\">\n<p class=\"admonition-title\">MySQL，MariaDB 和 SQLite。</p>\n<p>在 MySQL、MariaDB 和 SQLite 上，可推迟的唯一约束被忽略，因为它们都不支持。</p>\n</aside>\n<aside class=\"admonition admonition-warning\" role=\"note\">\n<p class=\"admonition-title\">Warning</p>\n<p>推迟的唯一约束可能导致 <a class=\"reference external\" href=\"https://www.postgresql.org/docs/current/sql-createtable.html#id-1.9.3.85.9.4\">性能惩罚</a> 。</p>\n</aside>\n</section>\n<section id=\"include\">\n<h3><code class=\"docutils literal notranslate\">include</code><a class=\"heading-anchor\" href=\"#include\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.include\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">include</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.include\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>一个包含在覆盖的唯一索引中的字段名称的列表或元组，作为非键列。这允许只用索引扫描，用于只选择包含的字段（ <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint.include\" title=\"django.db.models.UniqueConstraint.include\"><code class=\"xref py py-attr docutils literal notranslate\">include</code></a> ）和只过滤唯一字段（ <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint.fields\" title=\"django.db.models.UniqueConstraint.fields\"><code class=\"xref py py-attr docutils literal notranslate\">fields</code></a> ）的查询。</p>\n<p>例子：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>UniqueConstraint<span class=\"p\">(</span>name<span class=\"o\">=</span><span class=\"s2\">&quot;unique_booking&quot;</span><span class=\"p\">,</span> fields<span class=\"o\">=</span><span class=\"p\">[</span><span class=\"s2\">&quot;room&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;date&quot;</span><span class=\"p\">],</span> include<span class=\"o\">=</span><span class=\"p\">[</span><span class=\"s2\">&quot;full_name&quot;</span><span class=\"p\">])</span>\n</code></pre></div>\n<p>将允许对 <code class=\"docutils literal notranslate\">room</code> 和 <code class=\"docutils literal notranslate\">date</code> 进行过滤，也可以选择 <code class=\"docutils literal notranslate\">full_name</code>，同时只从索引中获取数据。</p>\n<p>非主键列的唯一约束在除了 PostgreSQL 之外的数据库中被忽略。</p>\n<p>非关键列具有与 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/indexes/#django.db.models.Index.include\" title=\"django.db.models.Index.include\"><code class=\"xref py py-attr docutils literal notranslate\">Index.include</code></a> 相同的数据库限制。</p>\n</section>\n<section id=\"opclasses\">\n<h3><code class=\"docutils literal notranslate\">opclasses</code><a class=\"heading-anchor\" href=\"#opclasses\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.opclasses\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">opclasses</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.opclasses\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>用于此唯一索引的 <a class=\"reference external\" href=\"https://www.postgresql.org/docs/current/indexes-opclass.html\">PostgreSQL 操作符类别</a> 的名称。如果需要自定义操作符类别，必须为索引中的每个字段提供一个。</p>\n<p>例子：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>UniqueConstraint<span class=\"p\">(</span>\n    name<span class=\"o\">=</span><span class=\"s2\">&quot;unique_username&quot;</span><span class=\"p\">,</span> fields<span class=\"o\">=</span><span class=\"p\">[</span><span class=\"s2\">&quot;username&quot;</span><span class=\"p\">],</span> opclasses<span class=\"o\">=</span><span class=\"p\">[</span><span class=\"s2\">&quot;varchar_pattern_ops&quot;</span><span class=\"p\">]</span>\n<span class=\"p\">)</span>\n</code></pre></div>\n<p>使用 <code class=\"docutils literal notranslate\">varchar_pattern_ops</code> 在 <code class=\"docutils literal notranslate\">username</code> 上创建了一个唯一索引。</p>\n<p><code class=\"docutils literal notranslate\">opclasses</code> 对于 PostgreSQL 以外的数据库来说是被忽略的。</p>\n</section>\n<section id=\"nulls-distinct\">\n<h3><code class=\"docutils literal notranslate\">nulls_distinct</code><a class=\"heading-anchor\" href=\"#nulls-distinct\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<aside class=\"version-note version-added\" data-version=\"5.0\" role=\"note\">\n<p class=\"version-note-title\">New in Django 5.0</p></aside>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.nulls_distinct\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">nulls_distinct</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.nulls_distinct\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>是否应该将包含 <code class=\"docutils literal notranslate\">NULL</code> 值的行视为彼此不同，而不是唯一约束覆盖它们。默认值是 <code class=\"docutils literal notranslate\">None</code>，它使用数据库默认值，在大多数后端上为 <code class=\"docutils literal notranslate\">True</code>。</p>\n<p>例子：</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>UniqueConstraint<span class=\"p\">(</span>name<span class=\"o\">=</span><span class=\"s2\">&quot;ordering&quot;</span><span class=\"p\">,</span> fields<span class=\"o\">=</span><span class=\"p\">[</span><span class=\"s2\">&quot;ordering&quot;</span><span class=\"p\">],</span> nulls_distinct<span class=\"o\">=</span><span class=\"kc\">False</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>创建一个唯一约束，只允许一行在 <code class=\"docutils literal notranslate\">ordering</code> 列中存储一个 <code class=\"docutils literal notranslate\">NULL</code> 值。</p>\n<p>非主键列的唯一约束在除了 PostgreSQL 15+ 之外的数据库中被忽略。</p>\n</section>\n<section id=\"id1\">\n<h3><code class=\"docutils literal notranslate\">violation_error_code</code><a class=\"heading-anchor\" href=\"#id1\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<aside class=\"version-note version-added\" data-version=\"5.0\" role=\"note\">\n<p class=\"version-note-title\">New in Django 5.0</p></aside>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.violation_error_code\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">violation_error_code</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.violation_error_code\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>在 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/instances/#validating-objects\"><span class=\"std std-ref\">模型验证</span></a> 过程中引发 <code class=\"docutils literal notranslate\">ValidationError</code> 时使用的错误代码。默认值为 <code class=\"docutils literal notranslate\">None</code>。</p>\n<p>对于没有 <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint.condition\" title=\"django.db.models.UniqueConstraint.condition\"><code class=\"xref py py-attr docutils literal notranslate\">condition</code></a> 且具有 <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint.fields\" title=\"django.db.models.UniqueConstraint.fields\"><code class=\"xref py py-attr docutils literal notranslate\">fields</code></a> 的 <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint\" title=\"django.db.models.UniqueConstraint\"><code class=\"xref py py-class docutils literal notranslate\">UniqueConstraint</code></a>，此代码 <em>不会被使用</em>。这样的 <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint\" title=\"django.db.models.UniqueConstraint\"><code class=\"xref py py-class docutils literal notranslate\">UniqueConstraint</code></a> 具有与通过 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/fields/#django.db.models.Field.unique\" title=\"django.db.models.Field.unique\"><code class=\"xref py py-attr docutils literal notranslate\">Field.unique</code></a> 定义的或者在 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/options/#django.db.models.Options.constraints\" title=\"django.db.models.Options.constraints\"><code class=\"xref py py-attr docutils literal notranslate\">Meta.unique_together</code></a> 中定义的约束相同的错误代码。</p>\n</section>\n<section id=\"id2\">\n<h3><code class=\"docutils literal notranslate\">violation_error_message</code><a class=\"heading-anchor\" href=\"#id2\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.db.models.UniqueConstraint.violation_error_message\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">violation_error_message</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.violation_error_message\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>在 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/instances/#validating-objects\"><span class=\"std std-ref\">模型验证</span></a> 期间引发 <code class=\"docutils literal notranslate\">ValidationError</code> 时使用的错误消息。默认为 <a class=\"reference internal\" href=\"#django.db.models.BaseConstraint.violation_error_message\" title=\"django.db.models.BaseConstraint.violation_error_message\"><code class=\"xref py py-attr docutils literal notranslate\">BaseConstraint.violation_error_message</code></a>。</p>\n<p>这个消息 <em>不会</em> 用于没有 <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint.condition\" title=\"django.db.models.UniqueConstraint.condition\"><code class=\"xref py py-attr docutils literal notranslate\">condition</code></a> 且带有 <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint.fields\" title=\"django.db.models.UniqueConstraint.fields\"><code class=\"xref py py-attr docutils literal notranslate\">fields</code></a> 的 <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint\" title=\"django.db.models.UniqueConstraint\"><code class=\"xref py py-class docutils literal notranslate\">UniqueConstraint</code></a>。这样的 <a class=\"reference internal\" href=\"#django.db.models.UniqueConstraint\" title=\"django.db.models.UniqueConstraint\"><code class=\"xref py py-class docutils literal notranslate\">UniqueConstraint</code></a> 显示与使用 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/fields/#django.db.models.Field.unique\" title=\"django.db.models.Field.unique\"><code class=\"xref py py-attr docutils literal notranslate\">Field.unique</code></a> 或 <a class=\"reference internal\" href=\"/zh-hans/5.0/ref/models/options/#django.db.models.Options.constraints\" title=\"django.db.models.Options.constraints\"><code class=\"xref py py-attr docutils literal notranslate\">Meta.unique_together</code></a> 定义的约束相同的消息。</p>\n</section>\n</section>","rootId":"module-django.db.models.constraints","toc":[{"title":"BaseConstraint","anchor":"baseconstraint","children":[{"title":"name","anchor":"name","children":[]},{"title":"violation_error_code","anchor":"violation-error-code","children":[]},{"title":"violation_error_message","anchor":"violation-error-message","children":[]},{"title":"validate()","anchor":"validate","children":[]}]},{"title":"CheckConstraint","anchor":"checkconstraint","children":[{"title":"check","anchor":"check","children":[]}]},{"title":"UniqueConstraint","anchor":"uniqueconstraint","children":[{"title":"expressions","anchor":"expressions","children":[]},{"title":"fields","anchor":"fields","children":[]},{"title":"condition","anchor":"condition","children":[]},{"title":"deferrable","anchor":"deferrable","children":[]},{"title":"include","anchor":"include","children":[]},{"title":"opclasses","anchor":"opclasses","children":[]},{"title":"nulls_distinct","anchor":"nulls-distinct","children":[]},{"title":"violation_error_code","anchor":"id1","children":[]},{"title":"violation_error_message","anchor":"id2","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/5.0/ref/"},{"docname":"ref/models/index","title":"模型","url":"/zh-hans/5.0/ref/models/"}],"prev":{"docname":"ref/models/indexes","title":"模型索引参考","url":"/zh-hans/5.0/ref/models/indexes/"},"next":{"docname":"ref/models/meta","title":"模型 _meta API","url":"/zh-hans/5.0/ref/models/meta/"},"formats":{"html":"/zh-hans/5.0/ref/models/constraints/","markdown":"/zh-hans/5.0/ref/models/constraints.md","json":"/zh-hans/5.0/ref/models/constraints.json"},"source":"https://github.com/django/django/blob/stable/5.0.x/docs/ref/models/constraints.txt","official":"https://docs.djangoproject.com/zh-hans/5.0/ref/models/constraints/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}