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#Indextypen för begränsningen. Accepterade värden är GIST eller SPGIST. Matchningen är okänslig för skiftlägesskillnader. Om det inte anges är standardindextypen 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 stöds för GiST-index. PostgreSQL 14+ stöder också include för SP-GiST-index.
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