--- title: "Referens för begränsningar" version: 6.0 locale: sv source: https://docs.djangoproject.com/sv/6.0/ref/models/constraints/ canonical: https://djangodocs.dev/sv/6.0/ref/models/constraints/ --- # Referens för begränsningar Klasserna som definieras i den här modulen skapar databasbegränsningar. De läggs till i modellens [`Meta.constraints`](/sv/6.0/ref/models/options/#django.db.models.Options.constraints) alternativ. > **Hänvisning till inbyggda begränsningar** > > Begränsningar definieras i `django.db.models.constraints`, men för enkelhetens skull importeras de till [`django.db.models`](/sv/6.0/topics/db/models/#module-django.db.models). Standardkonventionen är att använda `from django.db import models` och hänvisa till begränsningarna som `models.Constraint`. > **Begränsningar i abstrakta basklasser** > > Du måste alltid ange ett unikt namn för begränsningen. Därför kan du normalt inte ange en begränsning för en abstrakt basklass, eftersom alternativet [`Meta.constraints`](/sv/6.0/ref/models/options/#django.db.models.Options.constraints) ärvs av underklasser, med exakt samma värden för attributen (inklusive `name`) varje gång. För att undvika namnskollisioner kan en del av namnet innehålla `’%(app_label)s’` och `’%(class)s’`, som ersätts med respektive app-etikett och klassnamn i gemener för den konkreta modellen. Till exempel: > > ``` > CheckConstraint(condition=Q(age__gte=18), name="%(app_label)s_%(class)s_is_adult") > ``` > **Validering av begränsningar** > > Begränsningar kontrolleras under [modellvalidering](/sv/6.0/ref/models/instances/#validating-objects). ## `BaseConstraint` #### `class BaseConstraint(*name, violation_error_code=None, violation_error_message=None)` Basklass för alla begränsningar. Underklasser måste implementera metoderna `constraint_sql()`, `create_sql()`, `remove_sql()` och `validate()`. Alla begränsningar har följande parametrar gemensamt: ### `namn` #### `BaseConstraint.name` Namnet på begränsningen. Du måste alltid ange ett unikt namn för begränsningen. ### `Felkod för överträdelse` #### `BaseConstraint.violation_error_code` Den felkod som används när `ValidationError` uppstår under [modellvalidering](/sv/6.0/ref/models/instances/#validating-objects). Standardvärdet är `None`. ### `avvikelse_felmeddelande` #### `BaseConstraint.violation_error_message` Det felmeddelande som används när `ValidationError` uppstår under [modellvalidering](/sv/6.0/ref/models/instances/#validating-objects). Standard är `"Begränsningen "%(name)s" har brutits."`. ### `validate()` #### `BaseConstraint.validate(model, instance, exclude=None, using=DEFAULT_DB_ALIAS)` Validerar att begränsningen, som definierats i `model`, respekteras i `instance`. Detta innebär att en databasfråga görs för att säkerställa att begränsningen respekteras. Om fält i listan `exclude` behövs för att validera begränsningen ignoreras begränsningen. Ger upphov till ett `ValidationError` om begränsningen inte uppfylls. Denna metod måste implementeras av en subklass. ## `CheckConstraint` #### `class CheckConstraint(* (Keyword-only parameters separator (PEP 3102)), condition, name, violation_error_code=None, violation_error_message=None)` Skapar en kontrollbegränsning i databasen. ### `villkor` #### `CheckConstraint.condition` Ett [`Q`](/sv/6.0/ref/models/querysets/#django.db.models.Q)-objekt eller boolean [`Expression`](/sv/6.0/ref/models/expressions/#django.db.models.Expression) som anger den villkorliga kontroll som du vill att begränsningen ska genomdriva. Till exempel: ``` CheckConstraint(condition=Q(age__gte=18), name="age_gte_18") ``` säkerställer att åldersfältet aldrig är mindre än 18. > **Uttrycksordning** > > ordningen på `Q`-argument bevaras inte nödvändigtvis, men ordningen på själva `Q`-uttrycken bevaras. Detta kan vara viktigt för databaser som av prestandaskäl bevarar ordningsföljden på uttryck för kontrollbegränsningar. Använd t.ex. följande format om ordningen är viktig: > > ``` > CheckConstraint( > condition=Q(age__gte=18) & Q(expensive_check=condition), > name="age_gte_18_and_others", > ) > ``` > **Oracle < 23c** > > Kontroller med nollställbara fält på Oracle \< 23c måste innehålla ett villkor som tillåter `NULL`-värden för att [`validate()`](#django.db.models.BaseConstraint.validate) ska fungera på samma sätt som validering av kontrollbegränsningar. Till exempel:, om `age` är ett nollställbart fält: > > ``` > CheckConstraint(condition=Q(age__gte=18) | Q(age__isnull=True), name="age_gte_18") > ``` ## `Unik begränsning` #### `class UniqueConstraint(*expressions, fields=(), name=None, condition=None, deferrable=None, include=None, opclasses=(), nulls_distinct=None, violation_error_code=None, violation_error_message=None)` Creates a uniqueness guarantee in the database, enforced by either a unique constraint or a unique index depending on the options used. > **Constraint vs. index implementation** > > Setting only [`UniqueConstraint.fields`](#django.db.models.UniqueConstraint.fields) creates a true database > constraint (`ADD CONSTRAINT ... UNIQUE`). Specifying any of > [`UniqueConstraint.expressions`](#django.db.models.UniqueConstraint.expressions), [`UniqueConstraint.opclasses`](#django.db.models.UniqueConstraint.opclasses), > [`UniqueConstraint.condition`](#django.db.models.UniqueConstraint.condition), or [`UniqueConstraint.include`](#django.db.models.UniqueConstraint.include) > creates a unique index (`CREATE UNIQUE INDEX`) instead. > > In this documentation, the term ”unique constraint” is used for both > cases to mean a uniqueness guarantee enforced by the database. ### `uttryck` #### `UniqueConstraint.expressions` Det positionella argumentet `*expressions` gör det möjligt att skapa funktionella unika begränsningar för uttryck och databasfunktioner. Till exempel: ``` UniqueConstraint(Lower("name").desc(), "category", name="unique_lower_name_category") ``` skapar en unik begränsning på det gemena värdet i fältet `name` i fallande ordning och fältet `category` i stigande ordning som standard. Funktionella unika begränsningar har samma databasrestriktioner som [`Index.expressions`](/sv/6.0/ref/models/indexes/#django.db.models.Index.expressions). ### `fält` #### `UniqueConstraint.fields` En lista med fältnamn som anger den unika uppsättning kolumner som du vill att begränsningen ska genomdriva. Till exempel: ``` UniqueConstraint(fields=["room", "date"], name="unique_booking") ``` säkerställer att varje rum endast kan bokas en gång per datum. ### `villkor` #### `UniqueConstraint.condition` Ett [`Q`](/sv/6.0/ref/models/querysets/#django.db.models.Q)-objekt som anger det villkor du vill att begränsningen ska genomdriva. Till exempel: ``` UniqueConstraint(fields=["user"], condition=Q(status="DRAFT"), name="unique_draft_user") ``` säkerställer att varje användare endast har ett utkast. Dessa villkor har samma databasrestriktioner som [`Index.condition`](/sv/6.0/ref/models/indexes/#django.db.models.Index.condition). ### `deferrable` #### `UniqueConstraint.deferrable` Ange denna parameter för att skapa en uppskjutbar unik begränsning. Accepterade värden är `Deferrable.DEFERRED` eller `Deferrable.IMMEDIATE`. Till exempel: ``` from django.db.models import Deferrable, UniqueConstraint UniqueConstraint( name="unique_order", fields=["order"], 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. Unique constraints with [`condition`](#django.db.models.UniqueConstraint.condition), [`include`](#django.db.models.UniqueConstraint.include), [`opclasses`](#django.db.models.UniqueConstraint.opclasses), or [`expressions`](#django.db.models.UniqueConstraint.expressions) may be implemented as unique indexes rather than unique constraints. In that case, `deferrable` cannot be set. > **MySQL, MariaDB och SQLite.** > > Deferrable unique constraints ignoreras i MySQL, MariaDB och SQLite eftersom de inte har stöd för dem. > **Warning** > > Uppskjutna unika begränsningar kan leda till en ”prestandaförlust” \<\>\`\_. ### `inkludera` #### `UniqueConstraint.include` En lista eller tupel med namnen på de fält som ska ingå i det täckande unika indexet som icke-nyckelkolumner. På så sätt kan skanningar med enbart index användas för frågor som endast väljer inkluderade fält ([`include`](#django.db.models.UniqueConstraint.include)) och endast filtrerar efter unika fält ([`fields`](#django.db.models.UniqueConstraint.fields)). Till exempel: ``` UniqueConstraint(name="unique_booking", fields=["room", "date"], include=["full_name"]) ``` tillåter filtrering på `rum` och `datum`, även val av `full_name`, samtidigt som data endast hämtas från indexet. Unika begränsningar med kolumner som inte är nycklar ignoreras för databaser förutom PostgreSQL. Icke-nyckelkolumner har samma databasrestriktioner som [`Index.include`](/sv/6.0/ref/models/indexes/#django.db.models.Index.include). ### `opklasser` #### `UniqueConstraint.opclasses` Namnen på [PostgreSQL-operatörsklasserna](https://www.postgresql.org/docs/current/indexes-opclass.html) som ska användas för detta unika index. Om du behöver en anpassad operatörsklass måste du tillhandahålla en för varje fält i indexet. Till exempel: ``` UniqueConstraint( name="unique_username", fields=["username"], opclasses=["varchar_pattern_ops"] ) ``` skapar ett unikt index på `username` med hjälp av `varchar_pattern_ops`. \`\` Opclasses\`\` ignoreras för databaser förutom PostgreSQL. ### `nulls_distinct` #### `UniqueConstraint.nulls_distinct` Om rader som innehåller `NULL`-värden som omfattas av det unika villkoret ska anses vara skilda från varandra. Standardvärdet är `None` som använder databasens standardvärde som är `True` på de flesta backends. Till exempel: ``` UniqueConstraint(name="ordering", fields=["ordering"], nulls_distinct=False) ``` skapar en unik begränsning som endast tillåter en rad att lagra ett `NULL`-värde i kolumnen `ordering`. Unika begränsningar med `nulls_distinct` ignoreras för databaser förutom PostgreSQL 15+. ### `Felkod för överträdelse` #### `UniqueConstraint.violation_error_code` Den felkod som används när ett `ValidationError` uppstår under [modellvalidering](/sv/6.0/ref/models/instances/#validating-objects). Standardvärdet är [`BaseConstraint.violation_error_code`](#django.db.models.BaseConstraint.violation_error_code), när antingen [`UniqueConstraint.condition`](#django.db.models.UniqueConstraint.condition) har angetts eller [`UniqueConstraint.fields`](#django.db.models.UniqueConstraint.fields) inte har angetts. Om [`UniqueConstraint.fields`](#django.db.models.UniqueConstraint.fields) anges utan [`UniqueConstraint.condition`](#django.db.models.UniqueConstraint.condition), används som standard felkoden [`Meta.unique_together`](/sv/6.0/ref/models/options/#django.db.models.Options.unique_together) när det finns flera fält, och felkoden [`Field.unique`](/sv/6.0/ref/models/fields/#django.db.models.Field.unique) när det finns ett enda fält. > **Changed in Django 5.2** > > I äldre versioner användes inte den medföljande [`UniqueConstraint.violation_error_code`](#django.db.models.UniqueConstraint.violation_error_code) när [`UniqueConstraint.fields`](#django.db.models.UniqueConstraint.fields) angavs utan [`UniqueConstraint.condition`](#django.db.models.UniqueConstraint.condition). ### `avvikelse_felmeddelande` #### `UniqueConstraint.violation_error_message` Det felmeddelande som används när ett `ValidationError` uppstår under [modellvalidering](/sv/6.0/ref/models/instances/#validating-objects). Standardvärdet är [`BaseConstraint.violation_error_message`](#django.db.models.BaseConstraint.violation_error_message), när antingen [`UniqueConstraint.condition`](#django.db.models.UniqueConstraint.condition) har angetts eller [`UniqueConstraint.fields`](#django.db.models.UniqueConstraint.fields) inte har angetts. Om [`UniqueConstraint.fields`](#django.db.models.UniqueConstraint.fields) anges utan [`UniqueConstraint.condition`](#django.db.models.UniqueConstraint.condition), används som standard felmeddelandet [`Meta.unique_together`](/sv/6.0/ref/models/options/#django.db.models.Options.unique_together) när det finns flera fält, och felmeddelandet [`Field.unique`](/sv/6.0/ref/models/fields/#django.db.models.Field.unique) när det finns ett enda fält. > **Changed in Django 5.2** > > I äldre versioner användes inte det medföljande [`UniqueConstraint.violation_error_message`](#django.db.models.UniqueConstraint.violation_error_message) när [`UniqueConstraint.fields`](#django.db.models.UniqueConstraint.fields) angavs utan [`UniqueConstraint.condition`](#django.db.models.UniqueConstraint.condition).