--- title: "PostgreSQL-specifika databasbegränsningar" version: 6.1 locale: sv source: https://docs.djangoproject.com/sv/6.1/ref/contrib/postgres/constraints/ canonical: https://djangodocs.dev/sv/6.1/ref/contrib/postgres/constraints/ --- # PostgreSQL-specifika databasbegränsningar PostgreSQL stöder ytterligare dataintegritetsbegränsningar tillgängliga från modulen `django.contrib.postgres.constraints`. De läggs till i modellen [`Meta.constraints`](/sv/6.1/ref/models/options/#django.db.models.Options.constraints) alternativ. ## `Uteslutningsbegränsning` #### `class ExclusionConstraint(* (Keyword-only parameters separator (PEP 3102)), name, expressions, index_type=None, condition=None, deferrable=None, include=None, violation_error_code=None, violation_error_message=None)` Skapar en uteslutningsbegränsning i databasen. Internt implementerar PostgreSQL uteslutningsbegränsningar med hjälp av index. Standardindextypen är [GiST](https://www.postgresql.org/docs/current/gist.html). För att använda dem måste du aktivera [btree\_gist-tillägget](https://www.postgresql.org/docs/current/btree-gist.html) på PostgreSQL. Du kan installera den med hjälp av [`BtreeGistExtension`](/sv/6.1/ref/contrib/postgres/operations/#django.contrib.postgres.operations.BtreeGistExtension) migreringsoperation. Om du försöker infoga en ny rad som står i konflikt med en befintlig rad, uppstår ett [`IntegrityError`](/sv/6.1/ref/exceptions/#django.db.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](/sv/6.1/ref/models/instances/#validating-objects). ### `namn` #### `ExclusionConstraint.name` Se [`BaseConstraint.name`](/sv/6.1/ref/models/constraints/#django.db.models.BaseConstraint.name). ### `uttryck` #### `ExclusionConstraint.expressions` 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`](/sv/6.1/ref/contrib/postgres/fields/#django.contrib.postgres.fields.RangeOperators) som mappar operatörerna med strängar. Till exempel: ``` expressions = [ ("timespan", RangeOperators.ADJACENT_TO), (F("room"), RangeOperators.EQUAL), ] ``` > **Begränsningar för operatörer.** > > Endast kommutativa operatorer kan användas i uteslutningsbegränsningar. Uttrycket [`OpClass()`](/sv/6.1/ref/contrib/postgres/indexes/#django.contrib.postgres.indexes.OpClass) kan användas för att ange en anpassad [operatorklass](https://www.postgresql.org/docs/current/indexes-opclass.html) för begränsningsuttrycken. Till exempel: ``` expressions = [ (OpClass("circle", name="circle_ops"), RangeOperators.OVERLAPS), ] ``` skapar en uteslutningsbegränsning på `circle` med hjälp av `circle_ops`. ### `index_typ` #### `ExclusionConstraint.index_type` The index type of the constraint. Accepted values are `GiST`, `Hash`, or `SPGiST`. Matching is case insensitive. If not provided, the default index type is `GIST`. > **Changed in Django 6.1** > > Support for exclusion constraints using Hash indexes was added. ### `villkor` #### `ExclusionConstraint.condition` Ett [`Q`](/sv/6.1/ref/models/querysets/#django.db.models.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`](/sv/6.1/ref/models/indexes/#django.db.models.Index.condition). ### `deferrable` #### `ExclusionConstraint.deferrable` 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 from django.contrib.postgres.fields import RangeOperators from django.db.models import Deferrable ExclusionConstraint( name="exclude_overlapping_deferred", expressions=[ ("timespan", RangeOperators.OVERLAPS), ], deferrable=Deferrable.DEFERRED, ) ``` Som 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. > **Warning** > > Uppskjutna uteslutningsbegränsningar kan leda till en ”prestandaförlust” \<\>\`\_. ### `inkludera` #### `ExclusionConstraint.include` 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`](#django.contrib.postgres.constraints.ExclusionConstraint.include)) och endast filtrerar efter indexerade fält ([`expressions`](#django.contrib.postgres.constraints.ExclusionConstraint.expressions)). `include` is supported for GiST and SP-GiST indexes. ### `Felkod för överträdelse` #### `ExclusionConstraint.violation_error_code` Den felkod som används när `ValidationError` uppstår under [modellvalidering](/sv/6.1/ref/models/instances/#validating-objects). Standardvärdet är `None`. ### `avvikelse_felmeddelande` Det felmeddelande som används när `ValidationError` uppstår under [modellvalidering](/sv/6.1/ref/models/instances/#validating-objects). Standardvärdet är [`BaseConstraint.violation_error_message`](/sv/6.1/ref/models/constraints/#django.db.models.BaseConstraint.violation_error_message). ### Exempel Följande exempel begränsar överlappande bokningar i samma rum, utan att ta hänsyn till avbokade bokningar: ``` from django.contrib.postgres.constraints import ExclusionConstraint from django.contrib.postgres.fields import DateTimeRangeField, RangeOperators from django.db import models from django.db.models import Q class Room(models.Model): number = models.IntegerField() class Reservation(models.Model): room = models.ForeignKey("Room", on_delete=models.CASCADE) timespan = DateTimeRangeField() cancelled = models.BooleanField(default=False) class Meta: constraints = [ ExclusionConstraint( name="exclude_overlapping_reservations", expressions=[ ("timespan", RangeOperators.OVERLAPS), ("room", RangeOperators.EQUAL), ], condition=Q(cancelled=False), ), ] ``` Om 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`](/sv/6.1/ref/contrib/postgres/fields/#django.contrib.postgres.fields.RangeBoundary) som tillhandahåller en uttrycksmappning för [intervallgränserna](https://www.postgresql.org/docs/current/rangetypes.html#RANGETYPES-INCLUSIVITY). Till exempel: ``` from django.contrib.postgres.constraints import ExclusionConstraint from django.contrib.postgres.fields import ( DateTimeRangeField, RangeBoundary, RangeOperators, ) from django.db import models from django.db.models import Func, Q class TsTzRange(Func): function = "TSTZRANGE" output_field = DateTimeRangeField() class Reservation(models.Model): room = models.ForeignKey("Room", on_delete=models.CASCADE) start = models.DateTimeField() end = models.DateTimeField() cancelled = models.BooleanField(default=False) class Meta: constraints = [ ExclusionConstraint( name="exclude_overlapping_reservations", expressions=[ ( TsTzRange("start", "end", RangeBoundary()), RangeOperators.OVERLAPS, ), ("room", RangeOperators.EQUAL), ], condition=Q(cancelled=False), ), ] ```