ORM дегеніміз не? Қосымшалар деректер қорымен қалай сөйлеседі

ORM (object-relational mapper) — қосымша мен реляциялық деректер қорының арасында тұратын код кітапханасы. Әзірлеушілер SQL-де сұраныс жазудың орнына деректермен өз бағдарламалау тіліндегі әдеттегі объектілер арқылы жұмыс істейді — db.booking.create(...) немесе Booking.find(...) — ал ORM мұны SQL-ге аударып, орындайды және нәтижелерді қайтадан объектілерге айналдырады. Танымал мысалдар: TypeScript үшін Prisma мен Drizzle, Python үшін SQLAlchemy және C# үшін Entity Framework Core.

AI көмегімен құрастырғанда ORM неге маңызды

AI қосымша құрастырушысы қосымшаңызға деректер қорын қосқанда, оған қосылу үшін әдетте ORM де қосады. ORM кодын жазудың қажеті жоқ, бірақ оның бар екенін білу пайдалы:

• Деректер моделі кодта тұрады. ORM-нің схема файлы көбіне қосымшаңыздың деректерін ең анық сипаттайтын құжат болады: қандай кестелер бар, әр кестеде қандай өрістер бар және олар қалай байланысады. Оны оқу AI қосымшаңызды дұрыс түсінгенін тез тексеруге көмектеседі.
• Деректер қорына өзгерістер миграция арқылы өтеді. «Клиенттерге телефон нөмірін қосыңыз» деп сұрағанда, AI модельді жаңартып, миграция жасайды. Мұны білу өзгеріс неге тікелей эфирде жұмыс істеу үшін қолданылуы керек екенін түсінуге көмектеседі.
• Әдепкі қауіпсіздік. ORM сұраныстарды SQL инъекциясынан қорғайтындай етіп құрастырады. Бұл сұраныстарды қолмен құрастыратын қосымшалардағы ең кең таралған осалдықтардың бірі.
• Жылдамдық тұзақтары. ORM бір сұраныс жеткілікті болатын жерде жүздеген шағын сұраныс жіберуді оңай етеді. Бұл AI-мен құрастырылған қосымшалардағы беттердің баяулауының жиі себебі.

Күнделікті салыстыру

Британиялық саяхатшы мен жапон дүкенші бір-бірінің тілін білмейтінін елестетіңіз. Олар аудармашы арқылы сөйлеседі.

Саяхатшы (сіздің қосымшаңыз) былай дейді: «Маған ең арзан үш шайыңызды беріңіз». Аудармашы (ORM) мұны дәл жапон тіліне (SQL) аударады, дүкеншіге (деректер қорына) береді, ал жауапты қайтадан ағылшынға аударады.

Саяхатшы жапон тілін үйренбейді, және көп жағдайда бұл жеткілікті. Бірақ күрделі келіссөзде тікелей сөйлескен дұрыс. Сондықтан көпшілік ORM қажет кезде әзірлеушіге таза SQL жазуға мүмкіндік береді.

ORM қалай жұмыс істейді

Postgres сияқты деректер қорлары деректерді жолдары мен бағандары бар кестелерде сақтайды және SQL арқылы сұраныс жасалады. Бағдарламалау тілдері объектілермен жұмыс істейді: date (күні), customer (клиенті) және status (күйі) бар брондау. ORM екеуін бір-біріне салыстырады:

Бұл төрт әрекет — іс жүзінде барлық қосымша негізделетін CRUD әрекеттері.

Жұмыс мысалы: Prisma арқылы брондаулар

Мына — сұлулық салонының брондау қосымшасына арналған қарапайымдатылған Prisma схемасы. Ол екі кестені және олардың байланысын сипаттайды:

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
}

қарапайым сөзбен айтқанда: клиентте аты, бірегей электрондық поштасы және көп брондауы бар; әр брондауда басталу уақыты, қызметі бар және бір клиентке тиесілі.

Енді қосымша «Ленаның алдағы брондауларын, ең жақыны бірінші» деп сұрайды:

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

