_meta APILink to this heading#Modellens API _meta är kärnan i Django ORM. Det gör det möjligt för andra delar av systemet som uppslagningar, frågor, formulär och administratören att förstå kapaciteten hos varje modell. API:et är tillgängligt via attributet _meta i varje modellklass, som är en instans av ett django.db.models.options.Options-objekt.
Metoder och attribut som den tillhandahåller kan användas för att:
\nHämta alla fältinstanser för en modell
Hämta en instans med ett enda fält i en modell med namn
Hämta alla fält som utgör primärnyckeln i en modell
Returnerar fältinstansen när ett namn på ett fält anges.
\nfield_name kan vara namnet på ett fält i modellen, ett fält i en abstrakt eller ärvd modell, eller ett fält som definieras i en annan modell som pekar på modellen. I det senare fallet kommer field_name att vara (i prioritetsordning) det related_query_name som användaren har angett, det related_name som användaren har angett eller det namn som Django automatiskt genererar.
Hidden fields, fields with hidden=True, cannot be retrieved by name.
Om ett fält med det angivna namnet inte hittas kommer ett FieldDoesNotExist undantag att uppstå.
>>> from django.contrib.auth.models import User\n\n# A field on the model\n>>> User._meta.get_field("username")\n<django.db.models.fields.CharField: username>\n\n# A field from another model that has a relation with the current model\n>>> User._meta.get_field("logentry")\n<ManyToOneRel: admin.logentry>\n\n# A non existent field\n>>> User._meta.get_field("does_not_exist")\nTraceback (most recent call last):\n ...\nFieldDoesNotExist: User has no field named 'does_not_exist'\nReturnerar en tupel av fält som är associerade med en modell. get_fields() accepterar två parametrar som kan användas för att styra vilka fält som returneras:
inkludera_föräldrarTrue som standard. Inkluderar rekursivt fält som definierats i överordnade klasser. Om inställningen är False kommer get_fields() endast att söka efter fält som deklarerats direkt i den aktuella modellen. Fält från modeller som direkt ärver från abstrakta modeller eller proxyklasser anses vara lokala, inte i den överordnade klassen.
include_hiddenFalse by default. If set to True, get_fields() will include\nfields with hidden=True.
>>> from django.contrib.auth.models import User\n>>> User._meta.get_fields()\n(<ManyToOneRel: admin.logentry>,\n <django.db.models.fields.AutoField: id>,\n <django.db.models.fields.CharField: password>,\n <django.db.models.fields.DateTimeField: last_login>,\n <django.db.models.fields.BooleanField: is_superuser>,\n <django.db.models.fields.CharField: username>,\n <django.db.models.fields.CharField: first_name>,\n <django.db.models.fields.CharField: last_name>,\n <django.db.models.fields.EmailField: email>,\n <django.db.models.fields.BooleanField: is_staff>,\n <django.db.models.fields.BooleanField: is_active>,\n <django.db.models.fields.DateTimeField: date_joined>,\n <django.db.models.fields.related.ManyToManyField: groups>,\n <django.db.models.fields.related.ManyToManyField: user_permissions>)\n\n# Also include hidden fields.\n>>> User._meta.get_fields(include_hidden=True)\n(<ManyToOneRel: auth.user_groups>,\n <ManyToOneRel: auth.user_user_permissions>,\n <ManyToOneRel: admin.logentry>,\n <django.db.models.fields.AutoField: id>,\n <django.db.models.fields.CharField: password>,\n <django.db.models.fields.DateTimeField: last_login>,\n <django.db.models.fields.BooleanField: is_superuser>,\n <django.db.models.fields.CharField: username>,\n <django.db.models.fields.CharField: first_name>,\n <django.db.models.fields.CharField: last_name>,\n <django.db.models.fields.EmailField: email>,\n <django.db.models.fields.BooleanField: is_staff>,\n <django.db.models.fields.BooleanField: is_active>,\n <django.db.models.fields.DateTimeField: date_joined>,\n <django.db.models.fields.related.ManyToManyField: groups>,\n <django.db.models.fields.related.ManyToManyField: user_permissions>)\nReturnerar en lista över de fält som utgör primärnyckeln i en modell.
\nWhen a CompositePrimaryKey is defined on a model\nit will contain all the fields referenced by it.
from django.db import models\n\n\nclass TenantUser(models.Model):\n pk = models.CompositePrimaryKey("tenant_id", "id")\n tenant_id = models.IntegerField()\n id = models.IntegerField()\n>>> TenantUser._meta.pk_fields\n[\n <django.db.models.fields.IntegerField: tenant_id>,\n <django.db.models.fields.IntegerField: id>\n]\nOtherwise it will contain the single field declared as the primary key of\nthe model, either explicitly with primary_key=True or implicitly as the automatic\nprimary key.
>>> User._meta.pk_fields\n[<django.db.models.fields.AutoField: id>]\n