Переход на Prisma ORM 7

Переводит проект с Prisma ORM 6 на 7: генератор prisma-client, prisma.config.ts, драйвер-адаптеры, ESM, явная загрузка env и всё, что в v7 убрали. Для случаев, когда SQL-проект обновляют с Prisma 6 или чинят ошибки сразу после обновления.

Базы данных и SQLПак: Скиллы Prisma259 строкprisma-upgrade-v7
Автор
Источник
prisma/skills/prisma-upgrade-v7 @ a6f1929
Лицензия
MIT · Copyright (c) 2025 Prisma

Об этом скилле

Что делает

Скилл переводит проект с Prisma ORM 6 на 7 за десять шагов. Сначала — обновить пакеты, выбрать ESM (по умолчанию) или CommonJS через moduleFormat = "cjs", поправить tsconfig.json, сменить генератор prisma-client-js на prisma-client с явным output и создать prisma.config.ts. Потом — поставить драйвер-адаптер, исправить импорты и создание клиента, заменить Prisma.validator на satisfies, сгенерировать клиент и проверить. Минимум — Node.js 20.19.0 и TypeScript 5.4.0.

Семь файлов в references/ разбирают каждое несовместимое изменение:

  • schema-changes.md — генератор, пути вывода, engineType, новые точки входа client, browser, models и enums.
  • driver-adapters.md — почему SQL-провайдерам теперь нужен адаптер; настройка для PostgreSQL, MySQL, SQLite, SQL Server, Neon и Prisma Postgres; настройки пула и SSL, которые по умолчанию отличаются от v6.
  • esm-support.md, prisma-config.md, env-variables.md — формат модулей, файл конфигурации, загрузка .env через dotenv, удалённые переменные окружения Prisma.
  • removed-features.md — middleware $use, которое заменили Client Extensions (с примерами мягкого удаления и логирования), метрики, --skip-generate и --skip-seed, migrate больше не запускает generate и сид.
  • accelerate-users.md — URL Accelerate вида prisma:// передаётся в accelerateUrl, а не в драйвер-адаптер.

Когда включать и когда не надо

Для SQL-проекта на Prisma 6, который переходит на 7, и для ошибок сразу после перехода: «Cannot find module», когда путь вывода не совпал с импортом, ошибки SSL, таймауты подключения из-за новых настроек пула.

Не для MongoDB: в Prisma 7 нет коннектора MongoDB, и скилл советует таким проектам остаться на 6 или перейти на Prisma 8 через prisma-mongodb-upgrade — скилл Prisma, которого нет в нашем каталоге. Последним стабильным релизом скилл называет 7.6.0, а примеры скилла Настройка Prisma ORM проверены на 7.10.0, так что перед фиксацией версии уточните актуальную 7.x.

Как поставить и вызвать

Команда установки ниже скачивает всю папку. Агент сам подхватывает скилл, когда речь о переходе на Prisma 7 или об ошибке v7. Вызвать вручную:

  • Claude Code: /prisma-upgrade-v7 или попросить скилл по имени.
  • Codex: $prisma-upgrade-v7.
  • Cursor: наберите / в чате Agent и выберите prisma-upgrade-v7.

Пример: /prisma-upgrade-v7 Переведи это приложение на Express с Prisma 6 на 7. У нас PostgreSQL, CommonJS и middleware $use для мягкого удаления.

Чем отличается от похожих

