software•

Prisma v8.0.0-rc.21 est disponible : Analyse architecturale approfondie

Découvrez Prisma v8.0.0-rc.21 avec une gestion robuste des énumérations, une validation MongoDB unifiée, la gestion des erreurs asynchrones et des outils de migration renforcés.

OP
OPA Release DeskWIRE
•7 min read
Prisma v8.0.0-rc.21 est disponible : Analyse architecturale approfondie

⚠️ Breaking Changes & Migration Caveats

Les membres clients renvoient désormais des promesses rejetées au lieu de lever une exception synchrone sur les connexions fermées ; les contrats MongoDB nécessitent des configurations explicites de packs cibles ; close() met fin à l'exécution du client indépendamment de l'injection d'un pool externe.

Aperçu de la direction et importance architecturale

Prisma v8.0.0-rc.21 marque une avancée majeure dans le cycle de publication de la version 8, en introduisant des améliorations architecturales essentielles pour les bases de données relationnelles, MongoDB et la gestion des erreurs côté client. À mesure que les flux de travail des bases de données d'entreprise se complexifient, il devient primordial de maintenir un alignement strict des contrats entre les définitions de schémas, les exécuteurs de migrations et le comportement à l'exécution. Cette version s'attaque à la cohérence fondamentale, en garantissant que PostgreSQL, SQLite et MongoDB fonctionnent selon des pipelines de validation unifiés tout en renforçant la prédictibilité de la propagation des erreurs asynchrones.

D'un point de vue architectural, la version v8.0.0-rc.21 uniformise la manière dont les contrats de stockage sont évalués, construits et vérifiés. En éliminant les chemins d'exécution redondants dans l'analyse syntaxique des contrats MongoDB — unifiant les entrées TypeScript, PSL et Prisma 6 en un seul générateur robuste —, Prisma réduit considérablement les divergences liées aux cas limites. De plus, la refonte de la planification des migrations pour les modifications d'énumérations sur PostgreSQL et SQLite aligne l'évolution des schémas relationnels sur les attentes de l'industrie. Plutôt que d'échouer silencieusement ou d'exiger des réinitialisations de base de données destructrices, l'interface en ligne de commande (CLI) fournit désormais des contrôles de sécurité interactifs et structurés ainsi que des voies de récupération explicites pour les états de contrat hors limites.

Améliorations principales et ergonomie pour les développeurs

L'ergonomie pour les développeurs bénéficie d'un essor considérable grâce à l'arrivée des premiers paquets publics de planification et d'application de migrations pour MySQL, assurant une parité de fonctionnalités avec les principales bases de données relationnelles cibles de Prisma. Les utilisateurs de PostgreSQL et SQLite profitent également d'une gestion avancée du cycle de vie des énumérations ; des opérations telles que migration plan et db update peuvent désormais renommer ou supprimer de manière transparente des valeurs d'énumération tout en réécrivant automatiquement les lignes dépendantes. Les types de date et d'heure dans PostgreSQL ont été explicitement refactorisés pour désigner clairement la nature exacte des valeurs qu'ils lisent, imposant des normes strictes d'analyse ISO 8601 de manière uniforme sur tous les serveurs.

Dans l'écosystème MongoDB, les règles d'évaluation des contrats ont été rigoureusement standardisées. Qu'il s'agisse de définir des schémas via TypeScript, PSL ou les formats hérités de Prisma 6, chaque source passe désormais par un moteur de validation unique. Cela impose des règles polymorphes strictes — telles que l'obligation pour les discriminateurs d'être des champs textuels et non optionnels — et élimine automatiquement les définitions d'index en double. En outre, les préréglages de champs ont été abandonnés au profit de constructeurs de types explicites et d'alias de types, rationalisant ainsi le modèle mental pour la composition des schémas et améliorant la sécurité globale des types dans les domaines applicatifs complexes.

Matrice de comparaison architecturale

