--- title: "Nótaí scaoilte Django 2.2" version: 6.0 locale: ga source: https://docs.djangoproject.com/ga/6.0/releases/2.2/ canonical: https://djangodocs.dev/ga/6.0/releases/2.2/ --- # Nótaí scaoilte Django 2.2 *1 Aibreán, 2019* Fáilte go dtí Django 2.2! Clúdaíonn na nótaí scaoilte seo na:ref: gnéithe nua \, chomh maith le roinnt: ref: athruithe neamh-chomhoiriúnacha ar chúl\ a mbeidh tú ag iarraidh a bheith ar an eolas fúthu agus tú ag uasghrádú ó Django 2.1 nó níos luaithe. \We've:ref: thosaigh an próiseas díghabhála do roinnt gnéithe . Féach an treoir:doc: /howto/upgrade-leagan má tá tionscadal atá ann cheana á nuashonrú agat. \Ainmnítear Django 2.2 mar a: téarma: scaoileadh tacaíochta fadtéarmach . Gheobhaidh sé nuashonruithe slándála ar feadh trí bliana ar a laghad tar éis a scaoilte Tiocfaidh deireadh le tacaíocht don LTS roimhe seo, Django 1.11, i mí Aibreáin 2020. ## Comhoiriúnacht Python Tacaíonn Django 2.2 le Python 3.5, 3.6, 3.7, 3.8 (amhail 2.2.8), agus 3.9 (amhail 2.2.17). Molaimid\*\* go hard\*\* agus ní thacaímid go hoifigiúil ach leis an scaoileadh is déanaí de gach sraith. ## Cad atá nua i Django 2.2 ### Srianta Cumasaíonn na ranganna nua:class: ~django.db.Models.CheckConstraint agus:class: ~django.db.models.uniqueConstraint srianta bunachar sonraí saincheaptha a chur leis. \Cuirtear srianta le samhlacha ag baint úsáide as an rogha: attr: Meta.Constraints . ### Mionghnéithe #### [`django.contrib.admin`](/ga/6.0/ref/contrib/admin/#module-django.contrib.admin) - Cuireadh rang CSS leis na ceannteidil colún de:class: ~django.contrib.admin.tabularInline. #### [`django.contrib.auth`](/ga/6.0/topics/auth/#module-django.contrib.auth) - Cuirtear an HttpRequest\` anois mar an chéad argóint seasaimh chuig:meth: .remoteUserBackend.configure\_user, má ghlacann sé leis. #### [`django.contrib.gis`](/ga/6.0/ref/contrib/gis/#module-django.contrib.gis) - Cuireadh tacaíocht Oracle leis an bhfeidhm:: class: ~django.contrib.gis.db.Models.Functions.Envelope. - Cuireadh tacaíocht SpatialITE leis na cuardaigh: lookup: coveredby agus:lookup: clúdaire. #### [`django.contrib.postgres`](/ga/6.0/ref/contrib/postgres/#module-django.contrib.postgres) - Cinneann an argóint nua ordú do:class: ~django.contrib.postgres.aggregates.arrayAgg agus:class: ~django.contrib.postgres.aggregates.stringagg ordú na n-eilimintí comhiomlánaithe. - Ceadaíonn na ranganna nua:class: ~django.contrib.postgres.indexes.btreeIndex, :class: ~django.contrib.postgres.indexes.hashIndex agus:class: ~django.contrib.postgres.indexes.spgistIndex a chruthú `B-Tree`, hash\`, agus `SP-Gist` innéacsanna sa bhunachar sonraí. - [`BrinIndex`](/ga/6.0/ref/contrib/postgres/indexes/#django.contrib.postgres.indexes.BrinIndex) now has the `autosummarize` parameter. - Ceadaíonn an paraiméadar nua `search_type` de:class: ~django.contrib.postgres.search.searchquery cuardach a dhéanamh ar abairt nó léiriú amh. #### [`django.contrib.staticfiles`](/ga/6.0/ref/contrib/staticfiles/#module-django.contrib.staticfiles) - Breise cosán a mheaitseáil leis an rogha:: collectstatic --ignore ionas gur féidir patrúin mar /díoltór/.js a úsáid. #### Cúltaca bunachar sonraí - Sruthú torthaí leis le haghaidh: meth: .queryset.iterator ar SQLite. #### Tuairimí cineálacha - Cuireann an crúca nua:meth: View.setup \\`tréithe radharc a thosú sula nglaonn sé ar: meth: \`~django.views.generic.base.view.dispch. Ligeann sé meascáin tréithe sampla a chur ar bun le húsáid i ranganna leanaí. #### Idirnáisiúnú - Tacaíocht agus aistriúcháin leis an teanga Airméinis. #### Orduithe Bainistíochta - Cuireann an rogha nua:rogha: --force-dath iallach ar an aschur ordaithe a dhathú. - : djadmin: Cruthaíonn inspectdb samhlacha anois do tháblaí eachtracha ar PostgreSQL. - [`inspectdb --include-views`](/ga/6.0/ref/django-admin/#cmdoption-inspectdb-include-views) now creates models for materialized views on Oracle and PostgreSQL. - Ligeann an rogha nua:option: inspectdb --include-parttions samhlacha a chruthú le haghaidh táblaí deighilte ar PostgreSQL. I leaganacha níos sine, cruthaítear samhlacha táblaí leanbh ina ionad an tuismitheoir. - : djadmin: inspectdb anois introspects:class: ~django.db.models.durationfield do Oracle agus PostgreSQL, agus:class: ~django.db.models.autofield le haghaidh SQLite. - Ar Oracle, :djadmin: tá dbshell fillte le `rlwrap`, má tá sé ar fáil. Soláthraíonn `rlwrap` stair ordaithe agus eagarthóireacht ionchur méarchláir. - Seachnaíonn an rogha nua:option: makemigrations --no-header tráchtanna ceanntásc a scríobh i gcomhad (í) imirce ginte. Tá an rogha seo ar fáil freisin le haghaidh: djadmin: squashmigrations. - [`runserver`](/ga/6.0/ref/django-admin/#django-admin-runserver) can now use [Watchman](https://facebook.github.io/watchman/) to improve the performance of watching a large number of files for changes. #### Imirce - Priontáil an rogha nua:option: migration --plan 'liosta na n-oibríochtaí imirce a dhéanfar. - Is féidir `nonetype` a shraitheadh anois in imirce. - \Is féidir leat anois:ref: sraitheoirí saincheaptha a chlárúch le haghaidh imirce. #### Samhla - Tacaíocht bhreise do ranganna oibreora PostgreSQL (:attr: .index.opClasses). - Tacaíocht bhreise le haghaidh innéacsanna páirteach (:attr: .index.condition). - \Cuireadh feidhmeanna bunachar sonraí: class: ~django.db.models.functions.nullif agus:class: ~django.db.models.functions.reverse feidhmeanna bunachar sonraí leis, chomh maith le go leor: ref: feidhmeanna bunachar sonraí math . - Ag socrú an paraiméadar nua `ignore_conflicts` de:meth: .queryset.bulk\_create go `True`, insíonn sé don bhunachar sonraí neamhaird a dhéanamh ar theip ar shraitheanna a chur isteach nach dteipeann srianta uathúlachta nó seiceálacha eile. - Baineann an fheidhm nua:class: ~django.db.Models.Functions.ExtractisoYear blianta uimhrithe seachtaine ISO-8601 ó:class: ~django.db.Models.DateField agus:class: ~Django.db.Models.DateTimeField, agus ceadaíonn an nua:lookup: iso\_year fiosrú ag ISO-8601 bliain uimhrithe seachtaine. - Ligeann an modh nua:meth: .queryset.bulk\_update réimsí sonracha a nuashonrú go héifeachtúil ar chásanna samhail iolracha. - Ní thosaíonn Django idirbheart a thuilleadh nuair a bhíonn ceist amháin á dhéanamh, mar shampla ```Model.save () ``, `QuerySet.Update ()```, agus Model.delete () . Feabhsaíonn sé seo feidhmíocht autocommit trí líon na dturais babhta bunachar sonraí a laghdú. - Cuireadh tacaíocht SQLite leis na feidhmeanna: class: ~django.db.models.stddev agus:class: ~django.db.models.variance. - Cuirtear láimhseáil comhiomlánú `DISTINCT` leis an aicme:class: ~django.db.Models.Aggregate. \Ag cur leis: attr: allow\_different = True \`mar thréith aicme ar fho-aicmí \`\`Comhléad\` ceadaíonn argóint eochairfhocal `distint` a shonrú ar thionscnamh chun a chinntiú nach n-iarrtar an fheidhm chomhiomlán ach do gach luach ar leith de léiritheach\`. - Ceadaítear modhanna: Meth: .relatedManager.add, :meth: ~.relatedManager.create, :meth: ~.relatedManager.remove, :meth: ~.relatedManager.set, ```get_or_create () ``, agus ``update_or_create () `modhanna idirmheánach anois ar go leor le go leor le go leor samhlacha. Úsáidtear an argóint nua `through_defaults``` chun luachanna a shonrú do shampla (í) samhail idirmheánach nua. #### Iarrataí agus Freagraí - Cuireadh leis: attr: .httpRequest.headers chun rochtain shimplí a cheadú ar cheanntásc iarratais. #### Sraitheadh - Is féidir leat sonraí a dhísherialú anois ag baint úsáide as eochracha nádúrtha ina bhfuil: ref: tagairtí ar aghaidh \`trí \`handle\_forward\_references=true\`\ a chur chuig serializers.deserialize () . Ina theannta sin, láimhseálann :djadmin: loaddata tagairtí ar aghaidh go huathoibríoch. #### Tástálacha - Seiceálann an dearbhú nua:meth: .simpletestCase.asserturleQual ar URL ar leith, ag neamhaird d'ordú an teaghrán fiosrúcháin. :meth: ~.SimpleTestCase.AssertDirects úsáideann an dearbhú nua. - Tacaíonn an tástála:class: ~.django.test.client anois le sraitheadh JSON uathoibríoch ar liosta agus tuple `sona` nuair a bhíonn `content_type = 'application/json'`. - Ceadaíonn an socrú bunachar sonraí tástála nua:setting: ORACLE\_MANAGED\_FILES \\`spásanna tábla Comhaid Bainistithe Oracle (OMF) a úsáid. - Déantar srianta bunachar sonraí inathraithe a sheiceáil anois ag deireadh na tástála gach ceach:class: ~django.test.testcase ar SQLite 3.20+, díreach cosúil le cúltaca eile a thacaíonn le srianta in-iarchurraithe. Ní chuirtear na seiceálacha seo i bhfeidhm le haghaidh leaganacha níos sine de SQLite toisc go mbeadh ionstraim tábla daor ag teastáil uathu ansin. - \:class: ~django.test.runner.DiscoverRunner scipeann anois socrú na mbunachair sonraí not:ref: tagraítear le tástálacha . #### URLanna - Stórálann an tréith nua:attr: .resolvermatch.route bealach an phatrún meaitseála URL. #### Bailíochtóirí - [`MaxValueValidator`](/ga/6.0/ref/validators/#django.core.validators.MaxValueValidator), [`MinValueValidator`](/ga/6.0/ref/validators/#django.core.validators.MinValueValidator), [`MinLengthValidator`](/ga/6.0/ref/validators/#django.core.validators.MinLengthValidator), and [`MaxLengthValidator`](/ga/6.0/ref/validators/#django.core.validators.MaxLengthValidator) now accept a callable `limit_value`. ## Athruithe neamh-chomhoiriúnacha ar ais i 2.2 ### API cúltaca bunachar sonraí Déanann an rannán seo cur síos ar athruithe a d’fhéadfadh a bheith ag teastáil ar dhroim bhunachar sonraí tríú páirtí. - Caithfidh cúltaca bunachar sonraí tríú páirtí tacaíocht a chur i bhfeidhm le haghaidh srianta seiceála tábla nó `DatabaseFeatures.supports_table_check_restricints` a shocrú go `False`. - Caithfidh cúltaca bunachar sonraí tríú páirtí tacaíocht a chur i bhfeidhm chun neamhaird a dhéanamh ar srianta nó earráidí uathúlachta agus iad ag cur `databaseFeatures.supports_ignore_conflicts` isteach nó a shocrú go False\`. - Caithfidh cúltaca bunachar sonraí tríú páirtí ionspéireacht a chur i bhfeidhm do DurationField\` nó `databaseFeatures.can_introspect_duration_field` a shocrú go `False`. - Tá `DatabaseFeatures.Ues_SavePoints` réamhshocraithe anois go `True`. - Caithfidh cúltaca bunachar sonraí tríú páirtí tacaíocht d'innéacsanna páirteach a chur i bhfeidhm nó `DatabaseFeatures.supports_Partial_indexes` a shocrú go False\`. - Baintear ```databaseintrospection.table_name_converter () ``agus ``column_name_converter ()```. B'fhéidir go mbeidh ar chúltaca bunachar sonraí tríú páirtí `DatabaseIntrospection.Identifier_Converter ()` a chur i bhfeidhm ina ionad sin. Sa chás sin, ní mór na hainmneacha srianta a thugann `DatabaseIntrospection.get_Constraints ()` a normalú le identificfier\_converter () . - Bogtar giniúint SQL le haghaidh innéacsanna ó:class: ~django.db.models.index go `SchemaEditor` agus cuirtear na modhanna `SchemaEditor` seo leis: - ```_create_primary_key_sql () ``agus ``_delete_primary_key_sql ()``` - ```_delete_index_sql () ``(le péireáil le ``_create_index_sql ()```) - `_delete_unique_sql` (le péireáil le \_create\_unique\_sql () ) - ```_delete_fk_sql () ``(le péireáil le ``_create_fk_sql ()```) - ```_create_check_sql () ``agus ``_delete_check_sql ()``` - An tríú argóint de ```DatabaseWrapper. Baintear __init__ () ``, `allow_thread_sharing```. ### Ní bhailítear gníomhartha riaracháin ó bhonn ranganna ModelAdmin\` a thuilleadh Mar shampla, i leaganacha níos sine de Django: ``` from django.contrib import admin class BaseAdmin(admin.ModelAdmin): actions = ["a"] class SubAdmin(BaseAdmin): actions = ["b"] ``` Bheadh gníomhartha `'a'` agus `` `b' `` ag `subadmin`. Anois leanann gníomhaíochtaí oidhreacht chaighdeánach Python. Chun an toradh céanna a fháil agus roimhe seo: ``` class SubAdmin(BaseAdmin): actions = BaseAdmin.actions + ["b"] ``` ### [`django.contrib.gis`](/ga/6.0/ref/contrib/gis/#module-django.contrib.gis) - Titear tacaíocht do GDAL 1.9 agus 1.10. ### TransactionTestCase luchtú sonraí sraitheach Tá imirce sonraí tosaigh luchtaithe anois in:class: ~django.test.transactionTestCase ag deireadh na tástála, tar éis an bunachar sonraí a shruthlú. I leaganacha níos sine, luchtaíodh na sonraí seo ag tús na tástála, ach cuireann sé seo cosc ar an rogha: test --keepdb oibriú i gceart (bhí an bunachar sonraí folamh ag deireadh an tsraith tástála iomlán). Níor chóir go mbeadh tionchar ag an athrú seo ar do thástálacha mura bhfuil inmheánacha: class: ~django.test.transactionTestCase saincheaptha agat. ### Tá spleáchas ag teastáil `sqlparse` \Chun cúpla cuid de láimhseáil bunachar sonraí Django a shimpliú, is spleáchas riachtanach anois é: pypi: sqlparse 0.2.2+ . Tá sé suiteáilte go huathoibríoch mar aon le Django. ### Ainmneacha `cached_property` In úsáid cosúil le: ``` from django.utils.functional import cached_property class A: @cached_property def base(self): return ... alias = base ``` Ní chuirtear `alias` a chosc. Nuair is féidir an fhadhb a bhrath (Python 3.6 agus níos déanaí), ardaíonn úsáid den sórt sin anois TypeError: Ní féidir an cached\_property céanna a shannadh do dhá ainm éagsúla ('bonn' agus 'alias') . \`\` Úsáid é seo ina ionad sin: ``` import operator class A: ... alias = property(operator.attrgetter("base")) ``` ### Ceadanna le haghaidh samhlacha seachf [Permissions for proxy models](/ga/6.0/topics/auth/default/#proxy-models-permissions-topic) are now created using the content type of the proxy model rather than the content type of the concrete model. A migration will update existing permissions when you run [`migrate`](/ga/6.0/ref/django-admin/#django-admin-migrate). Sa riarachán, tá an t-athrú trédhearcach do mhúnlaí seachfhreastalaí a bhfuil an app\_label\` céanna acu lena samhail choincréite. Mar sin féin, i leaganacha níos sine, ní fhéadfadh úsáideoirí a bhfuil ceadanna acu le haghaidh samhail seachfhreastalaí len\*difriol\* `app_label` ná a mhúnla coincréite rochtain a fháil ar an tsamhail sa riarachán. Tá sé sin socraithe anois, ach b'fhéidir gur mhaith leat iniúchadh a dhéanamh ar na tascanna ceadanna do mhúnlaí seachfhreastalaí den sórt sin (`[add|view|change|scriosadh] _myproxy`) sula ndéanann tú uasghrádú chun a chinntiú go bhfuil an rochtain nua oiriúnach. Faoi dheireadh, ní mór teaghráin cead samhail seachfhreastalaí a nuashonrú chun a `app_label` féin a úsáid. Mar shampla, le haghaidh `App.MyProxyModel` a fhaigheann oidhreacht ó `Other_App.ConcreteModel`, nuashonraigh ```user.has_perm ('other_app.add_myproxymodel') ``go `user.has_perm ('app.add_myproxymodel')```. ### Sócmhainní foirm Meáin a chumasc Déantar sócmhainní foirm Meáin a chumasc anois ag baint úsáide as algartam sórtála topolaíoch, toisc nach leor an sean-algartam cumaisc péire do roinnt cásanna. Féadfar comhaid CSS agus JavaScript nach n-áirítear a spleáchas a shórtáil go mícheart anois (nuair a tháirg an sean-algartam torthaí i gceart trí chomhtharlú). Déan iniúchadh ar gach rang ``` `Meáin ``le haghaidh aon spleáchais atá in easnamh. Mar shampla, ní mór giuirléidí ag brath ar ``django.jquery ``` js= \['admin/js/jquery.init.js',...\] a shonrú nuai:ref: foirm sócmhainní meán a dhearbhú . ### Ilghnéitheach - Chun inléiteacht a fheabhsú, taispeánann an réimse foirm `UUIDField` luachanna le daingíní anois, m.sh. `550e8400-e29b-41d4-a716-446655440000` in ionad `550e8400e29b41d4a716446655440000`. - Ar SQLite, cuimsíonn `PositiveIntegerField` agus `PositiveSmallIntegerField` srian seiceála anois chun luachanna diúltacha sa bhunachar sonraí a chosc. Má tá sonraí neamhbhailí ann cheana agat agus má reáchtáil imirce a athchruthaíonn tábla, feicfidh tú Thaipeadh srian SEICEÁIL . - Le haghaidh comhsheasmhachta le freastalaithe WSGI, socraíonn an cliant tástála an ceannteideal Content-Length\` anois go sreang seachas sláimhir. - Níl luach tuairisceáin de:func: django.utils.text.slugify marcáilte a thuilleadh mar HTML sábháilte. - Is é an carachtar truncation réamhshocraithe a úsáideann na:tfilter: urlizetrunc, :tfilter: truncatechars, :tfilter: truncatechars\_html, :tfilter: truncatewords, agus:tfilter: truncatewords\_html scagairí an fíor-charachtar ellipsis anois (`...`) in ionad 3 ponc. B'fhéidir go mbeidh ort roinnt comparáidí aschur tástála a oiriúnú. - Baintear tacaíocht do chosáin bytestring sa lódóir córas comhaid teimpléad. - [`django.utils.http.urlsafe_base64_encode()`](/ga/6.0/ref/utils/#django.utils.http.urlsafe_base64_encode) now returns a string instead of a bytestring, and [`django.utils.http.urlsafe_base64_decode()`](/ga/6.0/ref/utils/#django.utils.http.urlsafe_base64_decode) may no longer be passed a bytestring. - Baintear tacaíocht do CX\_Oracle \< 6.0. - Méadaítear an leagan íosta tacaithe de mysqlclient\` ó 1.3.7 go 1.3.13. - Méadaítear an leagan íosta tacaithe de SQLite ó 3.7.15 go 3.8.3. - In iarracht níos mó sonraí fiosrúcháin shéimeantacha a sholáthar, tugann `NullBooleanSelect` anois luachanna ``` ``neamhfhiosna ```, true\`, agus `bréag` in ionad `` `1