PostgreSQL stöder ytterligare dataintegritetsbegränsningar tillgängliga från modulen django.contrib.postgres.constraints. De läggs till i modellen Meta.constraints alternativ.
UteslutningsbegränsningLink to this heading#Skapar en uteslutningsbegränsning i databasen. Internt implementerar PostgreSQL uteslutningsbegränsningar med hjälp av index. Standardindextypen är GiST. För att använda dem måste du aktivera btree_gist-tillägget på PostgreSQL. Du kan installera den med hjälp av BtreeGistExtension migreringsoperation.
Om du försöker infoga en ny rad som står i konflikt med en befintlig rad, uppstår ett IntegrityError. På samma sätt när en uppdatering står i konflikt med en befintlig rad.
Begränsningar för uteslutning kontrolleras under modellvalidering.
\nnamnLink to this heading#uttryckLink to this heading#En iterabel med 2-tuples. Det första elementet är ett uttryck eller en sträng. Det andra elementet är en SQL-operator som representeras som en sträng. För att undvika skrivfel kan du använda RangeOperators som mappar operatörerna med strängar. Till exempel:
expressions = [\n ("timespan", RangeOperators.ADJACENT_TO),\n (F("room"), RangeOperators.EQUAL),\n]\nUttrycket OpClass() kan användas för att ange en anpassad operatorklass för begränsningsuttrycken. Till exempel:
expressions = [\n (OpClass("circle", name="circle_ops"), RangeOperators.OVERLAPS),\n]\nskapar en uteslutningsbegränsning på circle med hjälp av circle_ops.
index_typLink to this heading#The index type of the constraint. Accepted values are GiST, Hash, or\nSPGiST. Matching is case insensitive. If not provided, the default index\ntype is GIST.
villkorLink to this heading#Ett Q-objekt som anger villkoret för att begränsa en begränsning till en delmängd av rader. Till exempel:, condition=Q(cancelled=False).
Dessa villkor har samma databasrestriktioner som django.db.models.Index.condition.
deferrableLink to this heading#Ange denna parameter för att skapa en uppskjutbar uteslutningsbegränsning. Accepterade värden är Deferrable.DEFERRED eller Deferrable.IMMEDIATE. Till exempel:
from django.contrib.postgres.constraints import ExclusionConstraint\nfrom django.contrib.postgres.fields import RangeOperators\nfrom django.db.models import Deferrable\n\nExclusionConstraint(\n name="exclude_overlapping_deferred",\n expressions=[\n ("timespan", RangeOperators.OVERLAPS),\n ],\n deferrable=Deferrable.DEFERRED,\n)\nSom standard är begränsningar inte uppskjutna. En uppskjuten begränsning kommer inte att verkställas förrän i slutet av transaktionen. En omedelbar begränsning kommer att verkställas omedelbart efter varje kommando.
\n\ninkluderaLink to this heading#En lista eller tupel med namnen på de fält som ska ingå i det täckande uteslutningsvillkoret som icke-nyckelkolumner. Detta gör det möjligt att använda skanningar med enbart index för frågor som endast väljer inkluderade fält (include) och endast filtrerar efter indexerade fält (expressions).
include is supported for GiST and SP-GiST indexes.
Felkod för överträdelseLink to this heading#Den felkod som används när ValidationError uppstår under modellvalidering. Standardvärdet är None.
avvikelse_felmeddelandeLink to this heading#Det felmeddelande som används när ValidationError uppstår under modellvalidering. Standardvärdet är BaseConstraint.violation_error_message.
Följande exempel begränsar överlappande bokningar i samma rum, utan att ta hänsyn till avbokade bokningar:
\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\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 ]\nOm din modell definierar ett intervall med två fält, istället för de ursprungliga PostgreSQL-intervalltyperna, bör du skriva ett uttryck som använder motsvarande funktion (t.ex. `` TsTzRange() ) och använda avgränsarna för fältet. Oftast kommer avgränsarna att vara ``'[)', vilket innebär att den nedre gränsen är inkluderande och den övre gränsen är exkluderande. Du kan använda RangeBoundary som tillhandahåller en uttrycksmappning för intervallgränserna. Till exempel:
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 (\n TsTzRange("start", "end", RangeBoundary()),\n RangeOperators.OVERLAPS,\n ),\n ("room", RangeOperators.EQUAL),\n ],\n condition=Q(cancelled=False),\n ),\n ]\n