Kaj je ORM? Kako aplikacije komunicirajo z bazami, pojasnjeno

ORM (objektno-relacijski preslikovalnik) je programska knjižnica, ki stoji med aplikacijo in relacijsko bazo. Namesto da bi razvijalci pisali poizvedbe v SQL-ju, delajo s podatki kot z navadnimi objekti v svojem programskem jeziku – db.booking.create(...) ali Booking.find(...) – ORM pa to prevede v SQL, ga izvede in rezultate spet pretvori v objekte. Znani primeri so Prisma in Drizzle za TypeScript, SQLAlchemy za Python in Entity Framework Core za C#.

Zakaj so ORM-ji pomembni, ko gradite z AI

Ko graditelj aplikacij z AI v vašo aplikacijo doda bazo podatkov, običajno doda tudi ORM, ki z njo komunicira. ORM kode vam ne bo treba pisati sami, vseeno pa je koristno vedeti, da je tam:

• Vaš podatkovni model živi v kodi. Datoteka s shemo ORM-ja je pogosto najjasnejši opis podatkov vaše aplikacije: katere tabele obstajajo, katera polja ima vsaka in kako so povezane. Če jo preberete, hitro preverite, ali je AI razumel vašo aplikacijo.
• Spremembe baze gredo prek migracij. Ko zahtevate »dodaj telefonsko številko strankam«, AI posodobi model in ustvari migracijo. Če to veste, lažje razumete, zakaj mora sprememba morda biti uveljavljena, preden deluje v živo.
• Varnost privzeto. ORM-ji gradijo poizvedbe tako, da so zaščitene pred SQL injection, eno najpogostejših varnostnih lukenj v aplikacijah, ki poizvedbe sestavljajo ročno.
• Pasti zmogljivosti. ORM-ji zlahka povzročijo, da se izvede na stotine majhnih poizvedb, kjer bi zadostovala ena. To je pogost vzrok počasnih strani v aplikacijah, zgrajenih z AI.

Vsakdanja primerjava

Predstavljajte si britanskega potnika in japonskega trgovca, ki si ne delita jezika in se sporazumevata prek tolmača.

Potnik (vaša aplikacija) reče: »Rad bi tri najcenejše čaje, ki jih imate.« Tolmač (ORM) to prevede v natančno japonščino (SQL), jo poda trgovcu (bazi) in odgovor prevede nazaj v angleščino.

Potnik se ne nauči japonsko, in pri večini pogovorov je to v redu. Pri zapletenih pogajanjih pa lahko pomaga neposredno govoriti – zato večina ORM-jev razvijalcem dovoli, da po potrebi napišejo surovi SQL.

Kako deluje ORM

Baze, kot je Postgres, hranijo podatke v tabelah vrstic in stolpcev ter se poizvedujejo s SQL-om. Programski jeziki delajo z objekti: rezervacija z datumom, stranko in statusom. ORM preslika eno v drugo:

Teh štiri operacije so CRUD dejanja, na katerih temelji skoraj vsaka aplikacija.

Praktičen primer: rezervacije s Prisma

Tukaj je poenostavljena Prisma shema za aplikacijo za rezervacije v salonu. Opisuje dve tabeli in kako sta povezani:

model Customer {
  id       Int       @id @default(autoincrement())
  name     String
  email    String    @unique
  bookings Booking[]
}

model Booking {
  id         Int      @id @default(autoincrement())
  startsAt   DateTime
  service    String
  customer   Customer @relation(fields: [customerId], references: [id])
  customerId Int
}

Z drugimi besedami: stranka ima ime, enolični e-poštni naslov in več rezervacij; vsaka rezervacija ima začetni čas in storitev ter pripada eni stranki.

Zdaj aplikacija želi »prihajajoče rezervacije Lene, najprej najbližje«:

const bookings = await db.booking.findMany({
  where: {
    customer: { email: "lena@example.com" },
    startsAt: { gte: new Date() },
  },
  orderBy: { startsAt: "asc" },
});

