Главная / Статьи

Prisma ORM 6.0/7.0: революция в компиляторе запросов — 3,4 раза

Prisma ORM 6 и 7 заменяют движок запросов на Rust на компилятор запросов на TypeScript: почему Rust был медленным, новая архитектура и экономия размера пакета.

Издатель: REACTAPP.TOP11 мин чтения2440 слов

Источники: Prisma ORM 6.0/7.0: The Query Compiler Revolution — 3.4x Faster Queries, 90% Smaller Bundles, and TypeScript-First Architecture

Используйте это как переработанную версию материалов книги «Prisma ORM 6.0/7.0: The Query Compiler Revolution — 3.4x Faster Queries, 90% Smaller Bundles, and TypeScript-First Architecture», ориентированную на операторов: четкие этапы, упорядоченные блоки кода и записи о восстановлении, которые сохраняются при передаче задач. Этап Обзора наиболее эффективен, если рассматривать его как измеримую основу. Сначала зафиксируйте один идеальный пример работы, один случай сбоя и записи о возврате к предыдущему состоянию, прежде чем расширять объем работ. Записывайте время выполнения и стоимость токенов или запросов рядом с функциональными результатами. Отображение стоимости на ранних этапах предотвращает неожиданные расходы при переходе от демо-среды к общедоступным средам.

Часть 1: Архитектура компилятора запросов

На этапе запроса первой части необходимо определить входные данные, ответственного за выполнение шага и критерии завершения перед изменением кода. Операторы должны иметь возможность перезапустить шаг с известной точки контроля, не догадываясь о скрытом состоянии. Храните конфигурацию вне кода приложения. Файлы среды, хранилища секретов и флаги функций должны находиться в одном месте, чтобы операторы могли их проверять, не читая весь код. Каждый раз, когда это позволяют бюджетные ограничения, добавляйте тест на базовую работоспособность, который проверяет критически важный путь в процессе интеграционного тестирования с использованием фикстур, а не реальных платных API.

Почему Rust был медленным (несмотря на свою скорость)

На этапе «Почему Rust работает медленно» необходимо определить входные данные, ответственного за выполнение шага и критерии завершения перед изменением кода. Операторы должны иметь возможность перезапустить шаг с известной точки контроля, не догадываясь о скрытом состоянии. Необходимо задокументировать как успешный, так и восстановительный сценарии работы. Повторные попытки, проверки человеком и обработка неработоспособных сообщений являются частью продукта, а не этапом последующей доработки. При наличии бюджета следует добавить тест на базе фикстчеров в системе CI, который проверяет критический путь работы, а не использовать реальные платные API.

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

Новая архитектура: Компилятор запросов (TypeScript + WASM)

На этапе компилятора запросов новой архитектуры необходимо определить входные данные, ответственного за выполнение шага и критерии завершения перед внесением изменений в код. Операторы должны иметь возможность перезапустить шаг с известной точки контроля, не догадываясь о скрытом состоянии. Предпочтительнее использовать небольшие, тестируемые единицы кода вместо обширных скриптов. При сбое шага он должен указывать на конкретную причину, а не на сложную структуру обработки данных. При наличии бюджета добавляйте тесты на базе фикстчеров в системе CI для проверки критического пути обработки, а не с использованием реальных платных API. На этапе компилятора запросов новой архитектуры необходимо определить входные данные, ответственного за выполнение шага и критерии завершения перед внесением изменений в код. Операторы должны иметь возможность перезапустить шаг с известной точки контроля, не догадываясь о скрытом состоянии. Регистрируйте время выполнения и стоимость токенов или запросов вместе с функциональными результатами. Отображение стоимости на ранних этапах предотвращает неожиданные счета при переходе от демо-режима к общей среде.

nts.

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

Сокращение размера пакета: снижение на 85–90%

При работе над этапом сокращения размера пакета на 85% сначала запишите условия контракта: необходимые входные данные, сигнал о успешном выполнении и действия при частичной неудаче. Такой чек-лист поможет сохранять честность при последующих изменениях кода. Храните конфигурацию вне кода приложения. Файлы среды, хранилища секретов и флаги функций должны находиться в одном месте, чтобы операторы могли их проверять, не читая весь код. Напишите краткий руководство: как обновлять ключи, как опустошать очередь, как откатить последнюю загрузку.

Часть 2: Стабильность Prisma 6.0/7.0 и изменения, влияющие на работу

