_meta APILink to this heading#模型 _meta 的 API 是 Django ORM 的核心。它使系统的其他部分，如查找、查询、表单和管理能够理解每个模型的功能。API 可以通过每个模型类的 _meta 属性来访问，它是 django.db.models.options.Options 对象的一个实例。
Methods and attributes that it provides can be used to:
\n检索一个模型的所有字段实例
按名称检索模型的单个字段实例
Retrieve all fields that compose the primary key of a model
返回给定字段名的字段实例。
\nfield_name 可以是模型上的字段名，也可以是抽象或继承的模型上的字段名，或者是指向模型的另一个模型上定义的字段名。在后一种情况下，field_name 将是（按优先级排序）用户设置的 related_query_name，用户设置的 related_name，或者 Django 自动生成的名称。
Hidden fields, fields with hidden=True, cannot be retrieved by name.
如果没有找到指定名称的字段，将引发一个 FieldDoesNotExist 异常。
>>> 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'\n返回与模型相关联的字段的元组。get_fields() 接受两个参数，可以用来控制返回哪些字段：
include_parents默认为 True。递归地包括父类上定义的字段。如果设置为 False，get_fields() 将只搜索直接在当前模型上声明的字段。直接继承自抽象模型或代理类的模型的字段被认为是本地的，而不是在父类上。
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>)\nReturns a list of the fields composing the primary key of a model.
\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