Inicio / Artículos

Prisma ORM 6.0/7.0: La revolución del compilador de consultas — 3.4x

Prisma ORM 6 y 7 reemplazan el motor de consultas de Rust por un compilador de consultas de TypeScript: por qué Rust era lento, la nueva arquitectura y los ahorros en el tamaño del paquete.

Editor: REACTAPP.TOP11 min de lectura2440 palabras

Fuentes: Prisma ORM 6.0/7.0: The Query Compiler Revolution — 3.4x Faster Queries, 90% Smaller Bundles, and TypeScript-First Architecture

Úselo como una versión reestructurada dirigida a operadores de las ideas presentadas en “Prisma ORM 6.0/7.0: La revolución del compilador de consultas — Consultas 3,4 veces más rápidas, paquetes un 90% más pequeños y arquitectura centrada en TypeScript”: etapas claras, espacios ordenados para el código y notas de recuperación que perduran tras la transferencia de responsabilidades. La etapa de Resumen funciona mejor si se considera como una superficie medible. Registre una transcripción clave, un caso de fallo y la nota de reversión antes de ampliar el alcance. Anote los tiempos y el costo en tokens o consultas junto a los resultados funcionales. La visibilidad temprana del costo evita facturas inesperadas cuando el proceso pasa de la demostración a entornos compartidos.

Parte 1: La arquitectura del compilador de consultas

En la etapa de Consulta de la Parte 1, defina las entradas, el responsable del paso y los criterios de finalización antes de modificar el código. Los operadores deben poder volver a ejecutar el paso a partir de un punto de control conocido sin tener que adivinar el estado oculto. Mantenga la configuración fuera del código de la aplicación. Los archivos de entorno, los almacenes de secretos y las banderas de funcionalidad deben estar en un lugar donde los operadores puedan auditarlos sin necesidad de leer todo el sistema. Añada una prueba de smoke que ejecute la ruta crítica en CI utilizando fixtures, y no APIs pagadas en tiempo real, siempre que lo permitan los presupuestos.

Por qué Rust era lento (a pesar de ser rápido)

En la etapa de “¿Por qué Rust era lento?”, defina las entradas, el responsable del paso y los criterios de finalización antes de modificar el código. Los operadores deben poder volver a ejecutar el paso a partir de un punto de control conocido sin tener que adivinar el estado oculto. Documente tanto la ruta óptima como la ruta de recuperación. Las reintentos, los controles humanos y el manejo de mensajes no entregados forman parte del producto, no son mejoras posteriores. Añada una prueba de humo que ejecute la ruta crítica en CI con fixtures, y no con APIs pagadas en tiempo real, siempre que lo permitan los presupuestos.

TypeScript Client
    ↓ (serialize to JSON)
Rust Query Engine (14MB binary)
    ↓ (deserialize JSON)
    ↓ (execute query plan)
    ↓ (serialize results to JSON)
TypeScript Client (deserialize)
    ↓ (use results)

Nueva arquitectura: Compilador de consultas (TypeScript + WASM)

En la etapa del Compilador de Consultas de Nueva Arquitectura, defina las entradas, el responsable del paso y los criterios de finalización antes de modificar el código. Los operadores deben poder volver a ejecutar el paso a partir de un punto de control conocido sin tener que adivinar el estado oculto. Prefiera unidades pequeñas y verificables en lugar de scripts extensos. Cuando un paso falla, el error debe indicar una única responsabilidad y no un proceso complicado. Añada una prueba de funcionamiento básica que ejerza la ruta crítica en CI con datos de prueba, y no con APIs pagadas en tiempo real, siempre que lo permitan los presupuestos. En la etapa del Compilador de Consultas de Nueva Arquitectura, defina las entradas, el responsable del paso y los criterios de finalización antes de modificar el código. Los operadores deben poder volver a ejecutar el paso a partir de un punto de control conocido sin tener que adivinar el estado oculto. Registre los tiempos de ejecución y el costo en tokens o consultas junto con los resultados funcionales. La visibilidad temprana del costo evita facturas inesperadas cuando el proceso pasa de la versión de demostración al entorno compartido.

TypeScript Client
    ↓ (Query Compiler compiles query plan)
    ↓ (execute plan in same process)
    ↓ (return results immediately)
TypeScript Client (no deserialization needed)
    ↓ (use results)
Operation: findMany with 25,000 records

Rust Query Engine: 185 ms
Query Compiler: 55 ms
Improvement: 3.4x faster (130ms serialization eliminated)
---
Operation: findMany with take=2000
Rust Query Engine: 6.6 ms
Query Compiler: 3.1 ms
Improvement: 2.1x faster
---
Operation: Complex JOINs
Rust Query Engine: 207 ms
Query Compiler: 130 ms
Improvement: 1.6x faster