Настройка Prisma ORM тоже работает с Prisma 7, но оставляет приложению его версию и сюда отправляет только переход с 6 на 7. Приложение на PostgreSQL может перейти с 6 сразу на 8 через prisma-postgres-upgrade — скилл Prisma, которого нет в нашем каталоге. Команды Prisma CLI — справочник для проекта, который уже на 7. Вне набора Prisma этот переход в нашем каталоге не разбирает ни один скилл: Вывод из эксплуатации и миграции — про то, как выводить из оборота собственные системы и API, а не про мажорную версию зависимости.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/prisma-upgrade-v7/SKILL.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/SKILL.md -o ~/.claude/skills/prisma-upgrade-v7/LICENSE https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/LICENSE -o ~/.claude/skills/prisma-upgrade-v7/references/accelerate-users.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/accelerate-users.md -o ~/.claude/skills/prisma-upgrade-v7/references/driver-adapters.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/driver-adapters.md -o ~/.claude/skills/prisma-upgrade-v7/references/env-variables.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/env-variables.md -o ~/.claude/skills/prisma-upgrade-v7/references/esm-support.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/esm-support.md -o ~/.claude/skills/prisma-upgrade-v7/references/prisma-config.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/prisma-config.md -o ~/.claude/skills/prisma-upgrade-v7/references/removed-features.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/removed-features.md -o ~/.claude/skills/prisma-upgrade-v7/references/schema-changes.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/schema-changes.md
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/prisma-upgrade-v7/SKILL.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/SKILL.md -o ~/.agents/skills/prisma-upgrade-v7/LICENSE https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/LICENSE -o ~/.agents/skills/prisma-upgrade-v7/references/accelerate-users.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/accelerate-users.md -o ~/.agents/skills/prisma-upgrade-v7/references/driver-adapters.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/driver-adapters.md -o ~/.agents/skills/prisma-upgrade-v7/references/env-variables.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/env-variables.md -o ~/.agents/skills/prisma-upgrade-v7/references/esm-support.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/esm-support.md -o ~/.agents/skills/prisma-upgrade-v7/references/prisma-config.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/prisma-config.md -o ~/.agents/skills/prisma-upgrade-v7/references/removed-features.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/removed-features.md -o ~/.agents/skills/prisma-upgrade-v7/references/schema-changes.md https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/references/schema-changes.md
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','references/accelerate-users.md','references/driver-adapters.md','references/env-variables.md','references/esm-support.md','references/prisma-config.md','references/removed-features.md','references/schema-changes.md') { $p = Join-Path "$HOME\.claude\skills\prisma-upgrade-v7" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','references/accelerate-users.md','references/driver-adapters.md','references/env-variables.md','references/esm-support.md','references/prisma-config.md','references/removed-features.md','references/schema-changes.md') { $p = Join-Path "$HOME\.agents\skills\prisma-upgrade-v7" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/prisma/prisma-upgrade-v7/SKILL.md

SKILL.md

Исходник

Upgrade to Prisma ORM 7

Complete guide for migrating from Prisma ORM v6 to v7. This upgrade introduces significant breaking changes around the new prisma-client generator, driver adapters, prisma.config.ts, explicit environment loading, and generated client entrypoints.

When to Apply

Reference this skill when:

  • Upgrading from Prisma v6 to v7
  • Updating to the prisma-client generator
  • Setting up driver adapters
  • Configuring prisma.config.ts
  • Fixing import errors after upgrade

Rule Categories by Priority

Priority Category Impact Prefix
1 Schema Migration CRITICAL schema-changes
2 Database Connectivity CRITICAL driver-adapters
3 Module System CRITICAL esm-support
4 Config and Env HIGH prisma-config, env-variables
5 Removed Features HIGH removed-features
6 Accelerate HIGH accelerate-users

Quick Reference

  • schema-changes - generator migration, required output paths, generated entrypoints, and Prisma.validator replacement
  • driver-adapters - required adapter installation for SQL providers, pool differences, and Prisma Postgres adapter choices
  • esm-support - ESM-first setup plus CommonJS fallback with moduleFormat = "cjs"
  • prisma-config - creating and using prisma.config.ts
  • env-variables - explicit environment loading
  • removed-features - removed middleware, metrics, and legacy CLI behavior
  • accelerate-users - migration notes for Accelerate users

Using MongoDB? This guide does not apply

Prisma 7 has no MongoDB connector. Do not apply any step in this guide to a project with provider = "mongodb" — see the prisma-mongodb-upgrade skill for the actual decision (stay on v6 deliberately vs migrate to Prisma 8).

Important Notes

  • MongoDB projects should stay on Prisma 6.x or migrate to Prisma 8 - do not migrate MongoDB apps to Prisma 7's SQL client path (see prisma-mongodb-upgrade)
  • Node.js 20.19.0+ required
  • TypeScript 5.4.0+ required
  • Latest stable Prisma ORM version: 7.6.0

Upgrade Steps Overview

  1. Update packages to v7
  2. Choose your module format (esm by default, cjs if needed)
  3. Update TypeScript configuration
  4. Update the schema generator block
  5. Create prisma.config.ts
  6. Install and configure a driver adapter for SQL providers
  7. Update Prisma Client imports
  8. Update client instantiation
  9. Replace deprecated helper patterns like Prisma.validator
  10. Run prisma generate and test

Quick Upgrade Commands

# Update packages
npm install @prisma/client@7
npm install -D prisma@7

# Install a driver adapter (PostgreSQL or Prisma Postgres via direct TCP)
npm install @prisma/adapter-pg pg

# Install dotenv for env loading
npm install dotenv

# Regenerate client
npx prisma generate

Breaking Changes Summary

Change v6 v7
Module format Implicit / mixed ESM-first, moduleFormat = "cjs" supported
Generator provider prisma-client-js prisma-client is the default, while prisma-client-js still exists for legacy setups
Output path Auto (node_modules) Required explicit
Driver adapters Optional Required for SQL providers
Config file .env + schema prisma.config.ts
Env loading Automatic Manual (dotenv)
Generated entrypoints Single package export client, browser, models, enums entrypoints
Type-safe query fragments Prisma.validator() TypeScript satisfies
Middleware $use() Client Extensions
Metrics Preview feature Removed

Rule Files

Detailed migration guides for each breaking change:

references/esm-support.md        - ESM and CommonJS configuration
references/schema-changes.md     - Generator, output, imports, and generated entrypoints
references/driver-adapters.md    - Required driver adapter setup
references/prisma-config.md      - New configuration file
references/env-variables.md      - Environment variable loading
references/removed-features.md   - Middleware, metrics, and CLI flags
references/accelerate-users.md   - Special handling for Accelerate

Step-by-Step Migration

1. Update package.json for ESM-first projects

{
  "type": "module"
}

If you need to stay on CommonJS, keep your app as CJS and set moduleFormat = "cjs" in the generator block instead of forcing ESM.

2. Update tsconfig.json

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "bundler",
    "target": "ES2023",
    "strict": true,
    "esModuleInterop": true
  }
}

