{"title":"Roghanna múnla Meta","version":"5.2","locale":"ga","docname":"ref/models/options","url":"/ga/5.2/ref/models/options/","canonical":"https://djangodocs.dev/ga/5.2/ref/models/options/","summary":"Míníonn an doiciméad seo na roghanna meiteashonraí go léir:ref: féadfaidh tú do mhúnla a thabhairt ina aicme Meta inmheánach. Roghanna Meta ar fáil…","html":"

Roghanna múnla MetaLink to this heading#

\n

Míníonn an doiciméad seo na roghanna meiteashonraí go léir:ref: féadfaidh <meta-options>tú do mhúnla a thabhairt ina aicme Meta inmheánach.

\n
\n

Roghanna Meta ar fáilLink to this heading#

\n
\n

teochairLink to this heading#

\n
\n
\nOptions.abstractLink to this definition#
\n

<abstract-base-classes>Má tá abstract = True, beidh an tsamhail seo an:ref: `aicme bonn teibí `.

\n
\n\n
\n
\n

app_labelLink to this heading#

\n
\n
\nOptions.app_labelLink to this definition#
\n

Má shainmhínítear samhail lasmuigh d'iarratas in:setting: INSTALLED_APPS, ní mór dó a dhearbhú cén aip leis a bhaineann sé:

\n
Code
app_label = "myapp"\n
\n

Más mian leat samhail a léiriú leis an bhformáid app_label.object_name nó app_label.model_name is féidir leat model a úsáid. _meta.label nó samhail. _meta.label_lower faoi seach.

\n
\n\n
\n
\n

`ainm_bainisteoir baseLink to this heading#

\n
\n
\nOptions.base_manager_nameLink to this definition#
\n

Ainm tréithe an bhainisteora, mar shampla, 'objects, le húsáid do na samhlach's:attr: `~Django.db.Models.Model. _bainisteoir bunaisteoir'.

\n
\n\n
\n
\n

db_tableLink to this heading#

\n
\n
\nOptions.db_tableLink to this definition#
\n

Ainm an tábla bunachar sonraí le húsáid don tsamhail:

\n
Code
db_table = "music_album"\n
\n
\n\n
\n

Ainmneacha táblaLink to this heading#

\n

Chun am a shábháil duit, faigheann Django ainm an tábla bunachar sonraí go huathoibríoch ó ainm d'aicme samhail agus ón aip ina bhfuil sé. Tógtar ainm tábla bunachar sonraí samhail trí “lipéad aip” an tsamhail - an t-ainm a d'úsáid tú in:djadmin: manage.py startapp <startapp>- a cheangal le hainm ranga an tsamhail, le béim eatarthu.

\n

Mar shampla, má tá aip agat bookstore` (mar a chruthaigh manage.py startapp bookstore), beidh tábla bunachar sonraí darb ainm bookstore_book ag samhail a shainmhínítear mar class Book.

\n

Chun ainm an tábla bunachar sonraí a shárú, bain úsáid as an paraiméadar db_table i aicme Meta`.

\n

Más focal fhorchoimeádaithe SQL é d'ainm tábla bunachar sonraí, nó má tá carachtair nach gceadaítear in ainmneacha athróg Python - go háirithe, an giphen - tá sin ceart go leor. Luann Django ainmneacha colún agus tábla taobh thiar de na radhairc.

\n\n\n
\n
\n
\n

``db_table_comment ``Link to this heading#

\n
\n
\nOptions.db_table_commentLink to this definition#
\n
\n\n

An trácht ar an tábla bunachar sonraí le húsáid don tsamhail seo. Tá sé úsáideach chun táblaí bunachar sonraí a dhoiciméadú do dhaoine aonair a bhfuil rochtain dhíreach acu ar bhunachar sonraí nach bhfuil ag féachaint ar do chód Django. Mar shampla:

\n
Code
class 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"\n
\n
\n
\n

db_tablespaceLink to this heading#

\n
\n
\nOptions.db_tablespaceLink to this definition#
\n

Ainm an:doc: spás tábla bunachar sonraí le húsáid don tsamhail seo. </topics/db/tablespaces> Is é an réamhshocrú an tionscadal: setting: DEFAULT_TABLESPACE socrú, má tá sé socraithe. Mura dtacaíonn an cúltaca le spásanna tábla, déantar neamhaird ar an rogha seo.

\n
\n\n
\n
\n

ainm_bhainisteoir réamhshocraitheLink to this heading#

\n
\n
\nOptions.default_manager_nameLink to this definition#
\n

Ainm an bhainisteora le húsáid do na samhail's:attr: `~django.db.Models.Model. _bainisteoir réamhshocraithe'.

\n
\n\n
\n\n
\n

faigh_is déanaí_bLink to this heading#

\n
\n
\nOptions.get_latest_byLink to this definition#
\n

Ainm réimse nó liosta d'ainmneacha réimse sa tsamhail, de ghnáthach:class: DateField, :class: DateTimeField, nó:class: Integerfield. Sonraíonn sé seo an réimsí réamhshocraithe atá le húsáid i do mhúnla:class: Manager's:Meth: ~django.db.models.queryset.latest agus:meth: ~django.db.models.queryset.earliest modhanna.

\n

Sampla:

\n
Code
# 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"]\n
\n

Féach na docs: meth: ~django.db.models.query.queryset.latest le haghaidh tuilleadh eolais.

\n
\n\n
\n
\n

``bainistithe ``Link to this heading#

\n
\n
\nOptions.managedLink to this definition#
\n

Réamhshocraithe go True, rud a chiallaíonn go gcruthóidh Django na táblaí bunachar sonraí iomchuí in:djadmin: migrate nó mar chuid d'imirce agus bainfidh sé iad mar chuid d'ordú bainistíochta a:djadmin: flush. Is é sin, bainistíonn Django* saolré na dtáblaí bunachar sonraí.

\n

Má tá “False”, ní dhéanfar aon oibríochtaí cruthaithe, modhnú nó scriosadh tábla bunachar sonraí don tsamhail seo. Tá sé seo úsáideach má léiríonn an tsamhail tábla atá ann cheana nó dearcadh bunachar sonraí a cruthaíodh ar bhealach éigin eile. Is é seo an difríocht* ionly* nuair a bhíonn bainistithe = bréag`. Tá gach gné eile de láimhseáil samhail díreach mar an gcéanna leis an ngnách. Áirítear leis seo

\n
    \n

  1. Réimse eochair phríomhúil uathoibríoch a chur leis an tsamhail mura ndearbhaíonn tú é. Chun mearbhall a sheachaint do léitheoirí cód níos déanaí, moltar na colúin go léir ón tábla bunachar sonraí atá tú ag samhaltú a shonrú agus samhlacha neamhbhainistithe á úsáid agat.

    2. \n

  2. Má tá a: class: ~django.db.models.manyToManyField i samhail le Managed=False` a thugann in iúl ar mhúnla neamh-bhainistithe eile, ansin ní chruthófar an tábla idirmheánach don chomhcheangal go leor freisin. Mar sin féin, cruthófar an tábla idirghabhálaí idir samhail amháin bainistithe agus samhail neamh-bhainistithe amháin **.

    \n

    Más gá duit an t-iompar réamhshocraithe seo a athrú, cruthaigh an tábla idirghabhálaí mar mhúnla follasach (le bhainistithe ``socraithe de réir mar is gá) agus bain úsáid as an tréith: attr: `ManyTomanyField.through chun an gaol a úsáid do mhúnla saincheaptha.

    \n
    3. \n
\n

Maidir le tástálacha a bhaineann le samhlacha le Managed = False`, is fútsa atá sé a chinntiú go gcruthaítear na táblaí cearta mar chuid den socrú tástála.

\n

Má tá suim agat iompar rang samhail ar leibhéal Python a athrú, d'fhéad* d'fhéad* Managed = False a úsáid agus cóip de mhúnla atá ann cheana a chruthú. Mar sin féin, tá cur chuige níos fearr ann don chás sin: :ref: proxy-models.

\n
\n\n
\n
\n

``ordó_le_urchúis_toLink to this heading#

\n
\n
\nOptions.order_with_respect_toLink to this definition#
\n

Déanann an réad seo inordaithe maidir leis an réimse ar leith, de ghnáth is “ForeignKey'”. Is féidir é seo a úsáid chun rudaí gaolmhara a dhéanamh inordaithe maidir le réad tuismitheora. Mar shampla, má bhaineann Freagra le réad Ceiste, agus má tá níos mó ná freagra amháin ag ceist, agus má tá ord na bhfreagraí tábhachtach, déanfá seo:

\n
Code
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"\n
\n

Nuair a shocraítear order_with_respect_to, cuirtear dhá mhodh breise ar fáil chun ord na rudaí gaolmhara a aisghabháil agus a shocrú: get_related_order () ``agus ``set_related_order (), áit a bhfuil RELATED` ainm an tsamhail ísle. Mar shampla, ag glacadh leis go bhfuil rudaí iolracha Freagra gaolmhara ag réad Ceiste, tá príomh-eochracha na rudaí Freagra gaolmhara sa liosta a thugtar ar ais:

\n
Python console
>>> question = Question.objects.get(id=1)\n>>> question.get_answer_order()\n[1, 2, 3]\n
\n

Is féidir ord rudaí Cheiste a bhaineann le Freagra a shocrú trí liosta de phríomhheochracha `Freagra a chur isteach:

\n
Python console
>>> question.set_answer_order([3, 1, 2])\n
\n

Faigheann na rudaí gaolmhara dhá mhodh freisin, get_next_in_order () ``agus ``get_previous_in_order (), ar féidir a úsáid chun rochtain a fháil ar na rudaí sin ina n-ord ceart. Ag glacadh leis go bhfuil na rudaí Freagra ordaithe ag id`:

\n
Python console
>>> answer = Answer.objects.get(id=2)\n>>> answer.get_next_in_order()\n<Answer: 3>\n>>> answer.get_previous_in_order()\n<Answer: 1>\n
\n
\n\n\n\n
\n
\n

``ordú ``Link to this heading#

\n
\n
\nOptions.orderingLink to this definition#
\n

An t-ordú réamhshocraithe don réad, le húsáid agus liostaí rudaí á fháil:

\n
Code
ordering = ["-order_date"]\n
\n

Is tuple nó liosta teaghráin agus/nó nathanna fiosrúcháin é seo. Is ainm réimse é gach sreang le réimír roghnach “-”, a léiríonn ord íslitheach. Ordófar páirceanna gan tosaigh “-” ag ardú. Úsáid an teaghrán “?” chun ordú go randamach.

\n

Mar shampla, chun ordú de réir réimse pub_date ag ardú, bain úsáid as seo:

\n
Code
ordering = ["pub_date"]\n
\n

Chun ordú trí pub_date` síos, bain úsáid as seo:

\n
Code
ordering = ["-pub_date"]\n
\n

Chun ordú trí pub_date ``ag dul síos, ansin trí ``author` ag ardú, bain úsáid as seo:

\n
Code
ordering = ["-pub_date", "author"]\n
\n

Is féidir leat úsáid freisin: doc: léirithe fiosraithe' </ref/models/expressions>. Chun ordú trí ``údar` ag ardú agus luachanna null a shórtáil go deireanach, bain úsáid as seo:

\n
Code
from django.db.models import F\n\nordering = [F("author").asc(nulls_last=True)]\n
\n
\n\n\n\n
\n
\n

ceadúnaíLink to this heading#

\n
\n
\nOptions.permissionsLink to this definition#
\n

Ceadanna breise le dul isteach sa tábla ceadanna agus an réad seo á chruthú. Cruthaítear ceadanna a chur leis, a athrú, a scriosadh agus féachaint go huathoibríoch do gach samhail. Sonraíonn an sampla seo cead breise, can_deliver_pizzas:

\n
Code
permissions = [("can_deliver_pizzas", "Can deliver pizzas")]\n
\n

Seo liosta nó tiúpla de dhá thúpla san fhormáid (ceadúna_cód, human_readable_ceadúna_ainm).

\n
\n\n
\n
\n

ceadúna_réamhshocraitheLink to this heading#

\n
\n
\nOptions.default_permissionsLink to this definition#
\n

Réamhshocraithe go ('cuir', 'athraigh', 'scrios', 'view'). Féadfaidh tú an liosta seo a shaincheapadh, mar shampla, tríd é seo a shocrú ar liosta folamh mura dteastaíonn aon chead de na ceadanna réamhshocraithe ag teastáil ó aip. Caithfear é a shonrú ar an tsamhail sula gcruthófar an tsamhail ó:djadmin: migrate d'fhonn cosc a chur ar aon cheadanna fágtha a chruthú.

\n
\n\n
\n
\n

proxyLink to this heading#

\n
\n
\nOptions.proxyLink to this definition#
\n

<proxy-models>Má tá proxy = True, déileálfar le samhail a fho-aicmíonn samhail eile mar a:ref: `seachmhúnla `.

\n
\n\n
\n
\n

riachtanach_db_gnéatachLink to this heading#

\n
\n
\nOptions.required_db_featuresLink to this definition#
\n

Liosta de na gnéithe bunachar sonraí ba chóir a bheith ag an nasc reatha ionas go mbreithnítear an tsamhail le linn na céime imirce. Mar shampla, má shocraíonn tú an liosta seo go ['gis_enabled'], ní dhéanfar an tsamhail a shioncronú ach ar bhunachar sonraí atá cumasaithe GIS. Tá sé úsáideach freisin roinnt samhlacha a scipeáil agus tú ag tástáil le roinnt cúltaca bunachar sonraí. Seachain caidreamh idir samhlacha a d'fhéadfaí nó nach féidir a chruthú toisc nach láimhseálann an ORM é seo.

\n
\n\n
\n
\n

riachtanach_db_vendorLink to this heading#

\n
\n
\nOptions.required_db_vendorLink to this definition#
\n

Ainm díoltóra bunachar sonraí tacaithe a bhfuil an tsamhail seo sonrach air. Is iad na hainmneacha díoltóra ionsuite reatha: sqlite, postgresql`, mysql, oracle. Mura bhfuil an tréith seo folamh agus mura n-oireann an díoltóir nasc reatha leis, ní dhéanfar an tsamhail a shioncronú.

\n
\n\n
\n
\n

roghnaithe_on_shábháilLink to this heading#

\n
\n
\nOptions.select_on_saveLink to this definition#
\n

Cinneann sé an n-úsáidfidh Django an algartam réamh-1.6: meth: Django.db.Models.Model.save () `. Úsáideann an sean-algartam ``SELECT` chun a chinneadh an bhfuil sraith ann atá le nuashonrú. Déanann an algartam nua iarracht UPDATE go díreach. I roinnt cásanna neamhchoitianta ní fheiceann Django an UPDATE de shraith atá ann cheana. Sampla is ea an truicear PostgreSQL ON UPDATE a fhilleann NULL. I gcásanna den sórt sin beidh an algartam nua ag déanamh INSERT fiú nuair a bhíonn sraith ann sa bhunachar sonraí.

\n

De ghnáth ní gá an tréith seo a shocrú. Is é an réamhshocrú False.

\n

Féach: Meth: `django.db.models.model.save () `le haghaidh tuilleadh eolais faoin algartam sábhála sean agus nua.

\n
\n\n
\n
\n

``Innéacsanna ``Link to this heading#

\n
\n
\nOptions.indexesLink to this definition#
\n

Liosta de:doc: indexes </ref/models/indexes> ar mhaith leat a shainiú ar an tsamhail:

\n
Code
from 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        ]\n
\n
\n\n
\n
\n

uathach_le chéimeLink to this heading#

\n
\n
\nOptions.unique_togetherLink to this definition#
\n
\n

Tacair ainmneacha réimse a chaithfidh, a thógtar le chéile, a bheith uathúil:

\n
Code
unique_together = [["driver", "restaurant"]]\n
\n

Seo liosta de na liostaí a chaithfidh a bheith uathúil nuair a mheastar le chéile. Úsáidtear é i riarachán Django agus cuirtear i bhfeidhm ar leibhéal an bhunachar sonraí (ie, tá na ráitis chuí UNIQUE san áireamh sa ráiteas CREATE TABLE).

\n

Ar mhaithe le háisiúlacht, is féidir le ``unique_together ``a bheith ina liosta amháin agus tú ag déileáil le sraith amháin réimsí:

\n
Code
unique_together = ["driver", "restaurant"]\n
\n

A: Aicme: ~Django.db.Models.ManyTomanyField ní féidir a chur san áireamh i ``unique_together ``. (Níl sé soiléir cad a chiallódh sé sin fiú!) <ManyToManyField.through>Más gá duit uathúlacht a bhaineann le a:class: ~django.db.models.manyToManyField a bhailíochtú, déan iarracht comhartha nó samhail explicit:attr: `through `a úsáid.

\n

Tá an cód earráide unique_together ``sa `ValidationError a ardaítear le linn bailíochtaithe samhail nuair a sháraítear an srian.

\n
\n\n
\n
\n

``srianta ``Link to this heading#

\n
\n
\nOptions.constraintsLink to this definition#
\n

Liosta de:doc: sriantaine ar mhaith leat a shainiú </ref/models/constraints> ar an tsamhail:

\n
Code
from 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        ]\n
\n
\n\n
\n
\n

