Mikä on ORM? Miten sovellukset puhuvat tietokannoille, selitettynä

ORM (object-relational mapper) on koodikirjasto, joka sijaitsee sovelluksen ja relaatiotietokannan välissä. Sen sijaan, että kehittäjät kirjoittaisivat tietokantakyselyt SQL:llä, he työskentelevät datan kanssa tavallisina olioina omalla ohjelmointikielellään – kuten db.booking.create(...) tai Booking.find(...) – ja ORM kääntää ne SQL:ksi, suorittaa ne ja muuttaa tulokset takaisin olioiksi. Tunnettuja esimerkkejä ovat Prisma ja Drizzle TypeScriptille, SQLAlchemy Pythonille ja Entity Framework Core C#:lle.

Miksi ORM on tärkeä, kun rakennat tekoälyllä

Kun tekoälysovellusrakentaja lisää sovellukseesi tietokannan, se yleensä lisää myös ORM-työkalun puhumaan sille. Sinun ei tarvitse kirjoittaa ORM-koodia, mutta on hyödyllistä tietää, että se on olemassa:

• Tietomallisi elää koodissa. ORM:n skeemätiedosto on usein selkein kuvaus sovelluksesi datasta: mitä tauluja on, mitkä kentät niissä ovat ja miten ne liittyvät toisiinsa. Sen lukeminen on nopea tapa tarkistaa, että tekoäly ymmärsi sovelluksesi.
• Tietokantamuutokset kulkevat migraatioiden kautta. Kun pyydät ”lisää puhelinnumero asiakkaille”, tekoäly päivittää mallin ja luo migraation. Sen tietäminen auttaa ymmärtämään, miksi muutos saattaa vaatia soveltamisen ennen kuin se toimii live-ympäristössä.
• Turvallisuus oletuksena. ORM-työkalut rakentavat kyselyt tavalla, joka suojaa SQL-injektiota vastaan – yhtä yleistä tietoturva-aukkoa sovelluksissa, jotka koostavat kyselyt käsin.
• Nopeusongelmat. ORM-työkalut tekevät helpoksi ajaa vahingossa satoja pieniä kyselyitä siinä, missä yksi riittäisi. Tämä on yleinen syy hitaisiin sivuihin tekoälyllä rakennetuissa sovelluksissa.

Arkinen vertauskuva

Kuvittele brittiläinen matkailija ja japanilainen kauppias, jotka eivät puhu samaa kieltä ja kommunikoivat tulkin kautta.

Matkailija (sovelluksesi) sanoo: ”Haluaisin kolme halvinta teetä, mitä teillä on.” Tulkki (ORM) kääntää sen tarkaksi japaniksi (SQL), välittää sen kauppiaalle (tietokannalle) ja kääntää vastauksen takaisin englanniksi.

Matkailija ei opi japania, ja useimmissa keskusteluissa se on hyvä näin. Monimutkaisessa neuvottelussa on kuitenkin hyötyä puhua suoraan – siksi useimmat ORM-työkalut antavat kehittäjien kirjoittaa raakaa SQL:ää tarvittaessa.

Miten ORM toimii

Tietokannat kuten Postgres tallentavat dataa tauluihin, joissa on rivejä ja sarakkeita, ja niitä kysellään SQL:llä. Ohjelmointikielet työskentelevät olioiden kanssa: varaus, jolla on date, customer ja status. ORM kuvaa toisen toiseen:

Nämä neljä operaatiota ovat CRUD-toimintoja, joiden varaan lähes jokainen sovellus rakentuu.

Esimerkki käytännössä: varaukset Prismalla

Tässä on yksinkertaistettu Prisma-skeema kampaamon varaussovellukselle. Se kuvaa kaksi taulua ja niiden linkityksen:

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
}

Selkokielellä: asiakkaalla on nimi, uniikki sähköposti ja monta varausta; jokaisella varauksella on alkamisaika, palvelu ja se kuuluu yhdelle asiakkaalle.

Nyt sovellus haluaa ”Lenan tulevat varaukset, lähimmät ensin”:

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