ORM to pretvori v SQL približno takole, ga izvede in vrne seznam objektov rezervacij:

SELECT b.* FROM "Booking" b
JOIN "Customer" c ON c.id = b."customerId"
WHERE c.email = $1 AND b."startsAt" >= $2
ORDER BY b."startsAt" ASC;

$1 in $2 sta označevalca mest: e-poštni naslov in datum se pošljeta ločeno od besedila poizvedbe, kar preprečuje SQL injection.

Migracije

Če nato zahtevate »naj stranke dodajo telefonsko številko«, AI doda phone String? modelu Customer (? pomeni, da je polje neobvezno) in ustvari migracijo – majhno SQL skripto, na primer ALTER TABLE "Customer" ADD COLUMN "phone" TEXT;. Migracije se shranjujejo po vrstnem redu, zato je mogoče vsako kopijo baze pripeljati do iste strukture, zgodovina sprememb pa ostane shranjena.

Pogosti ORM-ji po jezikih

ORM-ji se razlikujejo po tem, koliko skrijejo SQL. Prisma uporablja svoj jezik za sheme in slog poizvedb; Drizzle namerno ostaja blizu oblike SQL-a, hkrati pa ohranja tipiziranje. Lažja orodja, imenovana gradniki poizvedb (query builders), kot sta Knex ali Kysely za TypeScript, pomagajo sestavljati SQL v kodi, ne da bi vrstice preslikovali v polne objekte.

Ključni pojmi

Pogoste zmote

• »ORM je baza podatkov.« Ni. Je prevajalec. Še vedno potrebujete bazo, na primer Postgres.
• »Z ORM-jem vam ni treba razumeti svojih podatkov.« Slabo zasnovane tabele so enako boleče tudi prek ORM-ja. Dober podatkovni model je pomembnejši od orodja.
• »ORM-ji so vedno počasni.« Vsakodnevne poizvedbe so v redu. Počasnost običajno izvira iz vzorcev, kot so poizvedbe N+1 ali manjkajoči indeksi, ki jih je mogoče popraviti.
• »ORM pomeni, da ni nikoli tveganja SQL injection.« Standardne metode ORM-ja so varne, surov SQL, sestavljen z vstavljenim uporabniškim vnosom, pa je še vedno nevaren.
• »Urejanje datoteke sheme spremeni živo bazo.« Samo ko je migracija ustvarjena in uveljavljena v tej bazi.

Kaj vprašati svojega graditelja z AI

• »Pokaži mi shemo baze in v preprostem jeziku razloži vsako tabelo in povezavo.«
• »Kateri ORM uporablja ta projekt in kje so migracije?«
• »Preden spremeniš katerokoli tabelo, mi povej, ali bodo prizadeti obstoječi podatki, in nikoli ne briši stolpca s podatki brez vprašanja.«
• »Preveri najpočasnejše strani za poizvedbe N+1 in dodaj indekse tam, kjer so seznami filtrirani ali razvrščeni.«
• »Poskrbi, da vsaka poizvedba, ki uporablja uporabniški vnos, gre prek ORM-ja ali uporablja parametre – brez SQL-ja, sestavljenega z nizi.«

ORM-ji v Mythex

Ko vaša aplikacija potrebuje shranjevanje podatkov, Mythex projektu doda namensko Postgres bazo – vprašajte v klepetu ali uporabite ukaz /database – in njene povezovalne podatke vbrizga v delovni prostor in objavljeno aplikacijo (Baza). Agent nato napiše kodo, ki bere in shranjuje vaše podatke. Če imate željo – »uporabi Prisma«, »uporabi SQLAlchemy« ali »samo SQL, brez ORM-ja« – to povejte v klepetu. Kadarkoli želite preveriti strukturo, naj vas agent vodi skozi shemo; datoteke lahko preberete v urejevalniku kode. Za širšo sliko glejte kaj je baza podatkov in SQL proti NoSQL.

Vprašanja