Yönetici Özeti ve Mimari Önem
Prisma v8.0.0-rc.22; nesne-ilişkisel eşleme katmanları, sorgu motorları ve veritabanı sağlayıcı entegrasyonları genelinde önemli mimari iyileştirmeler sunar. Bu sürüm, sıkı tip güvenliğine, yerel veritabanı depolama düzenleri üzerinde açık kontrole ve SQL ile NoSQL yürütme paradigmaları arasında eşitliğe vurgu yaparak Prisma 8 için olgun bir evrimsel adımı işaret eder. Veritabanı sürücülerinin ve yürütme bağlamlarının nasıl başlatıldığını optimize eden Prisma, gizli soyutlamaları ortadan kaldırmaya devam ederek kurumsal mühendislik ekiplerine alttaki veri depolarıyla öngörülebilir, yüksek performanslı etkileşimler sunar.
Bu sürümün özünde, açık tip çözümlemesine ve depolama düzlemi tutarlılığına doğru kasıtlı bir geçiş yer alır. PostgreSQL'de tarih, saat ve zaman damgası yönetimi, zorunlu poli dolgular yerine standart kolaylık tipleriyle uyumlu olacak şekilde yeniden yapılandırılmış ve mevcut veritabanı şemalarıyla birlikte çalışabilirlik önemli ölçüde basitleştirilmiştir. Aynı zamanda MongoDB, birleşik yürütme yığını kalıplarını entegre ederek SQL motorlarıyla birinci sınıf bir eşitliğe yükseltilmiştir. Bu ayarlamalar, belirsiz ayrıştırma durumlarını ortadan kaldırır ve çalışma zamanı yükünü azaltarak Prisma'nın kurumsal düzeyde bir şema yönetimi ve sorgulama araç seti olarak konumunu güçlendirir.
Temel İyileştirmeler ve Geliştirici Ergonomisi
Geliştirici ergonomisi, veritabanı paradigmaları genelinde yürütme bağlamlarının standartlaştırılmasıyla ileriye doğru büyük bir sıçrama kaydeder. MongoDB'nin sorgu oluşturucusu, ham yolu, ORM ve çalışma zamanı alt sistemleri artık SQL motorları tarafından oluşturulan güçlü kalıbı yansıtacak şekilde mongoStatic({ contract }) veya mongo({ contract }) aracılığıyla birleşik bir yürütme bağlamını kabul etmektedir. Bu kalıp, sözleşme doğrulamasının başlatma sırasında kesinlikle bir kez gerçekleşmesini garanti ederek yüksek hacimli istek işleme sırasında gereksiz ayrıştırma döngülerini önler. Ek olarak, MongoDB sürücüleri artık doğrudan yürütme yığınındaki çalışma zamanı tanımlayıcılarından dinamik olarak başlatılmakta, bağlantı yönetimini kolaylaştırmakta ve ortak kod bağlantı mantığını soyutlamaktadır.
PostgreSQL desteği, karmaşık kurumsal uzantı ekosistemlerini barındıracak şekilde büyük ölçüde genişletilmiştir. Geliştiriciler artık pgvector, PostGIS, ParadeDB veya yeni citext paketi gibi gerekli veritabanı uzantılarını doğrudan şema sözleşmeleri içinde açıkça beyan edebilir ve prisma db sign komutlarının hedef ortamları doğru bir şekilde hazırlamasını ve doğrulamasını sağlayabilir. Ayrıca Prisma 7 okuyucu motoru, tüm yerel Postgres @db.* tiplerini kapsamlı bir şekilde içe aktaracak şekilde geliştirilirken, MySQL yeni tanıtılan ORM ve SQL oluşturucu okuma yeteneklerinden yararlanmaktadır. Güvenlik önlemleri de sıkılaştırılmıştır: Prisma ORM çalışma zamanı, modül ağacında birden fazla kopya tespit edilirse artık kesinlikle yürütmeyi reddedecek ve halihazırda başlatılmış bir istemci üzerinde connect() çağrısının yapılması güvenli ve eş etkili (idempotent) olacak şekilde garanti altına alınmıştır.
Mimari Karşılaştırma Matrisi
| Özellik / Metrik | Önceki Taban Çizgi | Prisma v8.0.0-rc.22 | Mimari Etki |
|---|---|---|---|
| Tarih/Saat Yönetimi (PostgreSQL) | DateTime, Date, Time üzerinde zorunlu Temporal poli dolguları |
Yerel SQL tipleriyle eşleşen kolaylık tipleri (timestamptz, date, time, interval) |
Poli dolgu yükünü ortadan kaldırır, yerel veritabanı tiplerini doğrudan JavaScript ilkeleri ve dize formatlarıyla hizalar. |
| MongoDB Başlatma | Dağınık yürütücüler, numaralandırmalar (enum) ve yapılandırma haritaları aracılığıyla parçalı örnekleme | Birleşik yürütme bağlamı (mongoStatic) ve çalışma zamanı sürücü tanımlayıcıları |
SQL ve NoSQL motorları arasında önyükleme hatlarını standartlaştırır, başlatma gecikmesini azaltır. |
| Değer Nesnesi Depolama | Etki alanı (domain) düzleminde serbestçe sürdürülürdü | Otomatik PostgreSQL CHECK kısıtlamalarıyla doğrudan depolama düzlemine taşındı | Veritabanı düzeyinde bütünlüğü zorlar, değer nesnelerinin şema değişikliklerini açık geçişlere dönüştürür. |
| İstemci Güvenliği ve Eşzamanlılık | Birden fazla paket kopyasında sessiz çalışma zamanı hatalarına açık | Çift kopyalarda hata veren katı tekil (singleton) kontrolü; eş etkili connect() |
Hassas bellek sızıntılarını, sürüm uyumsuzluklarını ve çift bağlantı yarış koşullarını ortadan kaldırır. |
Breaking Changes (Uyumsuz Değişiklikler) ve Geçiş Uyarıları
Prisma v8.0.0-rc.22, sağlanan yükseltme yollarının dikkatli bir şekilde uygulanmasını gerektiren birkaç uyumsuz değişiklik sunar. PostgreSQL'de DateTime, Date ve Time alanları artık varsayılan olarak Temporal değerlerine dönmez. Bunun yerine kolaylık tipleri (timestamptz(3), dize tabanlı tarihler/saatler ve ISO 8601 süreleri) olarak çalışırlar. Eski Temporal davranışına güvenen ekiplerin, alanları açıkça TimestamptzTemporal, DateTemporal veya TimeTemporal olarak yeniden adlandırması ve TypeScript yardımcılarını buna göre güncellemesi gerekir.
Ek olarak, değer nesneleri etki alanı düzleminden depolama düzlemine taşınmıştır. Bu mimari yeniden hizalama, bir değer nesnesini güncellemenin alttaki depolama karmasını değiştirdiği ve değişikliği resmi bir veritabanı geçişi olarak sınıflandırdığı anlamına gelir. PostgreSQL artık değer nesnesi ve ayırt edici sütunlar için otomatik olarak CHECK kısıtlamaları türetecek ve uygulayacaktır. Etki alanı düzleminde değer nesneleri içeren eski contract.json dosyalarını dağıtmaya çalışmak, anında bir doğrulama hatasıyla (CONTRACT.VALIDATION_FAILED) sonuçlanacaktır. Geliştiriciler, veritabanlarını yeniden yayınlamadan ve imzalamadan önce sözleşmelerini, anlık görüntülerini (snapshot) ve geçişlerini yeniden yazmak için resmi yükseltme tariflerinde sağlanan geçiş betiklerini kullanmalıdır.
Adım Adım Yükseltme Kılavuzu
Prisma v8.0.0-rc.22'ye yükseltmek, uygulamalar ve uzantılar için resmi yükseltme tariflerini takip etmeyi gerektirir. Sözleşme senkronizasyonunu ve veritabanı bütünlüğünü garanti etmek için geçiş adımlarını aşağıda özetlenen kesin sıraylaexecute edin.
Değer Nesnesi Yeniden Yazıcısını Çalıştırın ve Şemayı Güncelleyin: Değer nesnelerini depolama düzlemine geçirmek için otomatik uygulama yükseltme betiğini çalıştırın ve eski zamansal (temporal) davranışa ihtiyacınız varsa PostgreSQL tarih/saat alanlarınızı güncelleyin:
model Event { id Int @id at TimestamptzTemporal day DateTemporal opensAt TimeTemporal(0) }MongoDB ve SQL İstemci Başlatmasını Güncelleyin: Ham sözleşmeleri doğrudan bireysel sorgu oluşturuculara iletmek yerine yeni statik yürütme bağlamı kalıbını kullanmak için MongoDB başlatma kodunuzu yeniden düzenleyin:
import mongoStatic from '@prisma/
