{"title":"Référence des contraintes","version":"2.2","locale":"fr","docname":"ref/models/constraints","url":"/fr/2.2/ref/models/constraints/","canonical":"https://djangodocs.dev/fr/2.2/ref/models/constraints/","summary":"Les classes définies dans ce module créent des contraintes de base de données. Elles sont ajoutées dans l’option Meta.constraints des modèles.","html":"<span id=\"constraints-reference\"></span><h1>Référence des contraintes<a class=\"heading-anchor\" href=\"#module-django.db.models.constraints\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<aside class=\"version-note version-added\" data-version=\"2.2\" role=\"note\">\n<p class=\"version-note-title\">New in Django 2.2</p></aside>\n<p>Les classes définies dans ce module créent des contraintes de base de données. Elles sont ajoutées dans l’option <a class=\"reference internal\" href=\"/fr/2.2/ref/models/options/#django.db.models.Options.constraints\" title=\"django.db.models.Options.constraints\"><code class=\"xref py py-attr docutils literal notranslate\">Meta.constraints</code></a> des modèles.</p>\n<aside class=\"admonition-referencing-built-in-constraints admonition\" role=\"note\">\n<p class=\"admonition-title\">Référencement des contraintes intégrées</p>\n<p>Les contraintes sont définies dans <code class=\"docutils literal notranslate\">django.db.models.constraints</code>, mais par commodité elles sont importées dans <a class=\"reference internal\" href=\"/fr/2.2/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>. La convention standard est d’utiliser <code class=\"docutils literal notranslate\">from django.db import models</code> et de se référer aux contraintes avec <code class=\"docutils literal notranslate\">models.&lt;Telle&gt;Constraint</code>.</p>\n</aside>\n<aside class=\"admonition-constraints-in-abstract-base-classes admonition\" role=\"note\">\n<p class=\"admonition-title\">Contraintes dans les classes de base abstraites</p>\n<p>Les contraintes doivent toujours être nommées de façon unique. Cela signifie qu’il n’est pas possible de définir des contraintes dans une classe de base abstraite, dans la mesure où l’option <a class=\"reference internal\" href=\"/fr/2.2/ref/models/options/#django.db.models.Options.constraints\" title=\"django.db.models.Options.constraints\"><code class=\"xref py py-attr docutils literal notranslate\">Meta.constraints</code></a> est héritée par les sous-classes avec exactement les mêmes valeurs d’attributs (y compris <code class=\"docutils literal notranslate\">name</code>). Il faut dès lors définir l’option <code class=\"docutils literal notranslate\">constraints</code> directement sur les sous-classes, ce qui permet d’indiquer un nom unique pour chaque contrainte.</p>\n</aside>\n<aside class=\"admonition-validation-of-constraints admonition\" role=\"note\">\n<p class=\"admonition-title\">Validation des contraintes</p>\n<p>En général, les contraintes ne sont <strong>pas</strong> vérifiées lors de <code class=\"docutils literal notranslate\">full_clean()</code> et ne produisent donc pas d’erreurs <code class=\"docutils literal notranslate\">ValidationError</code>. Par contre, vous obtiendrez une erreur d’intégrité de base de données lors de l’enregistrement <code class=\"docutils literal notranslate\">save()</code>. Les contraintes <code class=\"docutils literal notranslate\">UniqueConstraint</code> sans <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> (c’est-à-dire les contraintes d’unicité non partielles) sont différentes à cet égard dans le sens où elles font appel à la logique existante <code class=\"docutils literal notranslate\">validate_unique()</code> et recourent donc à la validation en deux étapes. En plus de l’erreur <code class=\"docutils literal notranslate\">IntegrityError</code> au moment du <code class=\"docutils literal notranslate\">save()</code>, des erreurs <code class=\"docutils literal notranslate\">ValidationError</code> sont aussi produites lors de la validation du modèle si la contrainte <code class=\"docutils literal notranslate\">UniqueConstraint</code> n’est pas respectée.</p>\n</aside>\n<section id=\"checkconstraint\">\n<h2><code class=\"docutils literal notranslate\">CheckConstraint</code><a class=\"heading-anchor\" href=\"#checkconstraint\"><span class=\"visually-hidden\">Lien vers cette rubrique</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><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.db.models.CheckConstraint\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Crée une contrainte de vérification dans la base de données.</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\">Lien vers cette rubrique</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\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Un objet <a class=\"reference internal\" href=\"/fr/2.2/ref/models/querysets/#django.db.models.Q\" title=\"django.db.models.Q\"><code class=\"xref py py-class docutils literal notranslate\">Q</code></a> qui indique le contrôle que la contrainte souhaitée doit appliquer.</p>\n<p>Par exemple, <code class=\"docutils literal notranslate\">CheckConstraint(check=Q(age__gte=18), name='age_gte_18')</code> s’assure que le champ age n’est jamais au-dessous de 18.</p>\n</section>\n<section id=\"name\">\n<h3><code class=\"docutils literal notranslate\">name</code><a class=\"heading-anchor\" href=\"#name\"><span class=\"visually-hidden\">Lien vers cette rubrique</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.name\">\n<span class=\"sig-prename descclassname\">CheckConstraint.</span><span class=\"sig-name descname\">name</span><a class=\"heading-anchor\" href=\"#django.db.models.CheckConstraint.name\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Le nom de la contrainte.</p>\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\">Lien vers cette rubrique</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=\"keyword-only-separator o\"><abbr title=\"Keyword-only parameters separator (PEP 3102)\">*</abbr></span></em>, <em class=\"sig-param\">fields</em>, <em class=\"sig-param\">name</em>, <em class=\"sig-param\">condition<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\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Crée une contrainte d’unicité dans la base de données.</p>\n</dd></dl>\n\n<section id=\"fields\">\n<h3><code class=\"docutils literal notranslate\">fields</code><a class=\"heading-anchor\" href=\"#fields\"><span class=\"visually-hidden\">Lien vers cette rubrique</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\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Une liste de noms de champs qui précise l’ensemble unique de colonnes pour lesquelles la contrainte va assurer l’unicité.</p>\n<p>Par exemple, <code class=\"docutils literal notranslate\">UniqueConstraint(fields=['chambre', 'date'], name='reservation_unique')</code> s’assure que chaque chambre ne peut être réservée qu’une seule fois par date.</p>\n</section>\n<section id=\"id1\">\n<h3><code class=\"docutils literal notranslate\">name</code><a class=\"heading-anchor\" href=\"#id1\"><span class=\"visually-hidden\">Lien vers cette rubrique</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.name\">\n<span class=\"sig-prename descclassname\">UniqueConstraint.</span><span class=\"sig-name descname\">name</span><a class=\"heading-anchor\" href=\"#django.db.models.UniqueConstraint.name\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Le nom de la contrainte.</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\">Lien vers cette rubrique</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\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Un objet <a class=\"reference internal\" href=\"/fr/2.2/ref/models/querysets/#django.db.models.Q\" title=\"django.db.models.Q\"><code class=\"xref py py-class docutils literal notranslate\">Q</code></a> qui indique la condition que la contrainte souhaitée doit appliquer.</p>\n<p>Par exemple :</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=\"s1\">&#39;user&#39;</span><span class=\"p\">],</span> condition<span class=\"o\">=</span>Q<span class=\"p\">(</span>status<span class=\"o\">=</span><span class=\"s1\">&#39;DRAFT&#39;</span><span class=\"p\">),</span> name<span class=\"o\">=</span><span class=\"s1\">&#39;unique_draft_user&#39;</span><span class=\"p\">)</span>\n</code></pre></div>\n<p>s’assure que chaque utilisateur dispose d’un seul brouillon.</p>\n<p>Ces conditions sont soumises aux même restrictions de base de données que <a class=\"reference internal\" href=\"/fr/2.2/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>","rootId":"module-django.db.models.constraints","toc":[{"title":"CheckConstraint","anchor":"checkconstraint","children":[{"title":"check","anchor":"check","children":[]},{"title":"name","anchor":"name","children":[]}]},{"title":"UniqueConstraint","anchor":"uniqueconstraint","children":[{"title":"fields","anchor":"fields","children":[]},{"title":"name","anchor":"id1","children":[]},{"title":"condition","anchor":"condition","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/2.2/ref/"},{"docname":"ref/models/index","title":"Modèles","url":"/fr/2.2/ref/models/"}],"prev":{"docname":"ref/models/indexes","title":"Référence des index de modèle","url":"/fr/2.2/ref/models/indexes/"},"next":{"docname":"ref/models/meta","title":"L’API _meta des modèles","url":"/fr/2.2/ref/models/meta/"},"formats":{"html":"/fr/2.2/ref/models/constraints/","markdown":"/fr/2.2/ref/models/constraints.md","json":"/fr/2.2/ref/models/constraints.json"},"source":"https://github.com/django/django/blob/stable/2.2.x/docs/ref/models/constraints.txt","official":"https://docs.djangoproject.com/fr/2.2/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","pt-br","ko","es","el","pl"]}