Yönetici Özeti ve Mimari Önem

Prisma ORM 7.10.1; sorgu motorundaki incelikli durum mutasyonu hatalarını, yüksek önem derecesindeki veritabanı migrasyon risklerini ve üst akım güvenlik açığı bildirimlerini ele alan, hedef odaklı ancak kritik bir yama sürümü olarak karşımıza çıkıyor. Yoğun eşzamanlı yük altında çalışan büyük ölçekli kurumsal uygulamalar için, veritabanı bağlantıları üzerindeki küçük durum sızıntıları, felaket niteliğinde veri bozulmalarına veya aralıklı istek hatalarına dönüşebilir. Bu sürüm, özellikle interaktif veritabanı işlemleri içindeki nesne referansı mutasyonu tarafından sunulan deterministik olmayan davranışları hedefleyerek bağlantı yalıtım sınırlarının katı bir şekilde korunmasını sağlar.

İşlem güvenliğinin ötesinde, sürüm 7.10.1 Prisma ekosisteminin temel güvenlik duruşunu güçlendirir. mysql2, fast-uri, deepmerge-ts, source-map-js ve yerel mariadb sürücüsü için kritik yamalar dahil olmak üzere geçişli ve eş bağımlılıkları agresif bir şekilde denetleyip yükselterek mühendislik ekibi olası tedarik zinciri vektörlerini azaltır. Dahası, Prisma Migrate yanlış yapılandırılmış gölge veritabanlarının neden olduğu felaket niteliğindeki şema silinmelerine karşı savunma bariyerleri sunar. Bu geliştirmeler, Prisma'nın kurumsal düzeyde güvenilirlik taahhüdünün altını çizerek geliştiricilere öngörülebilir veritabanı etkileşimleri ve sağlam hata modları sağlar.

Temel Geliştirmeler ve Geliştirici Ergonomisi

Prisma 7.10.1'deki en belirgin mimari düzeltme, iç içe $transaction çağrılarındaki incelikli bir referans mutasyonu kusurunu çözer. Daha önce, bir geliştirici statik bir yapılandırma seçenekleri nesnesini (örneğin { timeout: 30_000, maxWait: 10_000 }) hem iç içe hem de üst düzey interaktif işlemlerde yeniden kullanırsa, dahili motor yanlışlıkla dış işlemin tanımlayıcısını doğrudan bu paylaşılan nesneye enjekte ediyordu. Bu mutasyona uğramış nesneye referans veren sonraki üst düzey işlemler, yanlış bir şekilde iç içe işlemler olarak işaretleniyordu. Geçmiş işlemin tamamlanmış olup olmamasına bağlı olarak, bu durum ya bir P2028 işlem hatası fırlatıyor ya da yeni sorguları ilişkisiz yürütme bağlamları içinde kayıt noktaları olarak sessizce yürütüyordu. Prisma Client 7.10.1, yapılandırma nesnesini değiştirilemez (immutable) olarak ele alarak mutlak işlemsel yalıtımı korur ve bu yan etkiyi tamamen ortadan kaldırır.

Paralel olarak Prisma Migrate, geliştiricilerin gölge veritabanı URL'lerini doğrudan birincil prodüksiyon veya geliştirme veritabanına yanlışlıkla yönlendirdiği ciddi bir yanlış yapılandırma tehlikesini ele alır. Tarihsel olarak, bu hatalı kurulumla prisma migrate diff --from-migrations gibi işlemlerin çalıştırılması canlı şemayı silebilir ve sıfırdan yeniden oluşturarak uyarı vermeden boş bir yapısal fark üretebilirdi. Sürüm 7.10.1, ana ve gölge veritabanı işaretçileri arasında bir çakışma tespit edildiğinde migrasyon motorunun yürütmeyi hemen durdurmasına neden olan P3025 hatasını sunar. Ek olarak, @prisma/adapter-mariadb sürüm 3.5.4'e yükseltilerek manuel IPv6 ana bilgisayar yeniden yazma geçici çözümleri yerel sürücü desteği lehine kaldırılmış ve alttaki güvenlik uyarıları tamamen çözülmüştür.

Mimari Karşılaştırma Matrisi

Breaking Changes (Uyumsuz Değişiklikler) ve Migrasyon Uyarıları

Prisma 7.10.1, önceki 7.x sürümleriyle tamamen geriye dönük olarak uyumludur ve standart sorgu kalıpları için amaçlanan herhangi bir uyumsuz API değişikliği sunmaz. Bununla birlikte, önceden belgelenmemiş yan etkilere güvenen geliştiriciler—özellikle işlem kimliklerini koruyan paylaşılan işlem seçeneği nesnelerine yanlışlıkla bağımlı olanlar—durum kirliliğinin artık gerçekleşmediğini göreceklerdir.

P3025 hata kodunun sunulması, yalnızca migrasyonlar sırasında birincil veritabanını gölge veritabanı olarak kullanmak üzere yanlış yapılandırılmış CI/CD hatları veya yerel ortamlar için katı bir uyumsuz değişiklik (breaking change) görevi görür. Dağıtım betikleriniz veya yerel kurulumlarınız P3025 tetikliyorsa, Prisma Migrate'in güvenlik kontrollerine uymak için hemen özel, yalıtılmış bir gölge veritabanı örneği sağlamalısınız.

Adım Adım Yükseltme Kılavuzu

Prisma 7.10.1'e yükseltmek, migrasyon yapılandırmalarınızın hızlı bir doğrulamasıyla birlikte standart bağımlılık yönetimi güncellemelerini gerektirir.

1. Prisma Paketlerini Güncelleyin: Tercih ettiğiniz paket yöneticisini kullanarak Prisma CLI ve Client paketlerinizi 7.10.1 sürümüne yükseltin:

   npm install [email protected] @prisma/[email protected] @prisma/adapter-mariadb@latest
   

2. Gölge Veritabanı Yapılandırmasını Doğrulayın: Yeni P3025 bariyerinin tetiklenmesini önlemek için .env veya veri kaynağı yapılandırmanızın birincil veritabanınız ve gölge veritabanınız için ayrı URL'ler koruduğundan emin olun:

   datasource db {
     provider          = "postgresql"
     url               = env("DATABASE_URL")
     shadowDatabaseUrl = env("SHADOW_DATABASE_URL")
   }
   

3. İşlem Seçenekleri Kullanımını Doğrulayın: Statik işlem seçeneği nesnelerinin birden çok $transaction sınırı arasında paylaşıldığı kod tabanlarını inceleyin. Prisma 7.10.1 artık bu nesneleri