ORM мұны шамамен мына SQL-ге айналдырады, оны орындап, брондау объектілерінің тізімін қайтарады:

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 мен $2 — орын толтырғыштар: электрондық пошта мен күн сұраныс мәтінінен бөлек жіберіледі, дәл осы SQL инъекциясының алдын алады.

Миграциялар

Содан кейін «клиенттерге телефон нөмірін қосуға рұқсат беріңіз» деп сұрасаңыз, AI Customer моделіне phone String? қосады (? белгісі міндетті емес дегенді білдіреді) және миграция жасайды — мысалы ALTER TABLE "Customer" ADD COLUMN "phone" TEXT; сияқты шағын SQL скрипті. Миграциялар ретімен сақталады, сондықтан деректер қорының әр данасын бірдей құрылымға келтіруге болады және өзгерістер тарихы сақталады.

Бағдарламалау тілі бойынша кең таралған ORM-дер

ORM-дер SQL-ді қаншалықты жасыратыны бойынша ерекшеленеді. Prisma өзінің схема тілі мен сұраныс стилін қолданады; Drizzle барлығын типтеу арқылы SQL-дің пішініне жақын қалады. Сұраныс құрастырушылар деп аталатын жеңіл құралдар, мысалы TypeScript үшін Knex немесе Kysely, жолдарды толық объектілерге салыстырмай, SQL-ді кодта құрастыруға көмектеседі.

Негізгі терминдер

Жиі кездесетін қате түсініктер

• «ORM — бұл деректер қоры». Олай емес. Ол аудармашы. Сізге әлі де Postgres сияқты деректер қоры қажет.
• «ORM болса, деректеріңізді түсінудің қажеті жоқ». Нашар жобаланған кестелер ORM арқылы да қиындық туғызады. Жақсы деректер моделі құралдан маңыздырақ.
• «ORM әрдайым баяу». Күнделікті сұраныстар жақсы жұмыс істейді. Баяулық көбіне N+1 сұраныстары немесе индекстердің жоқтығы сияқты үлгілерден туындайды, ал оларды түзетуге болады.
• «ORM дегеніміз — SQL инъекциясы қаупі мүлде жоқ». Стандартты ORM әдістері қауіпсіз, бірақ пайдаланушы енгізген мәтін қойылған таза SQL әлі де қауіпті.
• «Схема файлын өңдеу тірі деректер қорын өзгертеді». Тек миграция жасалып, сол деректер қорына қолданылғаннан кейін ғана.

AI құрастырушыға не сұрау керек

• «Деректер қорының схемасын көрсетіңіз және әр кестені мен байланысты қарапайым тілмен түсіндіріңіз.»
• «Бұл жоба қай ORM-ді қолданады және миграциялар қайда орналасқан?»
• «Кез келген кестені өзгертер алдында, бар деректерге әсер ететінін айтыңыз және деректері бар бағанды сұрамай ешқашан жоймаңыз.»
• «Ең баяу беттерді N+1 сұраныстарына тексеріңіз және тізімдер сүзілетін немесе сұрыпталатын жерлерге индекстер қосыңыз.»
• «Пайдаланушы енгізетін мәтінді өңдейтін әр сұраныс ORM арқылы немесе параметрлер арқылы өтетініне көз жеткізіңіз — жолмен құрастырылған SQL жоқ.»

Mythex-тегі ORM

Қосымшаңызға деректерді сақтау қажет болғанда, Mythex жобаға арнайы Postgres деректер қорын қосады — чатта сұраңыз немесе /database командасын пайдаланыңыз — және оның қосылу деректерін жұмыс кеңістігіне және жарияланған қосымшаға енгізеді (Деректер қоры). Содан кейін агент деректеріңізді оқитын және сақтайтын кодты жазады. Қалауыңыз болса — «Prisma пайдалан», «SQLAlchemy пайдалан» немесе «таза SQL, ORM жоқ» — оны чатта айтыңыз. Құрылымды тексергіңіз келгенде агентке схеманы түсіндіруін сұраңыз; файлдарды код редакторында оқи аласыз. Жалпы көрініс үшін деректер қоры дегеніміз не және SQL мен NoSQL бөлімдерін қараңыз.

Сұрақтар