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 :
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.21et exécutez l'émetteur de contrats pour synchroniser les empreintes d'artefacts :prisma contract emitRefactoriser la gestion des erreurs asynchrones : Auditez votre code source pour repérer les blocs
try/catchsynchrones 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); }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 });