При работе над этапом Part 2 Prisma 6 сначала запишите контракт: необходимые входные данные, сигнал о успешном выполнении и действия при частичной неудаче. Такой чек-лист поможет сохранять честность при последующих изменениях кода. Документируйте одновременно успешный сценарий работы и сценарий восстановления. Повторные попытки, проверки человеком и обработка неработоспособных сообщений являются частью продукта, а не элементами последующей доработки. Напишите краткое руководство: как обновлять ключи, как опустошать очередь, как откатывать последнюю загрузку.

Миграция с v5: изменения в схеме PostgreSQL

При работе над этапом миграции с PostgreSQL версии v5 сначала запишите условия взаимодействия: необходимые параметры входных данных, сигнал о успешном выполнении и действия при частичной неудаче. Такой список поможет сохранять честность последующих изменений в коде. Предпочитайте небольшие, тестируемые модули вместо обширных скриптов. Если какой-то шаг не сработает, причина неудачи должна указывать на конкретную ответственность, а не на запутанную цепочку операций. Напишите краткий руководство: как обновлять ключи, как опустошать очередь, как откатить последнюю процедуру загрузки данных. При работе над этапом миграции с PostgreSQL версии v5 сначала запишите условия взаимодействия: необходимые параметры входных данных, сигнал о успешном выполнении и действия при частичной неудаче. Такой список поможет сохранять честность последующих изменений в коде. Рядом с функциональными результатами записывайте время выполнения операций, а также стоимость токенов или запросов. Отслеживание затрат с самого начала предотвращает неожиданные расходы при переходе с демо-среды в общедоступные среды.

-- 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");

Обработка ошибок: устранение NotFoundError

Этап устранения ошибки NotFoundError работает наилучшим образом, если рассматриваться как измеримая часть процесса. Соберите один эталонный пример работы, один случай сбоя и записку о возврате к предыдущему состоянию перед расширением объёма работ. Храните конфигурацию вне кода приложения. Файлы среды, хранилища секретов и флаги функций должны находиться в одном месте, чтобы операторы могли их проверять, не читая весь код. Зафиксируйте версии зависимостей и запишите хэш изображения, с использованием которого выполнялась демонстрация. Воспроизводимость важнее коллективных знаний.

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)) { ... }

Зарезервированные ключевые слова: async, await, using

Ключевые слова async await работают наилучшим образом, когда их рассматривают как измеримый показатель. Соберите один идеальный пример работы, один случай сбоя и запись о возврате к предыдущему состоянию перед расширением объёма тестирования. Документируйте одновременно успешный сценарий работы и сценарий восстановления. Повторные попытки, проверки человеком и обработка неработающих сообщений являются частью продукта, а не последующими улучшениями. Фиксируйте версии зависимостей и записывайте хэш изображения, использованного для демонстрации. Воспроизводимость важнее коллективных знаний.

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

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

Часть 3: Новые функции в v6 и v7

Этап «Новые функции, часть 3» работает наилучшим образом, если рассматривать его как измеримую основу. Соберите один идеальный пример работы, один случай сбоя и записку о возврате к предыдущему состоянию перед расширением объёма работ. Предпочитайте небольшие, тестируемые единицы кода вместо обширных скриптов. Когда какой-то шаг сбивается, причина сбоя должна указывать на конкретную ответственность, а не на запутанную цепочку операций. Фиксируйте версии зависимостей и записывайте хэш изображения, с использованием которого выполнялась демонстрация. Воспроизводимость важнее коллективных знаний.

Поиск полного текста: переход от превью к полноценному использованию

Поиск по полному тексту на этой стадии работает наилучшим образом, если рассматривать его как измеримую величину. Соберите один пример успешного выполнения, один случай сбоя и запись о возврате к предыдущему состоянию перед расширением объема работ. Рассматривайте эту стадию как контракт между входными данными и проверенными результатами. Дайте названия создаваемым объектам, определите критерии успеха и не соглашайтесь на молчаливое частичное выполнение задачи. Фиксируйте версии зависимостей и записывайте хэш изображения, с использованием которого выполнялась демонстрация. Воспроизводимость важнее коллективных знаний.

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"]
}

SQL-просмотры с связями (v6+)

Этап работы с SQL-видами и связями между ними наилучшим образом функционирует, если рассматривать его как измеримую основу. Соберите один идеальный пример работы, один случай сбоя и запись о возврате к предыдущему состоянию перед расширением объема работ. Записывайте время выполнения, а также стоимость использования токенов или запросов вместе с функциональными результатами. Отслеживание затрат на раннем этапе помогает избежать неожиданных счетов при переходе от демо-среды к общедоступным средам. Фиксируйте версии компонентов, от которых зависит работа системы, а также хэш-сумму изображения, использованного для демонстрации. Воспроизводимость важнее устного опыта сотрудников.

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!
});

