PostgreSQL offre des contraintes d’intégrité de données supplémentaires dans le module django.contrib.postgres.constraints. Elles sont ajoutées dans l’option Meta.constraints des modèles.
ExclusionConstraintLien vers cette rubrique#Crée une contrainte d’exclusion dans la base de données. En interne, PostgreSQL implémente les contraintes d’exclusion par des index. Le type d’index par défaut est GiST. Pour les utiliser, vous devez activer l’extension btree_gist dans PostgreSQL. Vous pouvez installer l’extension par une opération de migration BtreeGistExtension.
Si vous essayez d’insérer une nouvelle ligne qui entre en conflit avec une ligne existante, une erreur IntegrityError se produit. De même lorsqu’un conflit survient lors d’une mise à jour.
nameLien vers cette rubrique#Le nom de la contrainte.
\nexpressionsLien vers cette rubrique#Un itérable de tuples binaires. Le premier élément est une expression ou une chaîne. Le second élément est un opérateur SQL sous forme de chaîne. Pour éviter les erreurs syntaxiques, vous pouvez utiliser RangeOperators qui fait correspondre les opérateurs à des chaînes. Par exemple
expressions=[\n ('timespan', RangeOperators.ADJACENT_TO),\n (F('room'), RangeOperators.EQUAL),\n]\nindex_typeLien vers cette rubrique#Le type d’index de la contrainte. La valeurs admises sont GIST ou SPGIST. Les correspondances ne tiennent pas compte de la casse. En cas d’absence, le type d’index par défaut est GIST.
conditionLien vers cette rubrique#Un objet Q qui indique la condition de restriction d’une contrainte à un sous-ensemble de lignes. Par exemple, condition=Q(annule=False).
Ces conditions sont soumises aux mêmes restrictions de base de données que django.db.models.Index.condition.
L’exemple suivant évite les chevauchements de réservations d’une même salle, sans tenir compte des réservations annulées
\nfrom django.contrib.postgres.constraints import ExclusionConstraint\nfrom django.contrib.postgres.fields import DateTimeRangeField, RangeOperators\nfrom django.db import models\nfrom django.db.models import Q\n\nclass Room(models.Model):\n number = models.IntegerField()\n\n\nclass Reservation(models.Model):\n room = models.ForeignKey('Room', on_delete=models.CASCADE)\n timespan = DateTimeRangeField()\n cancelled = models.BooleanField(default=False)\n\n class Meta:\n constraints = [\n ExclusionConstraint(\n name='exclude_overlapping_reservations',\n expressions=[\n ('timespan', RangeOperators.OVERLAPS),\n ('room', RangeOperators.EQUAL),\n ],\n condition=Q(cancelled=False),\n ),\n ]\nDans le cas où un modèle définit un intervalle avec deux champs, au lieu des types d’intervalle natifs de PostgreSQL, vous devriez écrire une expression qui utilise la fonction équivalente (par ex. TsTzRange()), et utiliser les délimiteurs du champ. La plupart du temps, les délimiteurs seront '[)', ce qui signifie que la limite inférieure est inclusive et la limite supérieure exclusive. Vous pouvez utiliser RangeBoundary qui fournit des correspondances d’expression pour les limites d’intervalle. Par exemple
from django.contrib.postgres.constraints import ExclusionConstraint\nfrom django.contrib.postgres.fields import (\n DateTimeRangeField,\n RangeBoundary,\n RangeOperators,\n)\nfrom django.db import models\nfrom django.db.models import Func, Q\n\n\nclass TsTzRange(Func):\n function = 'TSTZRANGE'\n output_field = DateTimeRangeField()\n\n\nclass Reservation(models.Model):\n room = models.ForeignKey('Room', on_delete=models.CASCADE)\n start = models.DateTimeField()\n end = models.DateTimeField()\n cancelled = models.BooleanField(default=False)\n\n class Meta:\n constraints = [\n ExclusionConstraint(\n name='exclude_overlapping_reservations',\n expressions=(\n (TsTzRange('start', 'end', RangeBoundary()), RangeOperators.OVERLAPS),\n ('room', RangeOperators.EQUAL),\n ),\n condition=Q(cancelled=False),\n ),\n ]\n