Reducción del tamaño del paquete: disminución del 85–90%

Al trabajar en la fase de reducción del tamaño del paquete al 85%, anote primero el contrato: los datos de entrada requeridos, la señal de éxito y qué ocurre en caso de fallo parcial. Esa lista de verificación mantiene honestas las futuras modificaciones del código. Guarde la configuración fuera del código de la aplicación. Los archivos de entorno, los almacenes de secretos y las banderas de funcionalidad deben encontrarse en un lugar donde los operadores puedan auditarlos sin tener que leer todo el sistema. Escriba un breve manual de operaciones: cómo rotar claves, cómo vaciar la cola y cómo revertir la última ingestión.

Parte 2: Estabilidad de Prisma 6.0/7.0 y cambios que rompen la compatibilidad

Al trabajar en la etapa 2 de Prisma 6, anote primero el contrato: las entradas requeridas, la señal de éxito y qué ocurre en caso de fallo parcial. Esa lista de verificación ayuda a mantener honestos los cambios posteriores en el código. Documente junto con ello la ruta de éxito y la ruta de recuperación. Las reintentos, los controles humanos y el manejo de mensajes no entregados forman parte del producto, no son mejoras posteriores. Escriba un breve manual de operaciones: cómo rotar las claves, cómo vaciar la cola y cómo revertir la última ingestión.

Migración desde v5: Cambios en el esquema de PostgreSQL

Al trabajar en la fase de migración desde PostgreSQL v5, anote primero el contrato: los datos de entrada requeridos, la señal de éxito y qué ocurre en caso de fallo parcial. Esa lista de verificación garantiza que los cambios posteriores en el código sean transparentes. Prefiera unidades pequeñas y verificables a scripts extensos. Cuando un paso falla, el fallo debe referirse a una única responsabilidad y no a un proceso complicado. Escriba un breve manual de operaciones: cómo rotar claves, cómo vaciar la cola y cómo revertir la última inserción. Al trabajar en la fase de migración desde PostgreSQL v5, anote primero el contrato: los datos de entrada requeridos, la señal de éxito y qué ocurre en caso de fallo parcial. Esa lista de verificación garantiza que los cambios posteriores en el código sean transparentes. Registre los tiempos de ejecución y el costo de tokens o consultas junto con los resultados funcionales. Tener visibilidad del costo desde el principio evita facturas inesperadas cuando se pasa de entornos de demostración a entornos compartidos.

-- Prisma v5
CREATE TABLE "_PostToTag" (
    "A" INTEGER NOT NULL,
    "B" INTEGER NOT NULL
);

CREATE UNIQUE INDEX "_PostToTag_AB_unique" ON "_PostToTag"("A", "B");
-- Prisma v6+
CREATE TABLE "_PostToTag" (
    "A" INTEGER NOT NULL,
    "B" INTEGER NOT NULL,

    CONSTRAINT "_PostToTag_AB_pkey" PRIMARY KEY ("A", "B")
);
ALTER TABLE "_PostToTag"
  DROP CONSTRAINT "_PostToTag_AB_unique",
  ADD CONSTRAINT "_PostToTag_AB_pkey" PRIMARY KEY ("A", "B");

Manejo de errores: eliminación de NotFoundError

La etapa de eliminación de Error Handling NotFoundError funciona mejor cuando se trata como una superficie medible. Capture una transcripción ejemplar, un caso de fallo y la nota de reversión antes de ampliar el alcance. Mantenga la configuración fuera del código de la aplicación. Los archivos de entorno, los almacenes de secretos y las banderas de funcionalidad deben estar en un lugar donde los operadores puedan auditarlos sin tener que leer todo el sistema. Fije las versiones de las dependencias y registre el digest de la imagen que ejecutó la demostración. La reproducibilidad es mejor que el conocimiento tribal.

import { NotFoundError } from '@prisma/client';

try {
  const user = await prisma.user.findUniqueOrThrow({
    where: { id: 'invalid' }
  });
} catch (e) {
  if (e instanceof NotFoundError) {
    // Handle not found
  }
}
import { PrismaClientKnownRequestError } from '@prisma/client';

try {
  const user = await prisma.user.findUniqueOrThrow({
    where: { id: 'invalid' }
  });
} catch (e) {
  if (e instanceof PrismaClientKnownRequestError && e.code === 'P2025') {
    // P2025 = record not found
  }
}
// Codemod-friendly pattern
const isNotFound = (error: unknown) =>
  error instanceof PrismaClientKnownRequestError && error.code === 'P2025';

// Old code
if (e instanceof NotFoundError) { ... }
// New code
if (isNotFound(e)) { ... }

Palabras clave reservadas: async, await, using