3. Update schema.prisma

// Before (v6)
generator client {
  provider = "prisma-client-js"
}

// After (v7)
generator client {
  provider = "prisma-client"
  output   = "../generated/prisma"
  // Optional if you need CommonJS:
  // moduleFormat = "cjs"
}

4. Create prisma.config.ts

import 'dotenv/config'
import { defineConfig, env } from 'prisma/config'

export default defineConfig({
  schema: 'prisma/schema.prisma',
  migrations: {
    path: 'prisma/migrations',
  },
  datasource: {
    url: env('DATABASE_URL'),
  },
})

5. Install a driver adapter (SQL providers only)

# PostgreSQL
npm install @prisma/adapter-pg pg

# MySQL
npm install @prisma/adapter-mariadb mariadb

# SQLite
npm install @prisma/adapter-better-sqlite3 better-sqlite3

# Prisma Postgres in standard Node.js apps (recommended)
npm install @prisma/adapter-pg pg

# Prisma Postgres serverless driver (edge/serverless)
npm install @prisma/adapter-ppg @prisma/ppg

# Neon
npm install @prisma/adapter-neon

MongoDB does not have a SQL @prisma/adapter-* package in the published Prisma 7.6.0 packages. If you're upgrading a MongoDB project, stop and keep that project on the latest Prisma 6.x release instead of following the standard Prisma 7 migration path.

6. Update client instantiation

// Before (v6)
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()

// After (v7)
import { PrismaClient } from '../generated/prisma/client'
import { PrismaPg } from '@prisma/adapter-pg'

const adapter = new PrismaPg({
  connectionString: process.env.DATABASE_URL
})

const prisma = new PrismaClient({ adapter })

7. Replace Prisma.validator with satisfies

import { Prisma } from '../generated/prisma/client'

const userSelect = {
  id: true,
  email: true,
  name: true,
} satisfies Prisma.UserSelect

8. Run migrations and generate

npx prisma generate
npx prisma migrate dev  # if needed

Troubleshooting

"Cannot find module" errors

  • Check that the generator output path matches your import path
  • Ensure prisma generate ran successfully

SSL certificate errors

  • Add ssl: { rejectUnauthorized: false } to the adapter config if you need to preserve old behavior
  • Or configure your certificates properly with NODE_EXTRA_CA_CERTS / OpenSSL CA settings

Connection timeout issues

  • Driver adapters use the underlying driver's defaults, which differ from v6
  • Configure pool settings explicitly on the adapter if needed

Resources

How to Use

Follow references/schema-changes.md and references/driver-adapters.md first, then apply the remaining reference files based on your project setup.

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Prisma