Fonctionnalité / Métrique Référence précédente (Pré-RC v8.0.x) Prisma v8.0.0-rc.21 Impact architectural
Latence des erreurs client Lancement synchrone immédiat lors de l'appel Rejet de promesse / résultat lors du await/lecture Élimine les plantages d'exécution synchrone non gérés ; s'intègre proprement avec Promise.allSettled.
Générateurs de contrats MongoDB Analyseurs fragmentés entre TS et PSL Pipeline de génération unifié Garantit des règles de validation identiques quel que soit le format d'entrée du schéma.
Modification d'énumération (PG/SQLite) Valeurs non gérées échouées ou ignorées Invite interactive ou options CLI explicites (--rename/--delete) Prévient la corruption silencieuse des données et automatise les transformations de données au niveau des lignes.
Support des migrations MySQL Expérimental / Interne uniquement Premiers paquets de migration publics et stables Établit une parité de production complète pour la gestion du cycle de vie des bases de données MySQL.

Changements cassants et avertissements de migration

Prisma v8.0.0-rc.21 introduit plusieurs changements cassants délibérés conçus pour renforcer la prédictibilité à l'exécution. Plus particulièrement, les membres clients sur les instances postgres(), sqlite() et les instances supabase() liées à un rôle renvoient désormais une promesse ou un résultat rejeté au lieu de lever une exception synchrone lorsqu'ils sont invoqués sur un client fermé, une connexion défaillante ou une transaction terminée. Par conséquent, les blocs try/catch hérités entourant les appels de base de données asynchrones sans await explicite ne parviendront pas à intercepter les erreurs de connexion ; les développeurs doivent s'assurer que les appels sont correctement attendus.

De plus, les contrats MongoDB nécessitent des configurations explicites de packs cibles (mongoContract(path, { target })), et les cycles de vie des connexions aux bases de données ont été dissociés des pools de connexions externes. L'invocation de close() sur un client Prisma mettra désormais fin de manière agressive à son environnement d'exécution interne, même si un pg.Pool externe a été fourni. Enfin, les hachages de schéma pour les configurations de Prisma 6 contenant des index en double changeront lors de l'émission, nécessitant une opération de signature secondaire.

Guide de mise à niveau étape par étape

La mise à niveau vers la version v8.0.0-rc.21 nécessite une validation minutieuse des routines de gestion des erreurs asynchrones et des configurations de contrats mises à jour. Suivez ces étapes pour effectuer une transition réussie :

  1. Mettre à jour les dépendances et réexécuter l'émission des contrats : Mettez à jour vos paquets Prisma vers la version v8.0.0-rc.21 et exécutez l'émetteur de contrats pour synchroniser les empreintes d'artefacts :

    prisma contract emit
    
  2. Refactoriser la gestion des erreurs asynchrones : Auditez votre code source pour repérer les blocs try/catch synchrones autour des requêtes de base de données et ajoutez le mot-clé await :

    // Avant
    try {
      db.transaction(work); 
    } catch (error) {
      handle(error);
    }
    
    // Après
    try {
      await db.transaction(work); 
    } catch (error) {
      handle(error);
    }
    
  3. Mettre à jour les déclarations de contrats MongoDB : Si vous utilisez MongoDB, assurez-vous que l'invocation de votre générateur de contrats transmet explicitement le pack cible :

    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
    });
    
#Prisma#v8.0.0-rc.21#software#Release#Changelog
Editorial MethodologyRelease Intelligence & Verification Standards

OPA Release analyzes upstream repository commits, official changelogs, and runtime telemetry assisted by automated synthesis pipelines and verified under our Editorial Standards. Review our Affiliate Disclosure and Software Disclaimer before deploying changes to production environments.

Frequently Asked Questions

What are the key enhancements in Prisma v8.0.0-rc.21?▼

Key enhancements include: Prise en charge du renommage et de la suppression des valeurs d'énumération pour PostgreSQL et SQLite avec migration automatisée des données au niveau des lignes.; Pipeline de compilation de contrats MongoDB unifié appliquant un polymorphisme strict et des règles de validation des index.; Propagation d'erreurs asynchrones garantissant que les échecs de client fermé et de connexion rejettent les promesses au lieu de lever une exception synchrone..

Are there breaking changes in Prisma v8.0.0-rc.21?▼

Les membres clients renvoient désormais des promesses rejetées au lieu de lever une exception synchrone sur les connexions fermées ; les contrats MongoDB nécessitent des configurations explicites de packs cibles ; `close()` met fin à l'exécution du client indépendamment de l'injection d'un pool externe.

How do developers upgrade to Prisma v8.0.0-rc.21?▼

Refer to the step-by-step upgrade guide and official release manifest linked in this analysis, ensuring environment dependencies are verified.

OPA NETWORK EXPLORER

Deep Dive Across the Ecosystem