Prisma ORM Client Kullanımı Detaylı Rehber


Prisma ORM Client Kullanımı Detaylı Rehber

Modern web uygulamalarında veritabanı yönetimini kolaylaştıran Prisma ORM, TypeScript ve JavaScript ekosistemlerinde en çok tercih edilen araçlardan biridir. Bu makalede, Prisma ORM Client kullanımı hakkında bilmeniz gereken temel noktaları ve işe yarar kod örneklerini bulacaksınız. Özellikle Node.js projelerinde, hem veritabanına bağlantı hem de CRUD işlemlerini sade ve güvenli bir şekilde gerçekleyebilirsiniz.

Prisma ORM Client Nedir?

Prisma ORM Client, model tabanlı bir veritabanı istemcisi olarak çalışır ve uygulamanızla veritabanı arasında otomatikleştirilmiş bir köprü sunar. Şema (schema.prisma) dosyanızı düzenleyerek modellerinizi ve ilişkilerinizi tanımlarsınız, ardından prisma generate komutu ile gerekli TypeScript/Javascript client kodları otomatik olarak üretilir. Bu sayede hata olasılıkları azalır ve kod tekrarı minimuma iner.

Başlıca Avantajlar

  • Tip güvenliği ve IntelliSense desteği
  • Güncel ve geniş topluluk desteği
  • Taşınabilir ve ölçeklenebilir yapı

Kurulum ve İlk Yapılandırma

Prisma ORM Client ile çalışmaya başlamak için öncelikle projenize bağımlılıkları ekleyin ve ilk şemanızı oluşturun. Ardından aşağıdaki adımları takip edin:

npm install prisma --save-dev
npm install @prisma/client

Örnek bir prisma/schema.prisma dosyası aşağıdaki gibi tanımlanabilir:

generator client {
  provider = "prisma-client-js"
}
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}
model User {
  id    Int     @id @default(autoincrement())
  name  String
  email String  @unique
}

Değişikliklerden sonra veritabanı şemanızı ve Client'ı oluşturmak için:

npx prisma migrate dev --name init
yarn prisma generate

Prisma ORM Client ile CRUD İşlemleri

Prisma ORM Client kullanımı ile temel CRUD (Create, Read, Update, Delete) işlemleri oldukça kolaylaşır. Aşağıda Node.js içerisinde Prisma kullanarak bir kullanıcı kaydı ekleme örneğini görebilirsiniz:

const {{ PrismaClient }} = require('@prisma/client')
const prisma = new PrismaClient()

async function main() {
  // Yeni kullanıcı ekleme
  const user = await prisma.user.create({
    data: {{
      name: 'Ali Veli',
      email: 'ali@example.com'
    }}
  })
  console.log(user)
}

main()
  .catch(e => {{
    throw e
  }})
  .finally(async () => {{
    await prisma.$disconnect()
  }})

Farklı sorgu tipleri (user.findMany, user.update, user.delete vb.) ile veritabanı üzerinde güvenli işlemler yapabilirsiniz.

Sonuç

Prisma ORM Client kullanımı günümüz modern uygulamalarında hızlı, güvenli ve ölçeklenebilir veritabanı işlemleri için en verimli yollardan biridir. Kurulumu ve kod yazımı pratik olan Prisma, hem deneyimli hem de yeni başlayan geliştiriciler için önerilen bir ORM çözümüdür. Daha fazla bilgi ve güncel dökümantasyon için Prisma Resmi Dökümantasyonuna göz atabilirsiniz.