{"title":"Référence des contraintes","version":"3.1","locale":"fr","docname":"ref/models/constraints","url":"/fr/3.1/ref/models/constraints/","canonical":"https://djangodocs.dev/fr/3.1/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. Référencement des…","html":"

Référence des contraintesLien vers cette rubrique#

\n

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.

\n\n\n\n
\n

CheckConstraintLien vers cette rubrique#

\n
\n
\nclass CheckConstraint(*, check, name)Lien vers cette définition#
\n

Crée une contrainte de vérification dans la base de données.

\n
\n\n
\n

checkLien vers cette rubrique#

\n
\n
\nCheckConstraint.checkLien vers cette définition#
\n
\n\n

Un objet Q ou une Expression booléenne qui indique le contrôle que la contrainte souhaitée doit appliquer.

\n

Par exemple, CheckConstraint(check=Q(age__gte=18), name='age_gte_18') s’assure que le champ age n’est jamais au-dessous de 18.

\n\n
\n
\n

nameLien vers cette rubrique#

\n
\n
\nCheckConstraint.nameLien vers cette définition#
\n
\n\n

Le nom de la contrainte. La contrainte doit toujours posséder un nom unique.

\n\n
\n
\n
\n

UniqueConstraintLien vers cette rubrique#

\n
\n
\nclass UniqueConstraint(*, fields, name, condition=None, deferrable=None)Lien vers cette définition#
\n

Crée une contrainte d’unicité dans la base de données.

\n
\n\n
\n

fieldsLien vers cette rubrique#

\n
\n
\nUniqueConstraint.fieldsLien vers cette définition#
\n
\n\n

Une liste de noms de champs qui précise l’ensemble unique de colonnes pour lesquelles la contrainte va assurer l’unicité.

\n

Par exemple, UniqueConstraint(fields=['chambre', 'date'], name='reservation_unique') s’assure que chaque chambre ne peut être réservée qu’une seule fois par date.

\n
\n
\n

nameLien vers cette rubrique#

\n
\n
\nUniqueConstraint.nameLien vers cette définition#
\n
\n\n

Le nom de la contrainte. La contrainte doit toujours posséder un nom unique.

\n\n
\n
\n

conditionLien vers cette rubrique#

\n
\n
\nUniqueConstraint.conditionLien vers cette définition#
\n
\n\n

Un objet Q qui indique la condition que la contrainte souhaitée doit appliquer.

\n

Par exemple :

\n
Code
UniqueConstraint(fields=['user'], condition=Q(status='DRAFT'), name='unique_draft_user')\n
\n

s’assure que chaque utilisateur dispose d’un seul brouillon.

\n

Ces conditions sont soumises aux même restrictions de base de données que Index.condition.

\n
\n
\n

deferrableLien vers cette rubrique#

\n
\n
\nUniqueConstraint.deferrableLien vers cette définition#
\n
\n\n\n

Définissez ce paramètre pour créer une contrainte d’unicité différable. Les valeurs acceptées sont Deferrable.DEFERRED ou Deferrable.IMMEDIATE. Par exemple

\n
Code
from django.db.models import Deferrable, UniqueConstraint\n\nUniqueConstraint(\n    name='unique_order',\n    fields=['order'],\n    deferrable=Deferrable.DEFERRED,\n)\n
\n

Par défaut, les contraintes ne sont pas différées. Une contrainte différée ne sera pas appliquée avant la fin de la transaction. Une contrainte immédiate sera appliquée immédiatement après chaque commande.

\n\n\n
\n
","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":[]},{"title":"deferrable","anchor":"deferrable","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/3.1/ref/"},{"docname":"ref/models/index","title":"Modèles","url":"/fr/3.1/ref/models/"}],"prev":{"docname":"ref/models/indexes","title":"Référence des index de modèle","url":"/fr/3.1/ref/models/indexes/"},"next":{"docname":"ref/models/meta","title":"L’API _meta des modèles","url":"/fr/3.1/ref/models/meta/"},"formats":{"html":"/fr/3.1/ref/models/constraints/","markdown":"/fr/3.1/ref/models/constraints.md","json":"/fr/3.1/ref/models/constraints.json"},"source":"https://github.com/django/django/blob/stable/3.1.x/docs/ref/models/constraints.txt","official":"https://docs.djangoproject.com/fr/3.1/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"]}