ainm_verboseLink to this heading#

\n
\n
\nOptions.verbose_nameLink to this definition#
\n

Ainm inléite don duine don réad, uathúil:

\n
Code
verbose_name = "pizza"\n
\n

Mura dtugtar é seo, úsáidfidh Django leagan de ainm an ranga: Camelcase éiríonn `cás camel.

\n
\n\n
\n
\n

ainm_verbose_pluralLink to this heading#

\n
\n
\nOptions.verbose_name_pluralLink to this definition#
\n

An t-ainm iolra don réad:

\n
Code
verbose_name_plural = "stories"\n
\n

Mura dtugtar é seo, úsáidfidh Django: attr: ~options.verbose_name + "s".

\n
\n\n
\n
\n
\n

Tréithe Meta atá le léamh amháinLink to this heading#

\n
\n

lipéadLink to this heading#

\n
\n
\nOptions.labelLink to this definition#
\n

Léiríonn an réad, filleann app_label.object_name, m.sh. `Polls.question'.

\n
\n\n
\n
\n

label_lowerLink to this heading#

\n
\n
\nOptions.label_lowerLink to this definition#
\n

Léiríonn léiriú an tsamhail, filleann app_label.model_name, m.sh. `polls.question'.

\n
\n\n
\n
","rootId":"model-meta-options","toc":[{"title":"Roghanna Meta ar fáil","anchor":"available-meta-options","children":[{"title":"teochair","anchor":"abstract","children":[]},{"title":"app_label","anchor":"app-label","children":[]},{"title":"`ainm_bainisteoir base","anchor":"base-manager-name","children":[]},{"title":"db_table","anchor":"db-table","children":[{"title":"Ainmneacha tábla","anchor":"table-names","children":[]}]},{"title":"``db_table_comment ``","anchor":"db-table-comment","children":[]},{"title":"db_tablespace","anchor":"db-tablespace","children":[]},{"title":"ainm_bhainisteoir réamhshocraithe","anchor":"default-manager-name","children":[]},{"title":"ainm_bhainteach_réamhshocraithe","anchor":"default-related-name","children":[]},{"title":"faigh_is déanaí_b","anchor":"get-latest-by","children":[]},{"title":"``bainistithe ``","anchor":"managed","children":[]},{"title":"``ordó_le_urchúis_to","anchor":"order-with-respect-to","children":[]},{"title":"``ordú ``","anchor":"ordering","children":[]},{"title":"ceadúnaí","anchor":"permissions","children":[]},{"title":"ceadúna_réamhshocraithe","anchor":"default-permissions","children":[]},{"title":"proxy","anchor":"proxy","children":[]},{"title":"riachtanach_db_gnéatach","anchor":"required-db-features","children":[]},{"title":"riachtanach_db_vendor","anchor":"required-db-vendor","children":[]},{"title":"roghnaithe_on_shábháil","anchor":"select-on-save","children":[]},{"title":"``Innéacsanna ``","anchor":"indexes","children":[]},{"title":"uathach_le chéime","anchor":"unique-together","children":[]},{"title":"``srianta ``","anchor":"constraints","children":[]},{"title":"ainm_verbose","anchor":"verbose-name","children":[]},{"title":"ainm_verbose_plural","anchor":"verbose-name-plural","children":[]}]},{"title":"Tréithe Meta atá le léamh amháin","anchor":"read-only-meta-attributes","children":[{"title":"lipéad","anchor":"label","children":[]},{"title":"label_lower","anchor":"label-lower","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/models/index","title":"Samhla","url":"/ga/5.2/ref/models/"}],"prev":{"docname":"ref/models/class","title":"Tagairt aicme múnla","url":"/ga/5.2/ref/models/class/"},"next":{"docname":"ref/models/instances","title":"Tagairt sampla samhail","url":"/ga/5.2/ref/models/instances/"},"formats":{"html":"/ga/5.2/ref/models/options/","markdown":"/ga/5.2/ref/models/options.md","json":"/ga/5.2/ref/models/options.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/models/options.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/models/options/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}