_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.
Dolda fält kan inte hämtas med namn.
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 som standard. Om inställningen är True kommer get_fields() att inkludera hidden fields.
>>> 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.
\nNär en composite primary key definieras på en modell kommer den att innehålla alla fields som den refererar till.
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]\nAnnars kommer det att innehålla det enda fält som deklarerats som primary key i modellen.
>>> User._meta.pk_fields\n[<django.db.models.fields.AutoField: id>]\n