Las palabras clave reservadas async await stage funcionan mejor cuando se tratan como una superficie medible. Capture un registro ideal, un caso de fallo y la nota de reversión antes de ampliar el alcance. Documente tanto el camino óptimo como el de recuperación. Las reintentos, los controles humanos y el manejo de correos no entregados forman parte del producto, no son mejoras posteriores. Fije las versiones de dependencias y registre el resumen de la imagen que ejecutó la demostración. La reproducibilidad es mejor que el conocimiento tribal.

// ❌ Will not compile in v6+
model async {
  id Int @id
}

// ✅ Renamed
model AsyncTask {
  id Int @id
}

Parte 3: Nuevas funciones en v6 y v7

La etapa de Nuevas Funcionalidades en la Parte 3 funciona mejor cuando se trata como una superficie medible. Capture un transcripte ejemplar, un caso de fallo y la nota de reversión antes de ampliar el alcance. Prefiera unidades pequeñas y verificables en lugar de scripts extensos. Cuando un paso falla, el fallo debe apuntar a una única responsabilidad y no a un proceso complicado. Fije las versiones de las dependencias y registre el resumen de la imagen que ejecutó la demostración. La reproducibilidad es mejor que el conocimiento basado en prácticas internas.

Búsqueda de Texto Completo: Pasando de la versión de previsualización

La búsqueda de texto completo en la etapa final funciona mejor cuando se trata como una superficie medible. Capture un registro exitoso, un caso de fallo y la nota de reversión antes de ampliar el alcance. Considere esta etapa como un contrato entre las entradas y las salidas validadas. Asigne nombres a los artefactos, defina verificaciones de éxito y rechace completaciones parciales silenciosas. Fije las versiones de las dependencias y registre el resumen de la imagen que ejecutó la demostración. La reproducibilidad es mejor que el conocimiento tribal.

datasource db {
  provider = "mysql"
  url      = env("DATABASE_URL")
}

model Post {
  id       Int    @id @default(autoincrement())
  title    String
  body     String

  @@fulltext([title, body])
}


// Query using full-text search
const results = await prisma.post.findMany({
  where: {
    OR: [
      { title: { search: 'database' } },
      { body: { search: 'database' } }
    ]
  }
});
generator client {
  provider        = "prisma-client-js"
  previewFeatures = ["fullTextSearchPostgres"]
}

Vistas SQL con relaciones (v6+)

La etapa de Vistas SQL con relaciones funciona mejor cuando se trata como una superficie medible. Capture un registro ideal, un caso de fallo y la nota de reversión antes de ampliar el alcance. Registre los tiempos y el costo de tokens o consultas junto con los resultados funcionales. La visibilidad temprana del costo evita facturas inesperadas cuando el proceso pasa de la demostración a entornos compartidos. Fije las versiones de dependencias y registre el resumen de la imagen que ejecutó la demostración. La reproducibilidad es mejor que el conocimiento basado en prácticas internas.

view UserStats {
  id              Int     @id
  userId          Int
  totalPosts      Int
  averageRating   Float

  user            User    @relation(fields: [userId], references: [id])
}

model User {
  id       Int        @id
  name     String
  stats    UserStats?  // Relation from model to view
}
const user = await prisma.user.findUnique({
  where: { id: 1 },
  include: { stats: true }  // Works now!
});

Soporte para pgvector (acceso anticipado en v6.6+)

La fase de acceso anticipado de soporte para pgvector funciona mejor cuando se trata como una superficie medible. Capture un registro ejemplar, un caso de fallo y la nota de reversión antes de ampliar el alcance. Mantenga la configuración fuera del código de la aplicación. Los archivos de entorno, los almacenes de secretos y las banderas de funcionalidad deben estar en un lugar donde los operadores puedan auditarlos sin tener que leer todo el sistema. Fije las versiones de las dependencias y registre el resumen del archivo de imagen que ejecutó la demostración. La reproducibilidad es mejor que el conocimiento basado en experiencias individuales.

model Embedding {
  id    Int     @id @default(autoincrement())
  text  String
  vector Unsupported("vector")?  // pgvector type
}
// Query embeddings (requires pgvector extension)
const similar = await prisma.$queryRaw`
  SELECT * FROM "Embedding"
  ORDER BY vector <-> $1
  LIMIT 5
`;

prisma.config.ts (v6.4+)

La etapa prisma config ts v6 funciona mejor cuando se trata como una superficie medible. Capture un registro ideal, un caso de fallo y la nota de reversión antes de ampliar el alcance. Documente tanto el camino óptimo como el de recuperación. Las reintentos, los controles humanos y el manejo de mensajes no entregados forman parte del producto, no son mejoras posteriores. Fije las versiones de las dependencias y registre el resumen del imagen que ejecutó la demostración. La reproducibilidad es mejor que el conocimiento tribal.

// prisma.config.ts
import { defineConfig } from '@prisma/internals';

