Aperçu exécutif et portée architecturale
Prisma v8.0.0-rc.22 introduit des améliorations architecturales substantielles dans ses couches de mappage objet-relationnel, ses moteurs de requêtes et ses intégrations de fournisseurs de bases de données. Cette version marque une étape évolutive mature pour Prisma 8, mettant l'accent sur la sécurité stricte des types, le contrôle explicite des dispositions de stockage des bases de données natives et la parité entre les paradigmes d'exécution SQL et NoSQL. En rationalisant l'initialisation des pilotes de bases de données et des contextes d'exécution, Prisma continue d'éliminer les abstractions cachées, offrant aux équipes d'ingénierie d'entreprise des interactions prévisibles et hautement performantes avec les magasins de données sous-jacents.
Au cœur de cette version se trouve un virage délibéré vers la résolution explicite des types et la cohérence du plan de stockage. Sur PostgreSQL, la gestion des dates, des heures et des horodatages a été restructurée pour s'aligner sur des types de convenance standard plutôt que sur des polyfills forcés, simplifiant considérablement l'interopérabilité avec les schémas de bases de données existants. Parallèlement, MongoDB a été élevé à une parité de premier ordre avec les moteurs SQL, intégrant des modèles de piles d'exécution unifiées. Ces ajustements éliminent les états d'analyse ambigus et réduisent la surcharge d'exécution, renforçant le positionnement de Prisma en tant qu'outil de gestion de schémas et de requêtes de niveau entreprise.
Améliorations clés et ergonomie pour les développeurs
L'ergonomie pour les développeurs fait un bond en avant majeur avec la standardisation des contextes d'exécution à travers les paradigmes de bases de données. Le générateur de requêtes, la voie brute, l'ORM et les sous-systèmes d'exécution de MongoDB acceptent désormais un contexte d'exécution unifié via mongoStatic({ contract }) ou mongo({ contract }), reflétant le modèle robuste établi par les moteurs SQL. Ce modèle garantit que la validation du contrat a lieu strictement une seule fois lors de l'initialisation, évitant ainsi les cycles d'analyse redondants lors du traitement des requêtes à haut débit. De plus, les pilotes MongoDB sont désormais instanciés dynamiquement directement à partir de leurs descripteurs d'exécution sur la pile d'exécution, rationalisant la gestion des connexions et abstrayant la logique de connexion récurrente.
Le support de PostgreSQL a été largement étendu pour s'adapter aux écosystèmes d'extensions d'entreprise complexes. Les développeurs peuvent désormais déclarer explicitement les extensions de base de données requises — telles que pgvector, PostGIS, ParadeDB ou le nouveau pack citext — directement dans leurs contrats de schéma, garantissant que les commandes prisma db sign approvisionnent et valident avec précision les environnements cibles. En outre, le moteur de lecture de Prisma 7 a été amélioré pour intégrer de manière exhaustive tous les types natifs @db.* de Postgres, tandis que MySQL bénéficie de nouvelles capacités de lecture pour l'ORM et le constructeur SQL. Les mesures de sécurité ont également été renforcées : le runtime de l'ORM Prisma refusera désormais strictement de s'exécuter si plusieurs copies sont détectées dans l'arbre des modules, et l'appel de connect() sur un client déjà initialisé est désormais garanti sûr et idempotent.
Matrice de comparaison architecturale
| Fonctionnalité / Métrique | Référence précédente | Prisma v8.0.0-rc.22 | Impact architectural |
|---|---|---|---|
| Gestion des dates/heures (PostgreSQL) | Polyfills Temporal forcés sur DateTime, Date, Time |
Types de convenance mappés aux types SQL natifs (timestamptz, date, time, interval) |
Supprime la surcharge des polyfills, aligne directement les types de bases de données natifs avec les primitives JavaScript et les formats de chaînes. |
| Initialisation de MongoDB | Instantiation fragmentée via des exécuteurs dispersés, des énumérations et des cartes de configuration | Contexte d'exécution unifié (mongoStatic) et descripteurs de pilotes d'exécution |
Standardise les pipelines de démarrage entre les moteurs SQL et NoSQL, réduisant la latence d'initialisation. |
| Stockage des objets de valeur | Géré de manière lâche dans le plan de domaine | Déplacé directement dans le plan de stockage avec des contraintes CHECK PostgreSQL automatisées | Impose l'intégrité au niveau de la base de données, transformant les modifications de schéma des objets de valeur en migrations explicites. |
| Sécurité du client et concurrence | Sujet à des échecs d'exécution silencieux en cas de copies multiples du paquet | Vérification stricte du singleton générant une erreur en cas de copies dupliquées ; connect() idempotent |
Élimine les fuites de mémoire subtiles, les incompatibilités de version et les conditions de concurrence de double connexion. |
Changements cassants et avertissements de migration
Prisma v8.0.0-rc.22 introduit plusieurs changements cassants qui nécessitent une exécution minutieuse des chemins de mise à niveau fournis. Sur PostgreSQL, les champs DateTime, Date et Time ne prennent plus par défaut des valeurs Temporal. Au lieu de cela, ils fonctionnent comme des types de convenance (timestamptz(3), des dates/heures basées sur des chaînes et des durées ISO 8601). Les équipes s'appuyant sur le comportement Temporal hérité doivent explicitement renommer les champs en TimestamptzTemporal, DateTemporal ou TimeTemporal, et mettre à jour les assistants TypeScript en conséquence.
De plus, les objets de valeur ont été relocalisés du plan de domaine vers le plan de stockage. Ce réalignement architectural signifie que la mise à jour d'un objet de valeur modifie le hachage de stockage sous-jacent, qualifiant le changement de migration de base de données formelle. PostgreSQL va désormais dériver et appliquer automatiquement des contraintes CHECK pour les colonnes d'objets de valeur et de discriminateur. Tenter de déployer des fichiers contract.json hérités avec des objets de valeur du plan de domaine entraînera un échec de validation immédiat (CONTRACT.VALIDATION_FAILED). Les développeurs doivent utiliser les scripts de migration fournis dans les guides de mise à niveau officiels pour réécrire leurs contrats, instantanés et migrations avant de réémettre et de signer leurs bases de données.
Guide de mise à niveau étape par étape
La mise à niveau vers Prisma v8.0.0-rc.22 nécessite de suivre les guides de mise à niveau officiels pour les applications et les extensions. Exécutez les étapes de migration dans l'ordre précis indiqué ci-dessous pour garantir la synchronisation des contrats et l'intégrité de la base de données.
Exécuter le réécrivain d'objets de valeur et mettre à jour le schéma : Exécutez le script automatisé de mise à niveau de l'application pour migrer les objets de valeur dans le plan de stockage, et mettez à jour vos champs de date/heure PostgreSQL si vous avez besoin du comportement temporel hérité :
model Event { id Int @id at TimestamptzTemporal day DateTemporal opensAt TimeTemporal(0) }Mettre à jour l'initialisation des clients MongoDB et SQL : Refactorisez votre code d'initialisation MongoDB pour utiliser le nouveau modèle de contexte d'exécution statique plutôt que de passer des contrats bruts directement aux générateurs de requêtes individuels :
import mongoStatic from '@prisma/orm-mongo/static'; const { query, raw } = mongoStatic({ contract });Émettre les contrats et signer les bases de données : Après avoir appliqué toutes les modifications de code et de schéma, exécutez l'émission du contrat et la signature de la base de données une seule fois pour synchroniser les timbres de version et garantir la compatibilité avec des extensions comme Supabase :
npx prisma contract emit npx prisma db sign
