Déanann an treoir ábhair seo cur síos ar thacaíocht Django chun idirghníomhú le bunachair Glacann an chuid is mó den chuid eile de dhoiciméadú Django go bhfuil tú ag idirghníomhú le bunachar sonraí amháin. Más mian leat idirghníomhú le bunachair sonraí iolracha, beidh ort roinnt céimeanna breise a ghlacadh.
\n\nIs é an chéad chéim chun níos mó ná bunachar sonraí amháin a úsáid le Django ná insint do Django faoi na freastalaithe bunachar sonraí a bheidh á úsáid agat. Déantar é seo ag baint úsáide as an socrú:setting: DATABASES. Déanann an socrú seo mapáil ainmneacha bunachar sonraí, ar bealach iad chun tagairt a dhéanamh do bhunachar sonraí ar leith ar fud Django, chuig foclóir socruithe don nasc sonrach sin. Déantar cur síos iomlán ar na socruithe sna foclóirí istigh sa doiciméadach:setting: DATABASES.
\nIs féidir le bunachair sonraí aon ainm a roghnaíonn tú a bheith Mar sin féin, tá tábhacht speisialta ag an alias default. Úsáideann Django an bunachar sonraí leis an alias de default nuair nach roghnaíodh aon bhunachar sonraí eile.
Seo a leanas sampla settings.py snippet a shainmhíníonn dhá bhunachar sonraí - bunachar sonraí réamhshocraithe PostgreSQL agus bunachar sonraí MySQL ar a dtugtar users:
DATABASES = {\n "default": {\n "NAME": "app_data",\n "ENGINE": "django.db.backends.postgresql",\n "USER": "postgres_user",\n "PASSWORD": "s3krit",\n },\n "users": {\n "NAME": "user_data",\n "ENGINE": "django.db.backends.mysql",\n "USER": "mysql_user",\n "PASSWORD": "priv4te",\n },\n}\nMura bhfuil ciall ag coincheap bunachar sonraí réamhshocraithe` i gcomhthéacs do thionscadail, ní mór duit a bheith cúramach an bunachar sonraí a theastaíonn uait a úsáid a shonrú i gcónaí. Éilíonn Django go ndéanfar iontráil bunachar sonraí default` a shainiú, ach is féidir foclóir na paraiméadair a fhágáil bán mura n-úsáidfear é. Chun seo a dhéanamh, ní mór duit:setting: `DATABASE_ROUTERS` a chur ar bun do mhúnlaí uile d'aipeanna, lena n-áirítear iad siúd in aon aipeanna contrib agus tríú páirtí atá á úsáid agat, ionas nach ndéanfar aon cheisteanna a atreorú chuig an mbunachar sonraí réamhshocraithe. Seo a leanas sampla ``settings.py snippet a shainmhíníonn dhá bhunachar sonraí neamh-réamhshocraithe, agus an iontráil default fágtha folamh d'aon ghnó:
DATABASES = {\n "default": {},\n "users": {\n "NAME": "user_data",\n "ENGINE": "django.db.backends.mysql",\n "USER": "mysql_user",\n "PASSWORD": "superS3cret",\n },\n "customers": {\n "NAME": "customer_data",\n "ENGINE": "django.db.backends.mysql",\n "USER": "mysql_cust",\n "PASSWORD": "veryPriv@ate",\n },\n}\nMá dhéanann tú iarracht rochtain a fháil ar bhunachar sonraí nach bhfuil sainmhínithe agat i do shuíomh: DATABASES, ardóidh Django eisceacht ``Django.Utils.CONNECTION.CONNECTIONDOESNOTEXIST ``.
\nFeidhmíonn an t-ordú bainistíochta: DJADmin: imirce ar bhunachar sonraí amháin ag an am. De réir réamhshocraithe, oibríonn sé ar an mbunachar sonraí réamhshocraithe, ach tríd an rogha: `--database `a sholáthar, is féidir leat a rá dó bunachar sonraí difriúil a <migrate --database>shioncronú. Mar sin, chun gach samhail a shioncronú ar gach bunachar sonraí sa chéad shampla thuas, bheadh ort glaoch ar:
$ ./manage.py migrate\n$ ./manage.py migrate --database=users\nMura dteastaíonn uait go ndéanfaí gach feidhmchlár a shioncronú le bunachar sonraí áirithe, is féidir leat a: ref: `ródaire bunachar sonraí <topics-db-multi-db-routing>`a shainiú a chuireann beartas i bhfeidhm ag cur srian ar infhaighteacht samhlacha áirithe.
\nMá d'fhág tú, mar atá sa dara sampla thuas, an bunachar sonraí default folamh, ní mór duit ainm bunachar sonraí a sholáthar gach uair a rith tú: djadmin: migrate. Trí ainm an bhunachar sonraí a fhágáil, d'ardódh earráid. Maidir leis an dara sampla:
$ ./manage.py migrate --database=users\n$ ./manage.py migrate --database=customers\nOibríonn an chuid is mó d'orduithe django-admin ``eile a idirghníomhaíonn leis an mbunachar sonraí ar an mbealach céanna le: djadmin: `migrate` - ní oibríonn siad riamh ar bhunachar sonraí amháin ag an am, ag baint úsáide as ``- bunachar sonraí chun an bunachar sonraí a úsáidtear a rialú.
Eisceacht ón riail seo is ea an t-ordú:djadmin: makemigrations. Bailíonn sé stair na himirce sna bunachair sonraí chun fadhbanna a ghabháil leis na comhaid imirce atá ann cheana féin (a d'fhéadfadh a bheith mar thoradh orthu a chur in eagar) sula gcruthaítear imirce nua. <topics-db-multi-db-routing>De réir réamhshocraithe, ní sheiceálann sé ach an bunachar sonraí ``default`, ach déanann sé dul i gcomhairle leis an modh:meth: allow_migrate de:ref: ródair má tá aon cheann suiteáilte.
\nIs é an bealach is éasca le bunachair sonraí iolracha a úsáid ná scéim ródaithe bunachar sonraí a bhunú. Cinntíonn an scéim ródaithe réamhshocraithe go bhfanann rudaí 'greamaitheach' lena mbunachar sonraí bunaidh (ie, sábhálfar réad a aisghabhadh ón mbunachar sonraí foo' ar an mbunachar sonraí céanna). Cinntíonn an scéim ródaithe réamhshocraithe mura sonraítear bunachar sonraí, go dtagann gach ceist ar ais chuig an mbunachar sonraí `réamhshocraithe`.
\nNí gá duit aon rud a dhéanamh chun an scéim ródaithe réamhshocraithe a ghníomhachtú - cuirtear ar fáil í 'amach as an mbosca' ar gach tionscadal Django. Mar sin féin, más mian leat iompraíochtaí leithdháileadh bunachar sonraí níos spéisiúla a chur i bhfeidhm, is féidir leat do ródairí bunachar sonraí féin a shainiú agus
\nIs rang é Ródaire bunachar sonraí a sholáthraíonn suas le ceithre mhodh:
\nMoltar an bunachar sonraí ba chóir a úsáid le haghaidh oibríochtaí léitheoireachta le haghaidh rudaí de chineál ``samhail`.
\nMá tá oibríocht bunachar sonraí in ann aon fhaisnéis bhreise a sholáthar a d'fhéadfadh cabhrú le bunachar sonraí a roghnú, cuirfear ar fáil sa bhfoclóir ``leideanna ``. <topics-db-multi-db-hints>Cuirtear sonraí ar leideanna bailí ar fáil: ref: `thíos `.
\nTugann sé ar ais None mura bhfuil aon mholadh ann.
Moltar an bunachar sonraí ba chóir a úsáid le haghaidh scríobh rudaí de chineál Samhail.
\nMá tá oibríocht bunachar sonraí in ann aon fhaisnéis bhreise a sholáthar a d'fhéadfadh cabhrú le bunachar sonraí a roghnú, cuirfear ar fáil sa bhfoclóir ``leideanna ``. <topics-db-multi-db-hints>Cuirtear sonraí ar leideanna bailí ar fáil: ref: `thíos `.
\nTugann sé ar ais None mura bhfuil aon mholadh ann.
Tabhair ar ais True má chóir gaol idir obj1 agus obj2` a cheadú, Fal má chóir an gaol a chosc, nó None mura bhfuil aon tuairim ag an ródaire. Is oibríocht bailíochtaithe amháin é seo, a úsáidtear ag eochair eachtrach agus go leor oibríochtaí chun a chinneadh an cheart caidreamh a cheadú idir dhá réad.
Mura bhfuil tuairim ag aon ródaire (ie filleann gach ródaire ``None ``), ní cheadaítear ach caidreamh laistigh den bhunachar sonraí céanna.
\nFaigh amach an gceadaítear don oibríocht imirce a reáchtáil ar an mbunachar sonraí le alias db. Fill ar ais True más chóir go rithfeadh an oibríocht, False mura chóir dó rith, nó None mura bhfuil aon tuairim ag an ródaire.
Is é an argóint seasaimh app_label` lipéad an fheidhmchláir atá á imirce.
\nSocraítear model_name ag an gcuid is mó d'oibríochtaí imirce go luach samhail. _meta.model_name (an leagan íseal den tsamhail __name__) den tsamhail atá á imirce. Is é a luach None d'oibríochtaí: ~django.db.migrations.operations.runpython agus:class: ~django.db.migrations.operations.runsql mura soláthraíonn siad é ag baint úsáide as leideanna.
Úsáideann oibríochtaí áirithe ``leideanna ``chun faisnéis bhreise a chur in iúl don ródaire.
\nNuair a shocraítear model_name, is gnách go mbíonn hints an rang samhail faoin eochair `samhail. Tabhair faoi deara go bhféadfadh sé a: ref: samhail stairiúil <historical-models>, agus dá bhrí sin nach bhfuil aon tréithe, modhanna nó bainisteoirí saincheaptha aige. Níor chóir duit brath ach ar _meta.
Is féidir an modh seo a úsáid freisin chun infhaighteacht samhail ar bhunachar sonraí ar leith a chinneadh.
\nmakemigrations always creates migrations for model changes, but\nif allow_migrate() returns False, any migration operations for the\nmodel_name will be silently skipped when running migrate on\nthe db. Changing the behavior of allow_migrate() for models that\nalready have migrations may result in broken foreign keys, extra tables,\nor missing tables. When makemigrations verifies the migration\nhistory, it skips databases where no app is allowed to migrate.
Ní gá do ródaire na modhanna seo uach* a sholáthar - féadfaidh sé ceann amháin nó níos mó acu a fhágáil. Má fhágtar ceann de na modhanna, scipeánfaidh Django an ródaire sin agus an seiceáil ábhartha á ndéanamh agat.
\nIs féidir na leideanna a fhaigheann an ródaire bunachar sonraí a úsáid chun cinneadh a dhéanamh cén bunachar sonraí ba chóir iarratas ar leith a fháil.
\nAt present, the only hint that will be provided is instance, an\nobject instance that is related to the read or write operation that is\nunderway. This might be the instance that is being saved, or it might\nbe an instance that is being added in a many-to-many relation. In some\ncases, no instance hint will be provided at all. The router checks for\nthe existence of an instance hint, and determines if that hint should be\nused to alter routing behavior.
If an instance hint is present, the database from which it was fetched\nis recorded on its instance._state.db.\nRouters will need to first consult that attribute before falling back to any\nfixed alias to match Django's default behavior of fetching related instances\nfrom the same database.
Suiteáiltear ródairí bunachar sonraí ag baint úsáide as an socrú: setting: DATABASE_ROUTERS. Sainmhíníonn an socrú seo liosta d'ainmneacha ranga, gach ceann acu ag sonrú ródaire ar chóir an bunródaire a úsáid (django.db.router).
Úsáideann oibríochtaí bunachar sonraí Django an ródaire bunachar sonraí chun úsáid bunachar sonraí a leithdháileadh. Aon uair a chaithfidh fiosrúchán a fháil amach cén bunachar sonraí atá le húsáid, glaonn sé ar an ródaire bonn, ag soláthar samhail agus leid (má tá sé ar fáil). Déanann an bunródaire iarracht gach rang ródaire ina dhiaidh sin go dtí go bhfilleann duine moladh bunachar sonraí. Mura dtugann aon ródairí moladh ar ais, déanann an ródaire bonn iarracht an reatha: attr: instance. _state.db <django.db.models.Model._state>`den chás leideanna. Mura soláthraíodh aon sampla leideanna, nó:attr: `instance. Is é _state.db <django.db.models.Model._state>```None `, leithdháileoidh an bunródaire an bunachar sonraí réamhshocraithe.
Mar sin - cad a chiallaíonn sé seo i gcleachtas? Déanaimis smaoineamh ar chumraíocht samplach eile. Beidh roinnt bunachar sonraí ag an gceann seo: ceann don fheidhmchlár ``auth`, agus gach aip eile ag baint úsáide as socrú bunscoil/macasamhail le dhá mhacasamhail léite. Seo na socruithe a shonraíonn na bunachair sonraí seo:
\nDATABASES = {\n "default": {},\n "auth_db": {\n "NAME": "auth_db_name",\n "ENGINE": "django.db.backends.mysql",\n "USER": "mysql_user",\n "PASSWORD": "swordfish",\n },\n "primary": {\n "NAME": "primary_name",\n "ENGINE": "django.db.backends.mysql",\n "USER": "mysql_user",\n "PASSWORD": "spam",\n },\n "replica1": {\n "NAME": "replica1_name",\n "ENGINE": "django.db.backends.mysql",\n "USER": "mysql_user",\n "PASSWORD": "eggs",\n },\n "replica2": {\n "NAME": "replica2_name",\n "ENGINE": "django.db.backends.mysql",\n "USER": "mysql_user",\n "PASSWORD": "bacon",\n },\n}\nAnois beidh orainn ródú a láimhseáil. Ar dtús ba mhaith linn ródaire a bhfuil a fhios aige ceisteanna a sheoladh do na feidhmchláir auth` agus contenttypes` chuig auth_db` (tá samhlacha auth` nasctha le contentType`, mar sin caithfear iad a stóráil sa bhunachar sonraí céanna):
\nclass AuthRouter:\n """\n A router to control all database operations on models in the\n auth and contenttypes applications.\n """\n\n route_app_labels = {"auth", "contenttypes"}\n\n def db_for_read(self, model, **hints):\n """\n Attempts to read auth and contenttypes models go to auth_db.\n """\n if model._meta.app_label in self.route_app_labels:\n return "auth_db"\n return None\n\n def db_for_write(self, model, **hints):\n """\n Attempts to write auth and contenttypes models go to auth_db.\n """\n if model._meta.app_label in self.route_app_labels:\n return "auth_db"\n return None\n\n def allow_relation(self, obj1, obj2, **hints):\n """\n Allow relations if a model in the auth or contenttypes apps is\n involved.\n """\n if (\n obj1._meta.app_label in self.route_app_labels\n or obj2._meta.app_label in self.route_app_labels\n ):\n return True\n return None\n\n def allow_migrate(self, db, app_label, model_name=None, **hints):\n """\n Make sure the auth and contenttypes apps only appear in the\n 'auth_db' database.\n """\n if app_label in self.route_app_labels:\n return db == "auth_db"\n return None\nAgus theastaíonn ródaire uainn freisin a sheolann gach aip eile chuig an gcumraíocht bunscoil/macasamhail, agus a roghnaíonn macasamhail go randamach le léamh as:
\nimport random\n\n\nclass PrimaryReplicaRouter:\n def db_for_read(self, model, **hints):\n """\n Reads go to a randomly-chosen replica.\n """\n return random.choice(["replica1", "replica2"])\n\n def db_for_write(self, model, **hints):\n """\n Writes always go to primary.\n """\n return "primary"\n\n def allow_relation(self, obj1, obj2, **hints):\n """\n Relations between objects are allowed if both objects are\n in the primary/replica pool.\n """\n db_set = {"primary", "replica1", "replica2"}\n if obj1._state.db in db_set and obj2._state.db in db_set:\n return True\n return None\n\n def allow_migrate(self, db, app_label, model_name=None, **hints):\n """\n All non-auth models end up in this pool.\n """\n return True\nFaoi dheireadh, sa chomhad socruithe, cuirimid an méid seo a leanas leis (ag cur path.to.` in ionad an cosán Python iarbhír chuig an modúl (í) ina bhfuil na ródairí sainmhínithe):
\nDATABASE_ROUTERS = ["path.to.AuthRouter", "path.to.PrimaryReplicaRouter"]\nTá an t-ord ina ndéantar ródairí a phróiseáil suntasach. Cuirfear ceist ar ródairí san ord atá siad liostaithe sa socrú: SETTING: DATABASE_ROUTERS. Sa sampla seo, déantar an Authrough ``a phróiseáil roimh an ``PrimaryRepliCarouter`, agus mar thoradh air sin, déantar cinntí a bhaineann leis na samhlacha in auth a phróiseáil sula ndéantar aon chinneadh eile. Má liostaíodh an socrú:setting: DATABASE_ROUTERS an dá ródaire san ord eile, bheadh `primaryReplicaRouter.ALLOW_MIGRATE () ``a phróiseáil ar dtús. Ciallaíonn nádúr uile an chur i bhfeidhm PrimaryReplicaOuter go mbeadh na samhlacha go léir ar fáil ar gach bunachar sonraí.
\nWith this setup installed, and all databases migrated as per\nSioncrónú do bhunachar sonraí, let's run some Django code:
\n>>> # This retrieval will be performed on the 'auth_db' database\n>>> fred = User.objects.get(username="fred")\n>>> fred.first_name = "Frederick"\n\n>>> # This save will also be directed to 'auth_db'\n>>> fred.save()\n\n>>> # These retrieval will be randomly allocated to a replica database\n>>> dna = Person.objects.get(name="Douglas Adams")\n\n>>> # A new object has no database allocation when created\n>>> mh = Book(title="Mostly Harmless")\n\n>>> # This assignment will consult the router, and set mh onto\n>>> # the same database as the author object\n>>> mh.author = dna\n\n>>> # This save will force the 'mh' instance onto the primary database...\n>>> mh.save()\n\n>>> # ... but if we re-retrieve the object, it will come back on a replica\n>>> mh = Book.objects.get(title="Mostly Harmless")\nSainmhínigh an sampla seo ródaire chun idirghníomhaíocht a láimhseáil le samhlacha ón aip auth, agus ródairí eile chun idirghníomhú le gach aip eile a láimhseáil. Má d'fhág tú do bhunachar sonraí default folamh agus mura dteastaíonn uait ródaire bunachar sonraí catch-all a shainiú chun gach aip nach sonraítear ar mhalairt a láimhseáil, ní mór do ródairí ainmneacha gach aip a láimhseáil in:setting: INSTALLED_APPS sula ndéanann tú imirce. Féach:ref: contrib_app_multiple_databases le haghaidh faisnéise faoi apps contrib nach mór a bheith le chéile i mbunachar sonraí amháin.
Soláthraíonn Django API freisin a ligeann duit smacht iomlán a choinneáil ar úsáid bunachar sonraí i do chód. Glacfaidh leithdháileadh bunachar sonraí sonraithe de láimh tosaíocht ar bhunachar sonraí a leithdháiltear
\nQuerySetLink to this heading#Is féidir leat an bunachar sonraí do QuerySet` a roghnú ag pointe ar bith sa slabhra QuerySet. Glaoigh ar using () ``ar an `QuerySet chun QuerySet eile a fháil a úsáideann an bunachar sonraí sonraithe.
Tógann ``using () ``argóint amháin: ainm an bhunachar sonraí ar mhaith leat an cheist a reáchtáil. Mar shampla:
\n>>> # This will run on the 'default' database.\n>>> Author.objects.all()\n\n>>> # So will this.\n>>> Author.objects.using("default")\n\n>>> # This will run on the 'other' database.\n>>> Author.objects.using("other")\nÚsáid an eochairfhocal using le `Model.save () ``chun a shonrú ar cén bunachar sonraí ba chóir na sonraí a shábháil.
Mar shampla, chun réad a shábháil chuig an mbunachar sonraí legacy_users, d'úsáideann tú seo:
\n>>> my_object.save(using="legacy_users")\nMura sonraíonn tú úsáid ``, sábhálfaidh an modh ``save () isteach sa bhunachar sonraí réamhshocraithe arna leithdháileadh ag na ródairí.
Má shábháil tú sampla chuig bunachar sonraí amháin, b'fhéidir go mbeadh sé mealltach ``save (using =...) ``a úsáid mar bhealach chun an sampla a aistriú chuig bunachar sonraí nua. Mar sin féin, mura nglacann tú céimeanna iomchuí, d'fhéadfadh roinnt iarmhairtí gan choinne a bheith aige seo.
\nSmaoinigh ar an sampla seo a leanas:
\n>>> p = Person(name="Fred")\n>>> p.save(using="first") # (statement 1)\n>>> p.save(using="second") # (statement 2)\nI ráiteas 1, sábhálfar réad nua `Person chuig an mbunachar sonraí chéad. Ag an am seo, níl eochair phríomhúil ag p`, mar sin eisíonn Django ráiteas INSERT SQL. Cruthaíonn sé seo eochair phríomhúil, agus sannann Django an príomh-eochair sin do p`.
Nuair a tharlaíonn an sábháil i ráiteas 2, tá príomhluach ag p` cheana féin, agus déanfaidh Django iarracht an eochair phríomhúil sin a úsáid ar an mbunachar sonraí nua. Mura bhfuil an príomhluach in úsáid sa bhunachar sonraí ``dara ``, ansin ní bheidh aon fhadhbanna agat - cóipeálfar an réad chuig an mbunachar sonraí nua.
\nMar sin féin, má tá príomh-eochair p` in úsáid cheana féin ar an mbunachar sonraí dara ``, cuirfear an réad atá ann cheana sa bhunachar sonraí ``soicin` nuair a shábháiltear `p.
Is féidir leat é seo a sheachaint ar dhá bhealach. Ar dtús, is féidir leat eochair phríomhúil an cháis a ghlanadh. Mura bhfuil aon phríomh-eochair ag réad, déileálfaidh Django leis mar réad nua, ag seachaint aon chaillteanas sonraí ar an mbunachar sonraí ``dara ``:
\n>>> p = Person(name="Fred")\n>>> p.save(using="first")\n>>> p.pk = None # Clear the primary key.\n>>> p.save(using="second") # Write a completely new object.\nIs é an dara rogha ná an rogha force_insert a úsáid chun save () ``chun a chinntiú go ndéanann Django SQL ``INSERT:
>>> p = Person(name="Fred")\n>>> p.save(using="first")\n>>> p.save(using="second", force_insert=True)\nCinnteoidh sé seo go mbeidh an príomh-eochair chéanna ag an duine darb ainm ``Fred` ar an dá bhunachar sonraí. Má tá an príomh-eochair sin in úsáid cheana féin nuair a dhéanann tú iarracht sábháil ar an mbunachar sonraí ``dara ``, ardófar earráid.
\nDe réir réamhshocraithe, cuirfear glao chun réad atá ann cheana a scriosadh ar an mbunachar sonraí céanna a úsáideadh chun an réad a aisghabháil sa chéad áit:
\n>>> u = User.objects.using("legacy_users").get(username="fred")\n>>> u.delete() # will delete from the `legacy_users` database\nChun an bunachar sonraí as a scriosfar samhail a shonrú, cuir argóint eochairfhocal úsáid ``chuig an modh ``Model.delete (). Oibríonn an argóint seo díreach cosúil leis an argóint eochairfhocal `úsáid ``chun `save ().
Mar shampla, má tá tú ag aistriú úsáideora ón mbunachar sonraí legacy_users chuig an mbunachar sonraí ``new_users`, d'fhéadfá na horduithe seo a úsáid:
\n>>> user_obj.save(using="new_users")\n>>> user_obj.delete(using="legacy_users")\nÚsáid an modh `db_manager () `ar bhainisteoirí chun rochtain a thabhairt do bhainisteoirí ar bhunachar sonraí neamh-réamhshocraithe.
\nMar shampla, abair go bhfuil modh bainisteora saincheaptha agat a théann i dteagmháil leis an mbunachar sonraí - User.Objects.create_user () ``. Toisc gur modh bainisteora é `create_user () ``, ní modh ``QuerySet, ní féidir leat User.Objects.using ('new_users') .create_user () a dhéanamh. (Níl an modh create_user () `ar fáil ach ar ``User.Objects`, an bainisteoir, ní ar rudaí ``QuerySet` a dhíorthaítear ón mbainisteoir.) Is é an réiteach ná ``db_manager () ``a úsáid, mar seo:
User.objects.db_manager("new_users").create_user(...)\nFilleann ``db_manager () ``cóip den bhainisteoir atá ceangailte leis an mbunachar sonraí a shonraíonn tú.
\nMá tá tú ag cur get_queryset () ``ar do bhainisteoir, déan cinnte glaoch ar an modh ar an tuismitheoir (ag baint úsáide as ``super ()) nó déan láimhseáil chuí an tréith _db ar an mbainisteoir (sreang ina bhfuil ainm an bhunachar sonraí le húsáid).
Mar shampla, más mian leat rang saincheaptha QuerySet a thabhairt ar ais ón modh get_queryset, d'fhéadfá seo a dhéanamh:
class MyManager(models.Manager):\n def get_queryset(self):\n qs = CustomQuerySet(self.model)\n if self._db is not None:\n qs = qs.using(self._db)\n return qs\nNíl aon tacaíocht shoiléir ag riarachán Django do iliomad bunachair sonraí. Más mian leat comhéadan riaracháin a sholáthar do mhúnla ar bhunachar sonraí seachas an ceann a shonraíonn do slabhra ródaire, beidh ort ranganna saincheap:class: ~django.contrib.admin.modelAdmin a scríobh a threoróidh an riarachán bunachar sonraí sonrach a úsáid le haghaidh ábhar.
\nTá na modhanna seo a leanas ag rudaí ModelAdmin a éilíonn saincheaptha le haghaidh tacaíochta ilbhunachar sonraí:
\nclass MultiDBModelAdmin(admin.ModelAdmin):\n # A handy constant for the name of the alternate database.\n using = "other"\n\n def save_model(self, request, obj, form, change):\n # Tell Django to save objects to the 'other' database.\n obj.save(using=self.using)\n\n def delete_model(self, request, obj):\n # Tell Django to delete objects from the 'other' database\n obj.delete(using=self.using)\n\n def get_queryset(self, request):\n # Tell Django to look for objects on the 'other' database.\n return super().get_queryset(request).using(self.using)\n\n def formfield_for_foreignkey(self, db_field, request, **kwargs):\n # Tell Django to populate ForeignKey widgets using a query\n # on the 'other' database.\n return super().formfield_for_foreignkey(\n db_field, request, using=self.using, **kwargs\n )\n\n def formfield_for_manytomany(self, db_field, request, **kwargs):\n # Tell Django to populate ManyToMany widgets using a query\n # on the 'other' database.\n return super().formfield_for_manytomany(\n db_field, request, using=self.using, **kwargs\n )\nCuireann an cur i bhfeidhm a chuirtear ar fáil anseo straitéis ilbhunachar sonraí i bhfeidhm ina ndéantar gach rud de chineál ar leith a stóráil ar bhunachar sonraí ar leith (m.sh., tá gach rud Úsáideora ``sa bhunachar sonraí ``eile). Má tá do úsáid a bhaineann le bunachair sonraí iolracha níos casta, beidh ar do ModelAdmin` an straitéis sin a léiriú.
InlineModelAdmin objects can be handled in a\nsimilar fashion. They require three customized methods:
class MultiDBTabularInline(admin.TabularInline):\n using = "other"\n\n def get_queryset(self, request):\n # Tell Django to look for inline objects on the 'other' database.\n return super().get_queryset(request).using(self.using)\n\n def formfield_for_foreignkey(self, db_field, request, **kwargs):\n # Tell Django to populate ForeignKey widgets using a query\n # on the 'other' database.\n return super().formfield_for_foreignkey(\n db_field, request, using=self.using, **kwargs\n )\n\n def formfield_for_manytomany(self, db_field, request, **kwargs):\n # Tell Django to populate ManyToMany widgets using a query\n # on the 'other' database.\n return super().formfield_for_manytomany(\n db_field, request, using=self.using, **kwargs\n )\nNuair a bheidh do shainmhínithe riaracháin samhail scríofa agat, is féidir iad a chlárú le haon shampla Riarachán:
from django.contrib import admin\nfrom myapp.models import Author, Book, Publisher\n\n# Import our custom ModelAdmin and TabularInline from where they're defined.\nfrom myproject.admin import MultiDBModelAdmin, MultiDBTabularInline\n\n\n# Specialize the multi-db admin objects for use with specific models.\nclass BookInline(MultiDBTabularInline):\n model = Book\n\n\nclass PublisherAdmin(MultiDBModelAdmin):\n inlines = [BookInline]\n\n\nadmin.site.register(Author, MultiDBModelAdmin)\nadmin.site.register(Publisher, PublisherAdmin)\n\nothersite = admin.AdminSite("othersite")\nothersite.register(Publisher, MultiDBModelAdmin)\nBunaíonn an sampla seo dhá shuíomh riaracháin. Ar an gcéad láithreán, nochtar na rudaí Údar agus Foilsitheoir`; tá inlíne táblaí ag rudaí ``Foilsitheora ``a thaispeánann leabhair arna fhoilsiú ag an bhfoilsitheoir sin. Nochtann an dara suíomh ach foilsitheoirí, gan na línte.
Má tá níos mó ná bunachar sonraí amháin á úsáid agat is féidir leat django.db.connections a úsáid chun an nasc (agus an cúrsóir) a fháil le haghaidh bunachar sonraí ar leith. Is réad cosúil le foclóir é django.db.connections a ligeann duit nasc ar leith a aisghabháil ag baint úsáide as a ainm:
from django.db import connections\n\nwith connections["my_db_alias"].cursor() as cursor:\n ...\nFaoi láthair ní sholáthraíonn Django aon tacaíocht d'eochair eachtracha nó caidrimh go leor a chuimsíonn bunachair sonraí iolracha. Má d'úsáid tú ródaire chun samhlacha a dheighilt chuig bunachair sonraí éagsúla, caithfidh aon eochair eachtrach agus caidrimh go leor a shainmhíníonn na samhlacha sin a bheith inmheánach le bunachar sonraí amháin.
\nTá sé seo mar gheall ar shláine tagartha. D'fhonn caidreamh idir dhá réad a choinneáil, ní mór go mbeadh a fhios ag Django go bhfuil príomh-eochair an réada gaolmhara bailí. Má stóráiltear an príomh-eochair ar bhunachar sonraí ar leithligh, ní féidir bailíocht eochair phríomhúil a mheas go héasca.
\nMá tá Postgres, SQLite, Oracle, nó MySQL á úsáid agat le InnoDB, cuirtear é seo i bhfeidhm ag leibhéal sláine an bhunachar sonraí - cosc ar phríomhshrianta ar leibhéal bunachar sonraí caidrimh nach féidir a bhailíochtú a chruthú.
\nMar sin féin, má tá MySQL á úsáid agat le táblaí MyISAM, níl aon sláine tagartha forfheidhmithe ann; mar thoradh air sin, b'fhéidir go mbeidh tú in ann eochracha eachtracha trasbhunachar sonraí 'bréige' a dhéanamh. Mar sin féin, ní thacaíonn Django leis an gcumraíocht seo go hoifigiúil.
\nCuimsíonn roinnt aipeanna contrib samhlacha, agus braitheann roinnt aipeanna ar dhaoine eile. Ós rud é go bhfuil caidrimh tras-bhunachar sonraí dodhéanta, cruthaíonn sé seo roinnt srianta ar an gcaoi ar féidir leat na samhlacha seo
\nis féidir gach ceann de ContentTypes.ContentType`, Sessions.Session` agus Sites.Site a stóráil in aon bhunachar sonraí, mar gheall ar ródaire oiriúnach.
Tá samhlacha auth - Úsáideor, Grúpa` agus Cead - nasctha le chéile agus nasctha le ContentType, mar sin ní mór iad a stóráil sa bhunachar sonraí céanna le ContentType`.
Braitheann admin ``ar `auth, mar sin caithfidh a mhúnlaí a bheith sa bhunachar sonraí céanna le auth.
Braitheann flatpages agus atreoruithe ``ar `suíomhanna, mar sin caithfidh a gcuid samhlacha a bheith sa bhunachar sonraí céanna le ``suíomhanna ``.
Ina theannta sin, cruthaítear roinnt rudaí go huathoibríoch díreach tar éis: cruthaíonn migrate tábla chun iad a choinneáil i mbunachar sonraí:
\n“cineál ábhair” do gach samhail (lena n-áirítear iad siúd nach stóráiltear sa bhunachar sonraí sin),
na Ceadúna` do gach samhail (lena n-áirítear iad siúd nach stóráiltear sa bhunachar sonraí sin).
Maidir le socruithe coitianta le bunachair sonraí iolracha, níl sé úsáideach na rudaí seo a bheith i níos mó ná bunachar sonraí amháin. I measc na socruithe coitianta tá bunúsche/macasamhail agus nascadh le bunachair sonraí Dá bhrí sin, moltar a scríobh a:ref: `ródaire bunachar sonraí <topics-db-multi-db-routing>`a cheadaíonn na trí mhúnla seo a shioncrónú le bunachar sonraí amháin. Úsáid an cur chuige céanna le haghaidh aipeanna contrib agus tríú páirtí nach dteastaíonn a dtáblaí uathu i iliomad bunachar
\n\n