export default defineConfig({
  datasources: {
    db: {
      url: process.env.DATABASE_URL,
      directUrl: process.env.DIRECT_DATABASE_URL
    }
  },
  client: {
    skipValidation: false
  },
  accelerate: {
    enabled: true
  }
});

Rediseño de Prisma Studio (v7+)

La etapa de Prisma Studio Redesign v7 funciona mejor cuando se trata como una superficie medible. Capture un registro ideal, un caso de fallo y la nota de reversión antes de ampliar el alcance. Prefiera unidades pequeñas y verificables en lugar de scripts extensos. Cuando un paso falla, el fallo debe apuntar a una sola responsabilidad y no a un proceso complicado. Fije las versiones de las dependencias y registre el resumen de la imagen que ejecutó la demostración. La reproducibilidad es mejor que el conocimiento basado en experiencias internas. La etapa de Prisma Studio Redesign v7 funciona mejor cuando se trata como una superficie medible. Capture un registro ideal, un caso de fallo y la nota de reversión antes de ampliar el alcance. Registre los tiempos y el costo de tokens o consultas junto con los resultados funcionales. Tener visibilidad del costo desde el principio evita facturas inesperadas cuando se pasa de la demostración a entornos compartidos.

Parte 4: Estrategia de migración v5 → v7

En la fase de Estrategia de Migración 4, defina las entradas, el responsable de cada paso y los criterios de finalización antes de modificar el código. Los operadores deben poder volver a ejecutar el paso a partir de un punto de control conocido, sin tener que adivinar el estado oculto. Mantenga la configuración fuera del código de la aplicación. Los archivos de entorno, los almacenes de datos secretos y las banderas de funcionalidad deben estar en un lugar donde los operadores puedan auditarlos sin necesidad de leer todo el sistema. Añada una prueba de funcionamiento básica que ejecute la ruta crítica en CI utilizando configuraciones fijas, y no APIs pagadas en tiempo real, siempre que lo permitan los presupuestos.

Actualización paso a paso

En la fase de actualización paso a paso, defina las entradas, el responsable de cada paso y los criterios de finalización antes de modificar el código. Los operadores deben poder volver a ejecutar el paso a partir de un punto de control conocido sin tener que adivinar el estado oculto. Documente tanto la ruta óptima como la ruta de recuperación. Las intentonas repetidas, los controles humanos y el manejo de mensajes no entregados forman parte del producto, no son mejoras posteriores. Añada una prueba de funcionamiento básica que ejecute la ruta crítica en CI utilizando configuraciones fijas, y no APIs pagadas en tiempo real, siempre que lo permitan los presupuestos.

npm install @prisma/client@latest
npm install -D prisma@latest
# Check if you use any deprecated patterns
grep -r "NotFoundError" src/  # Needs updating
grep -r "async\|await\|using" prisma/schema.prisma  # Can't be model names
npx prisma migrate dev --name upgrade_to_v7
// Replace NotFoundError
- if (e instanceof NotFoundError) {
+ if (e instanceof PrismaClientKnownRequestError && e.code === 'P2025') {
npm test
npx prisma db push --preview-features  # Validate schema

Estrategia de reversión

En la fase de Estrategia de Retroceso, defina las entradas, el responsable del paso y los criterios de finalización antes de modificar el código. Los operadores deben poder volver a ejecutar el paso a partir de un punto de control conocido, sin tener que adivinar el estado oculto. Prefiera unidades pequeñas y verificables en lugar de scripts extensos. Cuando un paso falla, el error debe indicar una única responsabilidad y no un proceso complicado. Añada una prueba de funcionamiento básica que ejecute la ruta crítica en CI utilizando configuraciones fijas, y no APIs pagadas en tiempo real, siempre que lo permitan los presupuestos.

# Revert migration
npx prisma migrate resolve --rolled-back upgrade_to_v7

# Downgrade Prisma
npm install @prisma/client@5
npm install -D prisma@5
# Regenerate Prisma Client
npx prisma generate

Parte 5: Impacto en el rendimiento en el mundo real

Inicio en frío de servidores sin servidor: ejemplo con Lambda

Package size: 250MB
AWS Lambda cold start time: 3.2 seconds
Database query time: 450ms (serialization overhead)
Total latency per request: 3.65 seconds
Package size: 8MB
AWS Lambda cold start time: 0.8 seconds (75% faster)
Database query time: 130ms (70% faster)
Total latency per request: 0.93 seconds (75% faster)

Búsqueda de productos en comercio electrónico

Query time: 2.3 seconds
Server CPU: 45%
Memory: 580MB
Cost per request: ~$0.0008
Query time: 640ms (3.6x faster)
Server CPU: 12%
Memory: 145MB (75% reduction)
Cost per request: ~$0.0002 (75% cheaper)

Conclusión

Lista de verificación operativa