ORM muuttaa tämän suunnilleen tällaiseksi SQL:ksi, suorittaa sen ja palauttaa listan varausolioita:

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 ja $2 ovat paikkamerkkejä: sähköposti ja päivämäärä lähetetään erillään kyselytekstistä, ja juuri se estää SQL-injektion.

Migraatiot

Jos pyydät sen jälkeen ”anna asiakkaiden lisätä puhelinnumero”, tekoäly lisää Customer-malliin rivin phone String? (? tarkoittaa valinnaista kenttää) ja luo migraation – pienen SQL-skriptin kuten ALTER TABLE "Customer" ADD COLUMN "phone" TEXT;. Migraatiot tallennetaan järjestyksessä, joten jokainen tietokannan kopio voidaan tuoda samaan rakenteeseen, ja muutoshistoria säilyy.

Yleisimmät ORM-työkalut kielittäin

ORM-työkalut vaihtelevat sen suhteen, kuinka paljon ne piilottavat SQL:n. Prisma käyttää omaa skeemakieltään ja kyselytyyliään; Drizzle pysyy tarkoituksella lähellä SQL:n muotoa ja pitää kaiken tyypitettynä. Kevyempiä työkaluja, ns. kyselyrakentajia (query builder), kuten TypeScriptin Knex tai Kysely, käytetään SQL:n rakentamiseen koodissa ilman rivien kokonaista muuttamista olioiksi.

Keskeiset termit

Yleisiä väärinkäsityksiä

• ”ORM on tietokanta.” Ei ole. Se on kääntäjä. Tarvitset yhä tietokannan, kuten Postgresin.
• ”ORM:n kanssa ei tarvitse ymmärtää dataansa.” Huonosti suunnitellut taulut ovat yhtä kiusallisia ORM:nkin kautta. Hyvä tietomalli on tärkeämpi kuin työkalu.
• ”ORM:t ovat aina hitaita.” Tavalliset kyselyt ovat kunnossa. Hitaus johtuu yleensä malleista, kuten N+1-kyselyistä tai puuttuvista indekseistä, ja ne voi korjata.
• ”ORM tarkoittaa, ettei SQL-injektion riskiä ole koskaan.” Tavalliset ORM-metodit ovat turvallisia, mutta käyttäjän syötteen liittäminen raakaan SQL:ään on yhä vaarallista.
• ”Skeematiedoston muokkaaminen muuttaa live-tietokannan.” Vain kun migraatio on luotu ja sovellettu kyseiseen tietokantaan.

Mitä kysyä tekoälysovellusrakentajaltasi

• ”Näytä tietokannan skeema ja selitä jokainen taulu ja suhde selkokielellä.”
• ”Mitä ORM-työkalua tämä projekti käyttää, ja missä migraatiot ovat?”
• ”Ennen kuin muutat yhtäkään taulua, kerro, vaikuttaako se olemassa olevaan dataan, äläkä koskaan poista saraketta, jossa on dataa, kysymättä ensin.”
• ”Tarkista hitaimmat sivut N+1-kyselyiden varalta ja lisää indeksit listoihin, joita suodatetaan tai järjestetään.”
• ”Varmista, että jokainen käyttäjän syötettä käyttävä kysely kulkee ORM:n kautta tai käyttää parametreja – ei merkkijonoista rakennettua SQL:ää.”

ORM:t Mythexissä

Kun sovelluksesi tarvitsee tallentaa dataa, Mythex lisää projektiin oman Postgres-tietokannan – kysy chatissa tai käytä komentoa /database – ja syöttää sen yhteystiedot työtilaan ja julkaistuun sovellukseen (Database). Agentti kirjoittaa sitten koodin, joka lukee ja tallentaa datasi. Jos sinulla on mieltymys – ”käytä Prismaa”, ”käytä SQLAlchemyä” tai ”pelkkä SQL, ei ORM:ää” – kerro se chatissa. Pyydä sitä käymään skeema läpi aina kun haluat tarkistaa rakenteen; voit lukea tiedostot koodieditorissa. Laajemman kuvan saat sivuilta mikä on tietokanta ja SQL vs NoSQL.

Kysymykset