Yönetici Özeti ve Mimari Önem
Prisma v8.0.0-rc.21, ilişkisel veritabanları, MongoDB ve istemci tarafında hata yönetimi genelinde kritik mimari iyileştirmeler sunarak v8 sürüm döngüsünde ileriye doğru büyük bir adım atmaktadır. Kurumsal veritabanı iş akışları giderek daha karmaşık hale geldikçe, şema tanımları, migrasyon yürütücüleri ve çalışma zamanı davranışı arasındaki sıkı sözleşme uyumunu korumak son derece önemli hale gelmektedir. Bu sürüm, temel tutarsızlıkları ele alarak PostgreSQL, SQLite ve MongoDB'nin birleştirilmiş doğrulama hatları altında çalışmasını sağlarken asenkron hata yayılımında öngörülebilirliği artırır.
Mimari açıdan v8.0.0-rc.21, depolama sözleşmelerinin nasıl değerlendirildiğini, oluşturulduğunu ve doğrulandığını standartlaştırır. MongoDB sözleşme çözümlemesindeki gereksiz yürütme yollarını ortadan kaldırarak -TypeScript, PSL ve Prisma 6 girdilerini tek ve güçlü bir oluşturucuda birleştirerek- Prisma, uç durum tutarsızlıklarını önemli ölçüde azaltır. Ek olarak, PostgreSQL ve SQLite üzerindeki enum değişiklikleri için migrasyon planlamasının elden geçirilmesi, ilişkisel şema evrimini sektör beklentileriyle uyumlu hale getirir. CLI, sessizce başarısız olmak veya yıkıcı veritabanı sıfırlamaları gerektirmek yerine artık yapılandırılmış, etkileşimli güvenlik kontrolleri ve sınır dışı sözleşme durumları için açık kurtarma yolları sunmaktadır.
Temel İyileştirmeler ve Geliştirici Ergonomisi
MySQL'in ilk resmi migrasyon planlaması ve uygulama paketlerinin gelmesiyle geliştirici ergonomisi büyük bir ivme kazanmakta ve Prisma'nın birincil ilişkisel veritabanı hedefleri arasında özellik eşliği sağlanmaktadır. PostgreSQL ve SQLite kullanıcıları ayrıca gelişmiş enum yaşam döngüsü yönetiminden yararlanır; migration plan ve db update gibi işlemler artık bağımlı satırları otomatik olarak yeniden yazarken enum değerlerini sorunsuz bir şekilde yeniden adlandırabilir veya silebilir. PostgreSQL'deki tarih ve saat türleri, okudukları değerlerin tam doğasını net bir şekilde belirtecek şekilde açıkça yeniden düzenlenmiş olup tüm sunucularda katı ISO 8601 ayrıştırma standartlarını tek tip olarak zorunlu kılar.
MongoDB ekosisteminde sözleşme değerlendirme kuralları titizlikle standartlaştırılmıştır. Şemalar ister TypeScript, ister PSL veya eski Prisma 6 biçimleriyle tanımlansın, her kaynak artık tekil bir doğrulama motorundan geçmektedir. Bu, ayırt edici özelliklerin (discriminator) isteğe bağlı olmayan, metin tabanlı alanlar olmasını gerektiren katı polimorfik kuralları zorunlu kılar ve yinelenen indeks tanımlarını otomatik olarak ortadan kaldırır. Ek olarak, alan ön ayarları açık tür oluşturucuları ve tür takma adları lehine kullanım dışı bırakılmış; böylece şema kompozisyonu için zihinsel model kolaylaştırılmış ve karmaşık uygulama alanlarında genel tür güvenliği artırılmıştır.
Mimari Karşılaştırma Matrisi
| Özellik / Metrik | Önceki Temel Çizgi (v8.0.x Öncesi RC) | Prisma v8.0.0-rc.21 | Mimari Etki |
|---|---|---|---|
| İstemci Hata Gecikmesi | Çağrı anında anlık senkron hata fırlatma | Bekleme/okuma (await/read) anında Promise/Result reddi |
İşlenmemiş senkron yürütme çökmelerini ortadan kaldırır; Promise.allSettled ile temiz bir şekilde entegre olur. |
| MongoDB Sözleşme Oluşturucuları | TS ve PSL arasında parçalanmış ayrıştırıcılar | Birleştirilmiş oluşturucu hattı | Şema giriş biçiminden bağımsız olarak aynı doğrulama kurallarını garanti eder. |
| Enum Değişikliği (PG/SQLite) | İşlenmeyen değerler başarısız olur veya yoksayılır | Etkileşimli komut istemi veya açık CLI bayrakları (--rename/--delete) |
Sessiz veri bozulmasını önler ve satır düzeyinde veri dönüşümlerini otomatize eder. |
| MySQL Migrasyon Desteği | Yalnızca Deneysel / Dahili | İlk genel, kararlı migrasyon paketleri | MySQL veritabanı yaşam döngüsü yönetimi için tam üretim eşliği kurar. |
Kritik Değişiklikler ve Migrasyon Uyarıları
Prisma v8.0.0-rc.21, çalışma zamanı öngörülebilirliğini artırmak için tasarlanmış birkaç kasıtlı kırılma değişikliği (breaking change) sunar. En dikkat çekici şekilde, postgres(), sqlite() ve role bağlı supabase() örneklerindeki istemci üyeleri, kapalı bir istemci, başarısız bağlantı veya sonlandırılmış işlem üzerinde çağrıldığında senkron olarak hata fırlatmak yerine artık reddedilmiş bir söz (rejected promise) veya sonuç döndürür. Sonuç olarak, açık bir await ifadesi içermeyen asenkron veritabanı çağrılarını çevreleyen eski try/catch blokları bağlantı hatalarını yakalayamayacaktır; geliştiricilerin çağrıların uygun şekilde beklendiğinden (await) emin olması gerekir.
Ek olarak, MongoDB sözleşmeleri açık hedef paket yapılandırmaları (mongoContract(path, { target })) gerektirir ve veritabanı bağlantı yaşam döngüleri harici bağlantı havuzlarından ayrıştırılmıştır. Bir Prisma istemcisinde close() metodunun çağrılması, harici bir pg.Pool sağlanmış olsa bile dahili çalışma zamanını agresif bir şekilde sonlandıracaktır. Son olarak, yinelenen indeksler içeren Prisma 6 yapılandırmaları için şema özetleri (hashes) çıktı alındığında değişecek ve ikincil bir imza işlemi gerektirecektir.
Adım Adım Yükseltme Kılavuzu
v8.0.0-rc.21 sürümüne yükseltme yapmak, asenkron hata yönetimi rutinlerinin ve güncellenmiş sözleşme yapılandırmalarının dikkatli bir şekilde doğrulanmasını gerektirir. Başarıyla geçiş yapmak için şu adımları izleyin:
Bağımlılıkları Güncelleyin ve Sözleşme Çıktısını Yeniden Çalıştırın: Prisma paketlerinizi
v8.0.0-rc.21sürümüne güncelleyin ve yapı artifaktlarını senkronize etmek için sözleşme yayıcısını yürütün:prisma contract emitAsenkron Hata Yönetimini Yeniden Düzenleyin: Veritabanı sorgularının etrafındaki senkron
try/catchblokları için kod tabanınızı denetleyin veawaitanahtar kelimesini ekleyin:// Önce try { db.transaction(work); } catch (error) { handle(error); } // Sonra try { await db.transaction(work); } catch (error) { handle(error); }MongoDB Sözleşme Bildirimlerini Güncelleyin: MongoDB kullanıyorsanız, sözleşme oluşturucu çağrınızın hedef paketi açıkça ilettiğinden emin olun:
import type { ContractInput } from '@prisma/orm-mongo/contract-builder'; import mongoTargetPack from '@prisma/orm-mongo/target/pack'; const contract = mongoContract('./prisma/schema.prisma', { target: mongoTargetPack });