Поддержка pgvector (ранний доступ с версии 6.6+)

Режим раннего доступа к pgvector Support работает наилучшим образом, если рассматривать его как измеримую среду. Соберите один идеальный пример работы, один случай сбоя и записку о возврате к предыдущей версии перед расширением объёма работ. Храните конфигурацию вне кода приложения. Файлы среды, хранилища секретов и флаги функций должны находиться в одном месте, чтобы операторы могли их проверять, не читая весь код. Зафиксируйте версии зависимостей и сохраните хэш изображения, с которого запускалась демонстрация. Воспроизводимость важнее коллективных знаний.

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+)

Конфигурация Prisma Config TS v6 в режиме stage работает наилучшим образом, когда её рассматривают как измеримую поверхность. Соберите один идеальный пример работы, один случай сбоя и записку о возврате к предыдущему состоянию перед расширением объёма работ. Документируйте одновременно успешный сценарий выполнения и сценарий восстановления. Повторные попытки, проверки человеком и обработка неработающих сообщений являются частью продукта, а не последующими доработками. Фиксируйте версии зависимостей и записывайте хэш изображения, с использованием которого выполнялась демонстрация. Воспроизводимость важнее коллективных знаний.

// 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
  }
});

Переделка Prisma Studio (v7+)

Этап Prisma Studio Redesign v7 работает наилучшим образом, если рассматривать его как измеримую среду. Соберите один идеальный пример работы, один случай сбоя и записку о возврате к предыдущему состоянию перед расширением объема работ. Предпочитайте небольшие, тестируемые единицы кода вместо обширных скриптов. При сбое какой-либо операции причина должна быть связана с конкретной функцией, а не с запутанной цепочкой операций. Фиксируйте версии зависимостей и записывайте хэш изображения, использованного для демонстрации. Воспроизводимость важнее устного опыта команды. Этап Prisma Studio Redesign v7 работает наилучшим образом, если рассматривать его как измеримую среду. Соберите один идеальный пример работы, один случай сбоя и записку о возврате к предыдущему состоянию перед расширением объема работ. Записывайте время выполнения операций, а также стоимость токенов или запросов вместе с функциональными результатами. Отслеживание затрат на раннем этапе помогает избежать неожиданных расходов при переходе от демо-среды к общедоступным средам.

Часть 4: Стратегия миграции v5 → v7

На этапе стратегии миграции части 4 необходимо определить входные данные, ответственного за выполнение шага и критерии завершения перед изменением кода. Операторы должны иметь возможность перезапустить шаг с известной точки контроля, не догадываясь о скрытом состоянии. Храните конфигурацию вне кода приложения. Файлы среды, хранилища секретов и флаги функций должны находиться в одном месте, чтобы операторы могли их проверять, не читая весь кодовый граф. Каждый раз, когда это позволяют бюджетные ограничения, добавляйте тест на базовую работоспособность, который проверяет критически важный путь в процессе CI с использованием фикстур, а не реальных платных API.

Пошаговое обновление

На этапе пошагового обновления необходимо заранее определить входные данные, ответственного за выполнение шага и критерии завершения перед внесением изменений в код. Операторы должны иметь возможность перезапустить шаг с известной точки контроля, не догадываясь о скрытом состоянии. Необходимо задокументировать как успешный, так и восстановительный сценарии работы. Повторные попытки, проверки человеком и обработка неработоспособных сообщений являются частью продукта, а не элементами последующей доработки. При наличии бюджета следует добавлять тесты дымового типа, которые проверяют критически важные пути выполнения в рамках CI с использованием фикстчеров, а не реальных платных API.

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

Стратегия отката

На этапе стратегии отката необходимо определить входные данные, ответственного за выполнение шага и критерии завершения перед изменением кода. Операторы должны иметь возможность перезапустить шаг с известной точки контроля, не догадываясь о скрытом состоянии системы. Лучше использовать небольшие, тестируемые единицы кода вместо обширных скриптов. При сбое шага причина должна быть связана с конкретной функцией, а не с запутанной структурой обработки данных. При наличии бюджета следует добавлять тесты на базовую работоспособность, которые проверяют критически важные этапы в рамках CI с использованием фикстчеров, а не реальных платных API.

# 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

Часть 5: Влияние на производительность в реальных условиях

Холодный запуск без серверов: пример 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)

Поиск товаров в электронной коммерции

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)

Заключение

Чек-лист для операционной деятельности