MetaLink to this heading#Detta dokument förklarar alla möjliga metadata options som du kan ge din modell i dess interna class Meta.
Meta-alternativLink to this heading#abstraktLink to this heading#Om abstract = True, kommer denna modell att vara en abstrakt basklass.
app_labelLink to this heading#Om en modell definieras utanför en applikation i INSTALLED_APPS, måste den ange vilken app den tillhör:
app_label = "myapp"\nOm du vill representera en modell med formatet app_label.object_name eller app_label.model_name kan du använda model._meta.label respektive model._meta.label_lower.
bas_chefsnamnLink to this heading#Attributnamnet på hanteraren, t.ex. 'objects', som ska användas för modellens _base_manager.
db_tableLink to this heading#Namnet på den databastabell som ska användas för modellen:
\ndb_table = "music_album"\nFör att spara tid härleder Django automatiskt namnet på databastabellen från namnet på din modellklass och den app som innehåller den. Namnet på en modells databastabell konstrueras genom att modellens ”app label” - det namn du använde i manage.py startapp - kopplas till modellens klassnamn, med ett understreck mellan dem.
Om du t.ex. har en app bookstore (som skapats av manage.py startapp bookstore), kommer en modell som definieras som class Book att ha en databastabell med namnet bookstore_book.
Om du vill åsidosätta databasens tabellnamn använder du parametern db_table i class Meta.
Om tabellnamnet i din databas är ett reserverat SQL-ord eller innehåller tecken som inte är tillåtna i Python-variabelnamn - särskilt bindestrecket - är det OK. Django citerar kolumn- och tabellnamn bakom kulisserna.
\n\n\ndb_table_commentLink to this heading#Kommentaren om databastabellen som ska användas för den här modellen. Det är användbart för att dokumentera databastabeller för personer med direkt databasåtkomst som kanske inte tittar på din Django-kod. Till exempel:
\nclass Answer(models.Model):\n question = models.ForeignKey(Question, on_delete=models.CASCADE)\n answer = models.TextField()\n\n class Meta:\n db_table_comment = "Question answers"\ndb_tablespaceLink to this heading#Namnet på det databas-tabellutrymme som ska användas för den här modellen. Standardvärdet är projektets DEFAULT_TABLESPACE-inställning, om den är inställd. Om backend inte stöder tablespaces ignoreras detta alternativ.
förvaltarens_namnLink to this heading#Namnet på den manager som ska användas för modellens _default_manager.
Namnet på ett fält eller en lista med fältnamn i modellen, vanligtvis DateField, DateTimeField eller IntegerField. Detta anger det eller de standardfält som ska användas i din modell Manager:s metoder latest() och earliest().
Exempel:
\n# Latest by ascending order_date.\nget_latest_by = "order_date"\n\n# Latest by priority descending, order_date ascending.\nget_latest_by = ["-priority", "order_date"]\nSe latest()-dokumenten för mer information.
hanteradLink to this heading#Standardvärdet är True, vilket innebär att Django kommer att skapa lämpliga databastabeller i migrate eller som en del av migreringar och ta bort dem som en del av ett flush-hanteringskommando. Det vill säga, Django hanterar databastabellernas livscykler.
Om False, kommer inga åtgärder för att skapa, ändra eller ta bort databastabeller att utföras för denna modell. Detta är användbart om modellen representerar en befintlig tabell eller en databasvy som har skapats på något annat sätt. Detta är den enda skillnaden när managed=False. Alla andra aspekter av modellhanteringen är exakt desamma som normalt. Detta inkluderar
Adding an automatic primary key field to the model if you don’t\ndeclare it. To avoid confusion for later code readers, it’s\nrecommended to specify all the columns from the database table you\nare modeling when using unmanaged models.
Om en modell med managed=False innehåller en ManyToManyField som pekar på en annan ohanterad modell, så kommer inte heller den mellanliggande tabellen för many-to-many join att skapas. Men den mellanliggande tabellen mellan en hanterad och en ohanterad modell kommer att skapas.
Om du behöver ändra detta standardbeteende skapar du den mellanliggande tabellen som en explicit modell (med managed inställt efter behov) och använder attributet ManyToManyField.through för att relationen ska använda din anpassade modell.
För tester som involverar modeller med managed=False är det upp till dig att se till att rätt tabeller skapas som en del av testinställningen.
Om du är intresserad av att ändra beteendet på Python-nivå för en modellklass, skulle du kunna använda managed=False och skapa en kopia av en befintlig modell. Det finns dock ett bättre tillvägagångssätt för den situationen: Proxy-modeller.
Gör detta objekt beställningsbart med avseende på det angivna fältet, vanligtvis en ForeignKey. Detta kan användas för att göra relaterade objekt beställningsbara med avseende på ett överordnat objekt. Till exempel:, om ett Answer relaterar till ett Question-objekt, och en fråga har mer än ett svar, och ordningen på svaren spelar roll, skulle du göra så här:
from django.db import models\n\n\nclass Question(models.Model):\n text = models.TextField()\n # ...\n\n\nclass Answer(models.Model):\n question = models.ForeignKey(Question, on_delete=models.CASCADE)\n # ...\n\n class Meta:\n order_with_respect_to = "question"\nNär order_with_respect_to är inställd, tillhandahålls två ytterligare metoder för att hämta och ställa in ordningen på de relaterade objekten: get_RELATED_order() och set_RELATED_order(), där RELATED är modellnamnet med gemener. Om man t.ex. antar att ett Question-objekt har flera relaterade Answer-objekt, innehåller den returnerade listan primärnycklarna för de relaterade Answer-objekten:
>>> question = Question.objects.get(id=1)\n>>> question.get_answer_order()\n[1, 2, 3]\nOrdningen på ett Question-objekts relaterade Answer-objekt kan ställas in genom att skicka in en lista med Answer-primärnycklar:
>>> question.set_answer_order([3, 1, 2])\nDe relaterade objekten får också två metoder, get_next_in_order() och get_previous_in_order(), som kan användas för att komma åt dessa objekt i rätt ordning. Anta att objekten Answer är ordnade efter id:
>>> answer = Answer.objects.get(id=2)\n>>> answer.get_next_in_order()\n<Answer: 3>\n>>> answer.get_previous_in_order()\n<Answer: 1>\nbeställningLink to this heading#Standardordningen för objektet, för användning vid hämtning av listor över objekt:
\nordering = ["-order_date"]\nDetta är en tupel eller lista med strängar och/eller frågeuttryck. Varje sträng är ett fältnamn med ett valfritt prefix ”-”, som anger fallande ordning. Fält utan ett inledande ”-” ordnas i stigande ordning. Använd strängen ”?” för slumpmässig ordning.
\nOm du t.ex. vill sortera fältet pub_date i stigande ordning använder du följande:
ordering = ["pub_date"]\nFör att beställa efter pub_date i fallande ordning, använd detta:
ordering = ["-pub_date"]\nFör att beställa efter pub_date i fallande ordning, sedan efter author i stigande ordning, använd detta:
ordering = ["-pub_date", "author"]\nDu kan också använda frågeuttryck. För att sortera efter author stigande och få null-värden att sorteras sist, använd detta:
from django.db.models import F\n\nordering = [F("author").asc(nulls_last=True)]\nbehörigheterLink to this heading#Extra behörigheter som ska anges i behörighetstabellen när du skapar det här objektet. Behörigheter för att lägga till, ändra, ta bort och visa skapas automatiskt för varje modell. I det här exemplet anges en extra behörighet, can_deliver_pizzas:
permissions = [("can_deliver_pizzas", "Can deliver pizzas")]\nDetta är en lista eller tupel av 2-tuplar i formatet (permission_code, human_readable_permission_name).
standard_behörigheterLink to this heading#Standardvärdet är ('add', 'change', 'delete', 'view'). Du kan anpassa den här listan, till exempel genom att ange en tom lista om din app inte kräver någon av standardbehörigheterna. Den måste anges för modellen innan modellen skapas av migrate för att förhindra att utelämnade behörigheter skapas.
proxyLink to this heading#Om proxy = True, kommer en modell som subklassar en annan modell att behandlas som en proxymodell.
krävda_db_funktionerLink to this heading#Lista över databasfunktioner som den aktuella anslutningen bör ha så att modellen beaktas under migreringsfasen. Om du t.ex. anger ['gis_enabled'] i den här listan kommer modellen endast att synkroniseras med GIS-aktiverade databaser. Det är också bra att hoppa över vissa modeller när du testar med flera databasbackends. Undvik relationer mellan modeller som kanske eller kanske inte skapas eftersom ORM inte hanterar detta.
krävd_db_leverantörLink to this heading#Namn på en databasleverantör som stöds och som denna modell är specifik för. Aktuella inbyggda leverantörsnamn är: sqlite, postgresql, mysql, oracle. Om detta attribut inte är tomt och den aktuella anslutningsleverantören inte matchar det, kommer modellen inte att synkroniseras.
Välj_vid_sparandeLink to this heading#Determines if Django will use the pre-1.6\ndjango.db.models.Model.save() algorithm. The old algorithm\nuses SELECT to determine if there is an existing row to be updated.\nThe new algorithm tries an UPDATE directly. In some rare cases the\nUPDATE of an existing row isn’t visible to Django. An example is the\nPostgreSQL ON UPDATE trigger which returns NULL. In such cases the\nnew algorithm will end up doing an INSERT even when a row exists in\nthe database.
Vanligtvis finns det inget behov av att ställa in detta attribut. Standardvärdet är False.
See django.db.models.Model.save() for more about the old and\nnew saving algorithm.
indexLink to this heading#En lista över index som du vill definiera på modellen:
\nfrom django.db import models\n\n\nclass Customer(models.Model):\n first_name = models.CharField(max_length=100)\n last_name = models.CharField(max_length=100)\n\n class Meta:\n indexes = [\n models.Index(fields=["last_name", "first_name"]),\n models.Index(fields=["first_name"], name="first_name_idx"),\n ]\nunique_togetherLink to this heading#Uppsättningar av fältnamn som tillsammans måste vara unika:
\nunique_together = [["driver", "restaurant"]]\nDetta är en lista över listor som måste vara unika när de betraktas tillsammans. Den används i Django-administratören och verkställs på databasnivå (dvs. lämpliga UNIQUE-satser ingår i CREATE TABLE-satsen).
För enkelhetens skull kan unique_together vara en enda lista när det handlar om en enda uppsättning fält:
unique_together = ["driver", "restaurant"]\nEn ManyToManyField kan inte inkluderas i unique_together. (Det är inte klart vad det ens skulle betyda!) Om du behöver validera unikhet relaterad till en ManyToManyField, försök använda en signal eller en explicit through modell.
Det ValidationError som uppstår vid modellvalidering när villkoret överträds har felkoden unique_together.
begränsningarLink to this heading#En lista över begränsningar som du vill definiera på modellen:
\nfrom django.db import models\n\n\nclass Customer(models.Model):\n age = models.IntegerField()\n\n class Meta:\n constraints = [\n models.CheckConstraint(condition=models.Q(age__gte=18), name="age_gte_18"),\n ]\nverbose_namnLink to this heading#Ett mänskligt läsbart namn för objektet, singular:
\nverbose_name = "pizza"\nOm detta inte anges kommer Django att använda en sammansatt version av klassnamnet: CamelCase blir camel case.
verbose_namn_pluralLink to this heading#Det plurala namnet för objektet:
\nverbose_name_plural = "stories"\nOm detta inte anges kommer Django att använda verbose_name + "s".
Meta-attributLink to this heading#etikettLink to this heading#Representation av objektet, returnerar app_label.object_name, t.ex. 'polls.Question'.
etikett_nedreLink to this heading#Representation av modellen, returnerar app_label.model_name, t.ex. 'polls.question'.