Fiosrúcháin SQL amh a dhéanamhLink to this heading#

Réimsí fiosrúcháin a mapáil go réimsíLink to this heading#

Léarscáil ``raw () ``réimsí san fhiosrúchán go réimsí ar an tsamhail go huathoibríoch.

Ní cuma ord na réimsí i d'fhiosrúchán. Is é sin le rá, oibríonn an dá cheist seo a leanas go comhionann:

>>> Person.objects.raw("SELECT id, first_name, last_name, birth_date FROM myapp_person")
>>> Person.objects.raw("SELECT last_name, birth_date, first_name, id FROM myapp_person")

Déantar meaitseáil de réir ainm. Ciallaíonn sé seo gur féidir leat clásail ``AS ``SQL a úsáid chun réimsí a mhapáil sna réimsí fiosrúcháin go réimsí samhlacha. Mar sin dá mbeadh tábla éigin eile agat ina raibh sonraí ``Person` ann, d'fhéadfá é a mhapáil go héasca i gcásanna ``Person`:

>>> Person.objects.raw("""
...     SELECT first AS first_name,
...            last AS last_name,
...            bd AS birth_date,
...            pk AS id,
...     FROM some_other_table
...     """)
...

Chomh fada agus a mheaitseálann na hainmneacha, cruthófar na cásanna samhail i gceart.

De rogha air sin, is féidir leat réimsí san fhiosrúchán a mhapáil chuig réimsí samhlacha ag baint úsáide as an argóint aistriúcháin ``go `raw (). Is foclóir é seo a mhapáil ainmneacha réimsí san fhiosrúchán ar ainmneacha réimsí ar an tsamhail. Mar shampla, d'fhéadfaí an cheist thuas a scríobh freisin:

>>> name_map = {"first": "first_name", "last": "last_name", "bd": "birth_date", "pk": "id"}
>>> Person.objects.raw("SELECT * FROM some_other_table", translations=name_map)

Cuardaigh innéacsLink to this heading#

Tacaíonn ``raw () ``le hinnéacsú, mar sin mura dteastaíonn ach an chéad toradh uait is féidir leat scríobh:

>>> first_person = Person.objects.raw("SELECT * FROM myapp_person")[0]

Mar sin féin, ní dhéantar an t-innéacsú agus an slisnú ag leibhéal an bhunachar sonraí. Má tá líon mór rudaí ``Person` agat i do bhunachar sonraí, tá sé níos éifeachtaí an cheist a theorannú ag an leibhéal SQL:

>>> first_person = Person.objects.raw("SELECT * FROM myapp_person LIMIT 1")[0]

Réimsí samhail a chur ar iarchurLink to this heading#

Féadfar réimsí a fhágáil amach freisin:

>>> people = Person.objects.raw("SELECT id, first_name FROM myapp_person")

Is cásanna samhail iarchurtha iad na rudaí Person a thugtar ar ais leis an gceist seo (féach: meth: `~django.db.models.query.queryset.defer () `). Ciallaíonn sé seo go luchtálfar na réimsí a fhágtar ón gceist ar éileamh. Mar shampla:

>>> for p in Person.objects.raw("SELECT id, first_name FROM myapp_person"):
...     print(
...         p.first_name,  # This will be retrieved by the original query
...         p.last_name,  # This will be retrieved on demand
...     )
...
John Smith
Jane Jones

Ó láithreacha seachtracha, is cosúil go bhfuil an chéad ainm agus an t-ainm deireanach aisghabháilte ag an gceist. Mar sin féin, d'eisigh an sampla seo 3 cheist i ndáiríre. Ní aisghabhadh ach na céadainmneacha tríd an bhfiosrúchán ``raw () ``- aisghabhadh na hainmneacha deireanacha araon ar éileamh nuair a cuireadh priontáil iad.

Níl ach réimse amháin ann nach féidir leat a fhágáil amach - an príomhréimse. Úsáideann Django an príomh-eochair chun cásanna samhail a aithint, mar sin caithfear é a áireamh i gcónaí i gceist amh. A: Class: Ardófar eisceacht ~django.core.exceptions.fieldDoesNotExist má dhéanann tú dearmad an príomh-eochair a áireamh.

Anótaí a chur leisLink to this heading#

Is féidir leat ceisteanna a fhorghníomhú ina bhfuil réimsí nach bhfuil sainmhínithe ar an tsamhail. Mar shampla, d'fhéadfaimis feidhm `aois () PostgreSQL a úsáid `__ chun liosta daoine a bhfuil a n-aoiseanna a ríomh ag an mbunachar sonraí a fháil:

>>> people = Person.objects.raw("SELECT *, age(birth_date) AS age FROM myapp_person")
>>> for p in people:
...     print("%s is %s." % (p.first_name, p.age))
...
John is 37.
Jane is 42.
...

<func-expressions>Is minic gur féidir leat SQL amh a úsáid chun anótaí a ríomh a sheachaint trí a: ref: `Func () abairt `a úsáid ina ionad sin.

Paraiméadair a chur isteach i ``raw () ``Link to this heading#

Más gá duit ceisteanna paraiméadair a dhéanamh, is féidir leat an argóint params` a úsáid chun raw () `:

>>> lname = "Doe"
>>> Person.objects.raw("SELECT * FROM myapp_person WHERE last_name = %s", [lname])

Is liosta nó foclóir paraiméadair é params'. Úsáidfidh tú áitealbhóirí ``%s` sa teaghrán fiosrúcháin le haghaidh liosta, nó % (key) s sealbhóirí áiteacha do fhoclóir (áit a gcuirtear eochair foclóra in ionad eochair), beag beann ar d'inneall bunachar sonraí. Cuirfear paraiméadair ón argóint `params' in ionad sealbhóirí áiteanna den sórt sin.

Naisc agus cúrsaíLink to this heading#

Forfheidhmíonn nasc agus cursor den chuid is mó an Python DB-API caighdeánach a thuairiscítear in:pep: 249 - ach </topics/db/transactions> amháin maidir le: doc: láimhseáil idirbhearta.

Mura bhfuil tú eolach ar an Python DB-API, tabhair faoi deara go n-úsáideann an ráiteas SQL i cursor.execute () ``sealbhóirí ionaid, `"%s"`, seachas paraiméadair a chur go díreach laistigh den SQL. Má úsáideann tú an teicníc seo, éalóidh an leabharlann bunachar sonraí bunúsach do pharaiméadair go huathoi

Tabhair faoi deara freisin go bhfuil Django ag súil leis an áitealbhóir "%s", * ní* an ``”? ``sealbhóir áit, a úsáideann na ceangail SQLite Python. Tá sé seo ar mhaithe le comhsheasmhacht agus sláine.

Cúrsóir a úsáid mar bhainisteoir comhthéacs:

with connection.cursor() as c:
    c.execute(...)

atá coibhéiseach le:

c = connection.cursor()
try:
    c.execute(...)
finally:
    c.close()