I Django har varje modell en primärnyckel. Som standard består denna primärnyckel av ett enda fält.
\nI de flesta fall bör det räcka med en enda primärnyckel. Vid databasdesign är det dock ibland nödvändigt att definiera en primärnyckel som består av flera fält.
\nFör att använda en sammansatt primärnyckel måste du när du definierar en modell ange att attributet pk ska vara en CompositePrimaryKey:
class Product(models.Model):\n name = models.CharField(max_length=100)\n\n\nclass Order(models.Model):\n reference = models.CharField(max_length=20, primary_key=True)\n\n\nclass OrderLineItem(models.Model):\n pk = models.CompositePrimaryKey("product_id", "order_id")\n product = models.ForeignKey(Product, on_delete=models.CASCADE)\n order = models.ForeignKey(Order, on_delete=models.CASCADE)\n quantity = models.IntegerField()\nDetta kommer att instruera Django att skapa en sammansatt primärnyckel (PRIMARY KEY (product_id, order_id)) när tabellen skapas.
En sammansatt primärnyckel representeras av en tupel:
>>> product = Product.objects.create(name="apple")\n>>> order = Order.objects.create(reference="A755H")\n>>> item = OrderLineItem.objects.create(product=product, order=order, quantity=1)\n>>> item.pk\n(1, "A755H")\nDu kan tilldela en tuple till attributet pk. Detta ställer in de associerade fältvärdena:
>>> item = OrderLineItem(pk=(2, "B142C"))\n>>> item.pk\n(2, "B142C")\n>>> item.product_id\n2\n>>> item.order_id\n"B142C"\nEn sammansatt primärnyckel kan också filtreras med en tupel:
>>> OrderLineItem.objects.filter(pk=(1, "A755H")).count()\n1\nVi arbetar fortfarande med stöd för sammansatta primärnycklar för relationsfält, inklusive GenericForeignKey-fält, och Django-admin. Modeller med sammansatta primärnycklar kan för närvarande inte registreras i Django-admin. Du kan förvänta dig att se detta i framtida utgåvor.
Django stöder inte migrering till eller från en sammansatt primärnyckel efter att tabellen har skapats. Det finns inte heller stöd för att lägga till eller ta bort fält från den sammansatta primärnyckeln.
\nOm du vill migrera en befintlig tabell från en enda primärnyckel till en sammansatt primärnyckel ska du följa instruktionerna i din databasbackend för att göra det.
\nNär den sammansatta primärnyckeln är på plats lägger du till fältet CompositePrimaryKey i din modell. Detta gör att Django kan känna igen och hantera den sammansatta primära nyckeln på lämpligt sätt.
Även om migreringsåtgärder (t.ex. AddField, AlterField) på primärnyckelfält inte stöds, kommer makemigrations ändå att upptäcka ändringar.
För att undvika fel rekommenderas att sådana migreringar görs med --fake.
Alternativt kan SeparateDatabaseAndState användas för att utföra backend-specifika migreringar och Django-genererade migreringar i en enda operation.
Relationsfält, inklusive generiska relationer har inte stöd för sammansatta primärnycklar.
\nTill exempel, med modellen OrderLineItem stöds inte följande:
class Foo(models.Model):\n item = models.ForeignKey(OrderLineItem, on_delete=models.CASCADE)\nEftersom ForeignKey för närvarande inte kan referera till modeller med sammansatta primärnycklar.
För att komma runt denna begränsning kan ForeignObject användas som ett alternativ:
class Foo(models.Model):\n item_order_id = models.CharField(max_length=20)\n item_product_id = models.IntegerField()\n item = models.ForeignObject(\n OrderLineItem,\n on_delete=models.CASCADE,\n from_fields=("item_order_id", "item_product_id"),\n to_fields=("order_id", "product_id"),\n )\nForeignObject är ungefär som ForeignKey, förutom att det inte skapar några kolumner (t.ex. item_id), främmande nyckelbegränsningar eller index i databasen, och argumentet on_delete ignoreras.
Många databasfunktioner accepterar bara ett enda uttryck.
\nMAX("order_id") -- OK\nMAX("product_id", "order_id") -- ERROR\nI dessa fall ger en sammansatt primärnyckelreferens upphov till ett ValueError, eftersom den består av flera kolumnuttryck. Undantag görs för Count.
Max("order_id") # OK\nMax("pk") # ValueError\nCount("pk") # OK\nEftersom en sammansatt primärnyckel är ett virtuellt fält, ett fält som inte representerar en enda databaskolumn, är detta fält uteslutet från ModelForms.
\nTa till exempel följande formulär:
\nclass OrderLineItemForm(forms.ModelForm):\n class Meta:\n model = OrderLineItem\n fields = "__all__"\nDet här formuläret har inte något formulärfält pk för den sammansatta primärnyckeln:
>>> OrderLineItemForm()\n<OrderLineItemForm bound=False, valid=Unknown, fields=(product;order;quantity)>\nOm du anger det primära sammansatta fältet pk som ett formulärfält uppstår ett okänt fält FieldError.
Eftersom pk bara är ett virtuellt fält har det ingen effekt att inkludera pk som ett fältnamn i argumentet exclude i Model.clean_fields(). För att utesluta de sammansatta primärnyckelfälten från modellvalidering, ange varje fält individuellt. Model.validate_unique() kan fortfarande anropas med exclude={"pk"} för att hoppa över unikhetskontroller.
Före införandet av sammansatta primärnycklar kunde det enskilda fält som utgjorde primärnyckeln för en modell hämtas genom introspektion av attributet primary key för dess fält:
>>> pk_field = None\n>>> for field in Product._meta.get_fields():\n... if field.primary_key:\n... pk_field = field\n... break\n...\n>>> pk_field\n<django.db.models.fields.AutoField: id>\nNu när en primärnyckel kan bestå av flera fält kan attributet primary key inte längre användas för att identifiera medlemmar av primärnyckeln eftersom det kommer att sättas till False för att upprätthålla invariansen att högst ett fält per modell kommer att ha detta attribut satt till True:
>>> pk_fields = []\n>>> for field in OrderLineItem._meta.get_fields():\n... if field.primary_key:\n... pk_fields.append(field)\n...\n>>> pk_fields\n[]\nFör att bygga applikationskod som korrekt hanterar sammansatta primärnycklar bör attributet _meta.pk_fields användas istället:
>>> Product._meta.pk_fields\n[<django.db.models.fields.AutoField: id>]\n>>> OrderLineItem._meta.pk_fields\n[\n <django.db.models.fields.ForeignKey: product>,\n <django.db.models.fields.ForeignKey: order>\n]\n