できない.dev

Prisma ORM を 6 から 7 に上げると動かなくなること

Prisma ORM を 6 から 7 に上げると、schema.prisma の url が P1012 で止まり、new PrismaClient() はドライバーアダプター無しでは作れず、.env も自動では読まれない。
SQLite の file:./dev.db も prisma/ の下を指さなくなる。
6.19 と 7.10 で打ち比べた 9 つの変更点と直し方をまとめる。

公開:

prisma@6 と @prisma/client@6 を入れたプロジェクトと、prisma@7・@prisma/client@7 に @prisma/adapter-better-sqlite3@7 と dotenv を足したプロジェクトを並べ、同じコマンドを打ち比べた。
各節の出力は「v6 では」「v7 に上げると」「v7 で直すと」の 3 段で並ぶ。
旧版は 6 系の最新の 6.19.3、新版は 7 系の最新の 7.10.1 である。

データベースは、コンテナの中で完結する SQLite のファイルにした。
アプリのコードは TypeScript で書き、tsx で動かしている。
プロジェクトは npm init -y で作ったので、package.json は "type": "commonjs" のままである。

v6 のプロジェクトは、6 のころに多かった素の形にした。
schema.prisma のジェネレーターは prisma-client-js で、datasource に url = env("DATABASE_URL") を書き、.env に DATABASE_URL="file:./dev.db" を置いた。
アプリは new PrismaClient() で作る。

7 は、この形の schema.prisma の url で真っ先に止まる。
v6 のファイルのままだと、どの節も同じエラーになって、その節の変更が見えない。
そこで v7 の段は、その節の直し方だけを外し、ほかの節の直し方を済ませたプロジェクトで打った。
たとえば「.env を自動で読まなくなった」の節の v7 の段は、prisma.config.ts を置いてアダプターも渡したうえで、import "dotenv/config" だけを抜いてある。

2026-11-13 の時点で、npm の prisma の dist-tags は、latest が Prisma ORM 8 のリリース候補の 8.0.0-rc.33 を、prev が 7.10.1 を指していた(npm view prisma dist-tags)。
公式の移行ガイドは、npm install -D prisma@7 と npm install @prisma/client@7 で入れている。
このページも prisma@7 と @prisma/client@7 のように版を付けて入れた。

動かなくなる原因は 4 つに分かれる。

  • 接続の設定が schema.prisma と .env から離れた。
    CLI は prisma.config.ts から接続先を読み、アプリはドライバーアダプターに URL を渡す。
    どちらも .env を自分では読まない。
    SQLite の相対パスが指す場所も変わった。
  • 自動で走っていた prisma generate と seed が、走らなくなった。
  • package.json の "prisma" の設定と、CLI のオプションのいくつかが消えた。
  • 6 で非推奨になっていた metrics のプレビュー機能が消えた。

公式の移行ガイドは、package.json に "type": "module" を書くことと、ジェネレーターを prisma-client に替えて output を書くことを求めている。
output は必須になったと書き、prisma-client-js は将来の版で外すとしている。
このページの v7 の段は、prisma-client-js のまま output を書かず、"type": "commonjs" で動かした。
7.10.1 はこの形でもクライアントを node_modules/@prisma/client に生成し、警告も出さなかった(最初の節の「v7 で直すと」の段)。

移行ガイドは、ミドルウェアの prisma.$use の削除も 7 の変更に挙げている。
6.14.0 のリリースノートによると、$use は 6.14.0 で無くなっている。
6.19 から上げるなら、7 で新たに止まることはない。

公式の移行ガイドにある変更のうち、PostgreSQL などほかのデータベースで起きる次のものは打っていない。

  • アダプターに替わって、接続プールの既定値がドライバーのものになった。
    pg は既定では接続のタイムアウトが無い(6 は 5 秒だった)。
  • SSL の証明書の検証が厳しくなり、P1010 で止まることがある。
  • schema.prisma の directUrl が無くなった(7.0.0 のリリースノート)。
  • Prisma Accelerate の URL の渡し方が変わった。
  • MongoDB は 7 で使えない。

SQLite で打てる変更のうち、次のものも打っていない。

  • migrate dev と db push の --skip-generate、migrate dev の --skip-seed が無くなった。
  • db push も generate を走らせなくなった。
    このページで見せたのは npm ci と migrate dev である。
  • migrate diff の --shadow-database-url が無くなり、シャドーデータベースは prisma.config.ts に書くようになった。
  • pnpm 10 以降で入れるなら、better-sqlite3 のビルドのスクリプトを許可する必要がある(公式の移行ガイド)。
  • PRISMA_CLIENT_ENGINE_TYPE などの PRISMA_ で始まる環境変数のいくつかと、prisma generate の --no-engine などのオプションが消えた(7.0.0 のリリースノート)。
  • 6 でプレビュー機能のアダプターを使っていたなら、PrismaBetterSQLite3 が PrismaBetterSqlite3 に改名されている。
  • Node.js は 20.19.0 以上、TypeScript は 5.4.0 以上が要る。

schema.prisma の datasource に url を書けなくなった

7 は、schema.prisma の datasource に url があると、schema の検査で P1012 になる。
v7 の段では、migrate dev がマイグレーションを作る前に止まった。
メッセージは、接続先を prisma.config.ts に移し、クライアントにはアダプターを渡すよう求めている。

v6 では

$ cat prisma/schema.prisma
generator client {
  provider = "prisma-client-js"
}
 
datasource db {
  provider = "sqlite"
  url      = env("DATABASE_URL")
}
 
model User {
  id    Int     @id @default(autoincrement())
  email String  @unique
  name  String?
}
$ npx prisma migrate dev --name init
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
SQLite database dev.db created at file:./dev.db
 
Applying migration `20261113014509_init`
 
The following migration(s) have been created and applied from new schema changes:
 
prisma/migrations/
  └─ 20261113014509_init/
    └─ migration.sql
 
Your database is now in sync with your schema.
 
✔ Generated Prisma Client (v6.19.3) to ./node_modules/@prisma/client in 35ms
$ echo $?
0
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

v7 に上げると

$ npx prisma migrate dev --name init
Prisma schema loaded from prisma/schema.prisma.
Error: Prisma schema validation - (get-config wasm)
Error code: P1012
error: The datasource property `url` is no longer supported in schema files. Move connection URLs for Migrate to `prisma.config.ts` and pass either `adapter` for a direct database connection or `accelerateUrl` for Accelerate to the `PrismaClient` constructor. See https://pris.ly/d/config-datasource and https://pris.ly/d/prisma7-client-config
  -->  prisma/schema.prisma:7
   | 
 6 |   provider = "sqlite"
 7 |   url      = env("DATABASE_URL")
   | 
 
Validation Error Count: 1
[Context: getConfig]
 
Prisma CLI Version : 7.10.1
$ echo $?
1

v7 で直すと

$ cat prisma/schema.prisma
generator client {
  provider = "prisma-client-js"
}
 
datasource db {
  provider = "sqlite"
}
 
model User {
  id    Int     @id @default(autoincrement())
  email String  @unique
  name  String?
}
$ cat prisma.config.ts
import "dotenv/config";
import { defineConfig, env } from "prisma/config";
 
export default defineConfig({
  schema: "prisma/schema.prisma",
  datasource: {
    url: env("DATABASE_URL"),
  },
});
$ npx prisma migrate dev --name init
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
SQLite database dev.db created at file:./dev.db
 
Applying migration `20261113014512_init`
 
The following migration(s) have been created and applied from new schema changes:
 
prisma/migrations/
  └─ 20261113014512_init/
    └─ migration.sql
 
Your database is now in sync with your schema.
$ echo $?
0
$ npx prisma generate
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
 
✔ Generated Prisma Client (v7.10.1) to ./node_modules/@prisma/client in 43ms
 
Start by importing your Prisma Client (See: https://pris.ly/d/importing-client)
$ echo $?
0
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

datasource から url の行を消し、プロジェクトの直下に prisma.config.ts を置いて datasource.url に書く。
env("DATABASE_URL") は prisma/config が出す関数で、環境変数を読む。
1 行目の import "dotenv/config" は .env を読み込むためのもので、無いと設定ファイルの読み込みで止まる(「.env を自動で読まなくなった」の節)。

7 の migrate dev は generate を走らせないので、続けて npx prisma generate を打った(次の節)。

schema.prisma の directUrl は、7.0.0 で無くなった(7.0.0 のリリースノート)。
公式の移行ガイドによると、マイグレーションに directUrl を使っていたなら、その値を prisma.config.ts の datasource.url に入れる。
shadowDatabaseUrl は、prisma.config.ts の datasource.shadowDatabaseUrl に書く。
どちらも、このページでは打っていない。

npm install と migrate dev が prisma generate を走らせなくなった

6 では、npm ci で @prisma/client を入れると、その postinstall が prisma generate を走らせていた。
v6 の段の ls のとおり、npm ci を終えた時点で node_modules/.prisma/client にクライアントができている。
migrate dev も、マイグレーションを当てたあとに generate を走らせていた(出力の最後の ✔ Generated Prisma Client の行)。

7 ではどちらも走らない。
node_modules の無いところから npm ci で入れ、migrate dev まで打っても、node_modules/.prisma/client はできなかった。
アプリは .prisma/client/default が見つからないという MODULE_NOT_FOUND で止まった。

v6 では

$ npm ci --silent
$ echo $?
0
$ ls node_modules/.prisma/client
client.d.ts
client.js
default.d.ts
default.js
edge.d.ts
edge.js
index-browser.js
index.d.ts
index.js
libquery_engine-debian-openssl-3.0.x.so.node
package.json
query_engine_bg.js
query_engine_bg.wasm
schema.prisma
wasm-edge-light-loader.mjs
wasm-worker-loader.mjs
wasm.d.ts
wasm.js
$ npx prisma migrate dev --name init
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
SQLite database dev.db created at file:./dev.db
 
Applying migration `20261113014517_init`
 
The following migration(s) have been created and applied from new schema changes:
 
prisma/migrations/
  └─ 20261113014517_init/
    └─ migration.sql
 
Your database is now in sync with your schema.
 
✔ Generated Prisma Client (v6.19.3) to ./node_modules/@prisma/client in 33ms
$ echo $?
0
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

v7 に上げると

$ npm ci --silent
$ echo $?
0
$ ls node_modules/.prisma/client
ls: cannot access 'node_modules/.prisma/client': No such file or directory
$ echo $?
2
$ npx prisma migrate dev --name init
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
SQLite database dev.db created at file:./dev.db
 
Applying migration `20261113014522_init`
 
The following migration(s) have been created and applied from new schema changes:
 
prisma/migrations/
  └─ 20261113014522_init/
    └─ migration.sql
 
Your database is now in sync with your schema.
$ echo $?
0
$ npx tsx src/main.ts
node:internal/modules/cjs/loader:1564
  const err = new Error(message);
              ^
 
Error: Cannot find module '.prisma/client/default'
Require stack:
- /work/v7/generate/node_modules/@prisma/client/default.js
- /work/v7/generate/src/main.ts
    at node:internal/modules/cjs/loader:1564:15
    at nextResolveSimple (/work/v7/generate/node_modules/tsx/dist/register-B1c7OH6V.cjs:23:1010)
    at /work/v7/generate/node_modules/tsx/dist/register-B1c7OH6V.cjs:22:4512
    at /work/v7/generate/node_modules/tsx/dist/register-B1c7OH6V.cjs:22:2830
    at resolveTsPaths (/work/v7/generate/node_modules/tsx/dist/register-B1c7OH6V.cjs:23:762)
    at /work/v7/generate/node_modules/tsx/dist/register-B1c7OH6V.cjs:23:1203
    at j._resolveFilename (file:///work/v7/generate/node_modules/tsx/dist/register-nyXW-TH3.mjs:2:18825)
    at wrapResolveFilename (node:internal/modules/cjs/loader:1118:27)
    at defaultResolveImplForCJSLoading (node:internal/modules/cjs/loader:1142:10)
    at defaultResolve (node:internal/modules/cjs/loader:1199:20) {
  code: 'MODULE_NOT_FOUND',
  requireStack: [
    '/work/v7/generate/node_modules/@prisma/client/default.js',
    '/work/v7/generate/src/main.ts'
  ]
}
 
Node.js v24.22.3
$ echo $?
1

v7 で直すと

$ npx prisma generate
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
 
✔ Generated Prisma Client (v7.10.1) to ./node_modules/@prisma/client in 33ms
 
Start by importing your Prisma Client (See: https://pris.ly/d/importing-client)
$ echo $?
0
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

npm ci や migrate dev のあとに、npx prisma generate を自分で打つ。
CI やデプロイの手順で npm ci のあとすぐにアプリをビルドしているなら、そのあいだに generate を足す。

package.json の scripts に "postinstall": "prisma generate" を書いて、入れるたびに生成させる手もある。
この形は、このページでは打っていない。

new PrismaClient() にドライバーアダプターが要るようになった

7 のクライアントは、データベースへの接続をドライバーアダプターに任せる。
new PrismaClient() と引数なしで作ると、作った時点で PrismaClientInitializationError になる。
メッセージの例は PostgreSQL 用の @prisma/adapter-pg だが、SQLite では @prisma/adapter-better-sqlite3 の PrismaBetterSqlite3 を使う。

v6 では

$ cat src/main.ts
import { PrismaClient } from "@prisma/client";
 
const prisma = new PrismaClient();
 
async function main() {
  await prisma.user.upsert({
    where: { email: "sato@example.com" },
    create: { email: "sato@example.com", name: "Sato" },
    update: {},
  });
  console.log(await prisma.user.findMany());
}
 
main().finally(() => prisma.$disconnect());
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

v7 に上げると

$ npx prisma generate
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
 
✔ Generated Prisma Client (v7.10.1) to ./node_modules/@prisma/client in 35ms
 
Start by importing your Prisma Client (See: https://pris.ly/d/importing-client)
$ echo $?
0
$ npx tsx src/main.ts
/work/v7/client-adapter/node_modules/@prisma/client/src/runtime/getPrismaClient.ts:390
        throw new PrismaClientInitializationError(
              ^
 
PrismaClientInitializationError: PrismaClient was instantiated without any options. A driver adapter is required to connect to your database.
 
Pass a driver adapter to the PrismaClient constructor, for example:
 
  import { PrismaPg } from '@prisma/adapter-pg'
  import { PrismaClient } from './generated/prisma/client'
 
  const adapter = new PrismaPg({ connectionString: process.env.DATABASE_URL })
  const prisma = new PrismaClient({ adapter })
 
Learn more about driver adapters: https://pris.ly/d/driver-adapters
 
If you use Prisma Accelerate instead of connecting to your database directly, pass `accelerateUrl` to the PrismaClient constructor instead of `adapter`.
    at new t (/work/v7/client-adapter/node_modules/@prisma/client/src/runtime/getPrismaClient.ts:390:15)
    at <anonymous> (/work/v7/client-adapter/src/main.ts:3:16)
    at Object.<anonymous> (/work/v7/client-adapter/src/main.ts:14:42)
    at Module._compile (node:internal/modules/cjs/loader:1929:14)
    at Object.transformer (/work/v7/client-adapter/node_modules/tsx/dist/register-B1c7OH6V.cjs:22:2188)
    at Module.load (node:internal/modules/cjs/loader:1651:32)
    at Module._load (node:internal/modules/cjs/loader:1443:12)
    at wrapModuleLoad (node:internal/modules/cjs/loader:261:19)
    at loadCJSModuleWithModuleLoad (node:internal/modules/esm/translators:372:15)
    at ModuleWrap.<anonymous> (node:internal/modules/esm/translators:244:9) {
  clientVersion: '7.10.1',
  errorCode: undefined,
  retryable: undefined
}
 
Node.js v24.22.3
$ echo $?
1

v7 で直すと

$ cat src/main.ts
import "dotenv/config";
import { PrismaClient } from "@prisma/client";
import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3";
 
const adapter = new PrismaBetterSqlite3({ url: process.env.DATABASE_URL! });
const prisma = new PrismaClient({ adapter });
 
async function main() {
  await prisma.user.upsert({
    where: { email: "sato@example.com" },
    create: { email: "sato@example.com", name: "Sato" },
    update: {},
  });
  console.log(await prisma.user.findMany());
}
 
main().finally(() => prisma.$disconnect());
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

npm install @prisma/adapter-better-sqlite3@7 でアダプターを入れる。
PrismaBetterSqlite3 に接続先の URL を渡してアダプターを作り、new PrismaClient({ adapter }) に渡す。
7 のクライアントは schema.prisma からも prisma.config.ts からも接続先を受け取らないので、URL はアプリのコードが渡す。

process.env.DATABASE_URL に付けた ! は、TypeScript で undefined を外す書き方である。
.env を読み込んでいないと、実行時には undefined のままアダプターに渡る(次の節)。

7.0.0 のリリースノートによると、new PrismaClient({ datasources }) と new PrismaClient({ datasourceUrl }) で接続先を渡す書き方も無くなった。
どちらも、このページでは打っていない。

.env を自動で読まなくなった

6 の CLI は .env を自分で読んでいた(v6 の段の migrate dev の 1 行目の Environment variables loaded from .env)。
6 のクライアントも、コードで読み込まなくても .env の DATABASE_URL でつながった。
7 は、CLI もクライアントも .env を読まない。
公式の移行ガイドによると、Bun で動かすなら Bun が .env を読み込む(このページでは打っていない)。

prisma.config.ts の env("DATABASE_URL") は、変数が無いと設定ファイルの読み込みで止まる。
v7 の段では、migrate dev も generate も同じエラーで止まった。
アプリの側はアダプターに undefined が渡り、最初のクエリでつなぐところで TypeError になる。
こちらのメッセージには DATABASE_URL の名前が出てこない。

generate が止まるので、この節の v7 の段のアプリが使うクライアントは、前もって環境変数で DATABASE_URL を渡して generate してある。

v6 では

$ cat .env
DATABASE_URL="file:./dev.db"
$ npx prisma migrate dev --name init
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
SQLite database dev.db created at file:./dev.db
 
Applying migration `20261113014530_init`
 
The following migration(s) have been created and applied from new schema changes:
 
prisma/migrations/
  └─ 20261113014530_init/
    └─ migration.sql
 
Your database is now in sync with your schema.
 
✔ Generated Prisma Client (v6.19.3) to ./node_modules/@prisma/client in 42ms
$ echo $?
0
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

v7 に上げると

$ cat prisma.config.ts
import { defineConfig, env } from "prisma/config";
 
export default defineConfig({
  schema: "prisma/schema.prisma",
  datasource: {
    url: env("DATABASE_URL"),
  },
});
$ npx prisma migrate dev --name init
Failed to load config file "/work/v7/env-file" as a TypeScript/JavaScript module. Error: PrismaConfigEnvError: Cannot resolve environment variable: DATABASE_URL.
$ echo $?
1
$ npx prisma generate
Failed to load config file "/work/v7/env-file" as a TypeScript/JavaScript module. Error: PrismaConfigEnvError: Cannot resolve environment variable: DATABASE_URL.
$ echo $?
1
$ head -n 4 src/main.ts
import { PrismaClient } from "@prisma/client";
import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3";
 
const adapter = new PrismaBetterSqlite3({ url: process.env.DATABASE_URL! });
$ npx tsx src/main.ts
/work/v7/env-file/node_modules/@prisma/adapter-better-sqlite3/dist/index.js:679
  const dbPath = url.replace(/^file:/, "");
                     ^
 
TypeError: Cannot read properties of undefined (reading 'replace')
    at createBetterSQLite3Client (/work/v7/env-file/node_modules/@prisma/adapter-better-sqlite3/dist/index.js:679:22)
    at PrismaBetterSqlite3AdapterFactory.connect (/work/v7/env-file/node_modules/@prisma/adapter-better-sqlite3/dist/index.js:668:59)
    at e.connect (/work/v7/env-file/node_modules/@prisma/client/src/runtime/core/engines/client/LocalExecutor.ts:49:58)
    at yr.#connectExecutor (/work/v7/env-file/node_modules/@prisma/client/src/runtime/core/engines/client/ClientEngine.ts:243:34)
    at callback (/work/v7/env-file/node_modules/@prisma/client/src/runtime/core/engines/client/ClientEngine.ts:192:35)
    at Object.runInChildSpan (/work/v7/env-file/node_modules/@prisma/client/src/runtime/core/tracing/TracingHelper.ts:41:12)
    at Wi.runInChildSpan (/work/v7/env-file/node_modules/@prisma/client/src/runtime/core/tracing/TracingHelper.ts:70:36)
    at yr.#ensureStarted (/work/v7/env-file/node_modules/@prisma/client/src/runtime/core/engines/client/ClientEngine.ts:187:47)
    at yr.request (/work/v7/env-file/node_modules/@prisma/client/src/runtime/core/engines/client/ClientEngine.ts:474:52)
    at Object.singleLoader (/work/v7/env-file/node_modules/@prisma/client/src/runtime/RequestHandler.ts:113:52) {
  clientVersion: '7.10.1'
}
 
Node.js v24.22.3
$ echo $?
1

v7 で直すと

$ head -n 2 prisma.config.ts
import "dotenv/config";
import { defineConfig, env } from "prisma/config";
$ npx prisma migrate dev --name init
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
SQLite database dev.db created at file:./dev.db
 
Applying migration `20261113014533_init`
 
The following migration(s) have been created and applied from new schema changes:
 
prisma/migrations/
  └─ 20261113014533_init/
    └─ migration.sql
 
Your database is now in sync with your schema.
$ echo $?
0
$ head -n 5 src/main.ts
import "dotenv/config";
import { PrismaClient } from "@prisma/client";
import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3";
 
const adapter = new PrismaBetterSqlite3({ url: process.env.DATABASE_URL! });
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

prisma.config.ts とアプリの入口の先頭に、import "dotenv/config" を書く。
公式の移行ガイドによると、dotenv はすでに設定されている環境変数を上書きしない。
CI で DATABASE_URL を環境変数として渡しているなら、そちらが優先される。

公式の移行ガイドの SQLite の例は、process.env.DATABASE_URL || "file:./dev.db" と既定値を付けている。
既定値があると、.env を読み込み忘れても file:./dev.db につなぎに行く。
この形は、このページでは打っていない。

SQLite の file:./dev.db が prisma/ を基準にしなくなった

6 では、プロジェクトの直下で打っても、SQLite の file:./dev.db は schema.prisma と同じ prisma/ の下を指した。
v6 の段の ls prisma のとおり、dev.db は prisma/ の下にできる。

7 に上げて同じ .env のままにすると、CLI は prisma/dev.db があっても P1003 で「無い」と答えた。
この時点で、直下に dev.db は無い。
アプリを動かすと User テーブルが無いという P2021 で止まり、そのあと直下に 0 バイトの dev.db ができていた。
v6 の段で入れたデータが消えたわけではない。

v6 では

$ cat .env
DATABASE_URL="file:./dev.db"
$ npx prisma migrate dev --name init
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
SQLite database dev.db created at file:./dev.db
 
Applying migration `20261113014535_init`
 
The following migration(s) have been created and applied from new schema changes:
 
prisma/migrations/
  └─ 20261113014535_init/
    └─ migration.sql
 
Your database is now in sync with your schema.
 
✔ Generated Prisma Client (v6.19.3) to ./node_modules/@prisma/client in 34ms
$ echo $?
0
$ ls prisma
dev.db
migrations
schema.prisma
$ npx tsx src/main.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

v7 に上げると

$ ls prisma
dev.db
migrations
schema.prisma
$ npx prisma migrate status
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
Error: P1003: Database `dev.db` does not exist
$ echo $?
1
$ ls
node_modules
package-lock.json
package.json
prisma
prisma.config.ts
src
$ cat src/list.ts
import "dotenv/config";
import { PrismaClient } from "@prisma/client";
import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3";
 
const adapter = new PrismaBetterSqlite3({ url: process.env.DATABASE_URL! });
const prisma = new PrismaClient({ adapter });
 
prisma.user.findMany().then(console.log).finally(() => prisma.$disconnect());
$ npx tsx src/list.ts
/work/v7/sqlite-path/node_modules/@prisma/client/src/runtime/RequestHandler.ts:238
      throw new PrismaClientKnownRequestError(message, {
            ^
 
PrismaClientKnownRequestError: 
Invalid `prisma.user.findMany()` invocation in
/work/v7/sqlite-path/src/list.ts:8:13
 
  5 const adapter = new PrismaBetterSqlite3({ url: process.env.DATABASE_URL! });
  6 const prisma = new PrismaClient({ adapter });
  7 
→ 8 prisma.user.findMany(
The table `main.User` does not exist in the current database.
    at vn.handleRequestError (/work/v7/sqlite-path/node_modules/@prisma/client/src/runtime/RequestHandler.ts:238:13)
    at vn.handleAndLogRequestError (/work/v7/sqlite-path/node_modules/@prisma/client/src/runtime/RequestHandler.ts:184:12)
    at vn.request (/work/v7/sqlite-path/node_modules/@prisma/client/src/runtime/RequestHandler.ts:153:12)
    at async a (/work/v7/sqlite-path/node_modules/@prisma/client/src/runtime/getPrismaClient.ts:1012:24) {
  code: 'P2021',
  meta: {
    modelName: 'User',
    driverAdapterError: DriverAdapterError: TableDoesNotExist
        at PrismaBetterSqlite3Adapter.onError (/work/v7/sqlite-path/node_modules/@prisma/adapter-better-sqlite3/dist/index.js:590:11)
        at PrismaBetterSqlite3Adapter.performIO (/work/v7/sqlite-path/node_modules/@prisma/adapter-better-sqlite3/dist/index.js:585:12)
        at PrismaBetterSqlite3Adapter.queryRaw (/work/v7/sqlite-path/node_modules/@prisma/adapter-better-sqlite3/dist/index.js:526:63)
        at callback (/work/v7/sqlite-path/node_modules/@prisma/client-engine-runtime/src/interpreter/query-interpreter.ts:202:18)
        at withQuerySpanAndEvent (/work/v7/sqlite-path/node_modules/@prisma/client-engine-runtime/src/tracing.ts:80:12)
        at e.#withQuerySpanAndEvent (/work/v7/sqlite-path/node_modules/@prisma/client-engine-runtime/src/interpreter/query-interpreter.ts:592:12)
        at fn (/work/v7/sqlite-path/node_modules/@prisma/client-engine-runtime/src/interpreter/query-interpreter.ts:200:39)
        at e.#withChunkTransaction (/work/v7/sqlite-path/node_modules/@prisma/client-engine-runtime/src/interpreter/query-interpreter.ts:515:14)
        at e.interpretNode (/work/v7/sqlite-path/node_modules/@prisma/client-engine-runtime/src/interpreter/query-interpreter.ts:196:21)
        at node (/work/v7/sqlite-path/node_modules/@prisma/client-engine-runtime/src/interpreter/query-interpreter.ts:109:64) {
      cause: {
        originalCode: 'SQLITE_ERROR',
        originalMessage: 'no such table: main.User',
        kind: 'TableDoesNotExist',
        table: 'main.User'
      }
    }
  },
  clientVersion: '7.10.1'
}
 
Node.js v24.22.3
$ echo $?
1
$ ls
dev.db
node_modules
package-lock.json
package.json
prisma
prisma.config.ts
src
$ wc -c dev.db
0 dev.db

v7 で直すと

$ rm dev.db
$ cat .env
DATABASE_URL="file:./prisma/dev.db"
$ npx prisma migrate status
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
Datasource "db": SQLite database "dev.db" at "file:./prisma/dev.db"
 
1 migration found in prisma/migrations
 
Database schema is up to date!
$ echo $?
0
$ npx tsx src/list.ts
[ { id: 1, email: 'sato@example.com', name: 'Sato' } ]
$ echo $?
0

.env の URL を file:./prisma/dev.db に直すと、CLI もアプリも v6 で入れた行を読んだ。
アプリが直下に作った空の dev.db は消しておく。

この節の v7 の段では、prisma.config.ts をプロジェクトの直下に置き、CLI もアプリも直下で打った。
直下で打つと、7 の file:./dev.db は直下を指した。
基準が設定ファイルの場所か、コマンドを打ったディレクトリかは、このページでは確かめていない。
設定ファイルを別の場所に置いたときや、別のディレクトリからアプリを起動したときは打っていない。
7 の SQLite のドキュメントの例も、アダプターに file:./prisma/dev.db を渡している。

公式の移行ガイドと 7.0.0 のリリースノートを検索した限り、この場所の変化は書かれていない。

seed の設定が prisma.config.ts に移り、migrate reset が seed を走らせなくなった

6 は package.json の "prisma" にある seed を読み、migrate reset のあとに seed を走らせていた。
6.19 は、この設定に package.json#prisma が非推奨という警告を出していた。

7 は package.json の "prisma" を読まず、残っていても警告を出さなかった。
migrate reset は seed を走らせない。
db seed は「No seed command configured」と出し、終了コード 0 で終わる。
CI で db seed を打っていても止まらないので、seed が入っていないことに気づきにくい。

v6 では

$ npm pkg get prisma
{
  "seed": "tsx prisma/seed.ts"
}
$ npx prisma migrate reset --force
warn The configuration property `package.json#prisma` is deprecated and will be removed in Prisma 7. Please migrate to a Prisma config file (e.g., `prisma.config.ts`).
For more information, see: https://pris.ly/prisma-config
 
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
Applying migration `20261113014541_init`
 
Database reset successful
 
The following migration(s) have been applied:
 
migrations/
  └─ 20261113014541_init/
    └─ migration.sql
 
✔ Generated Prisma Client (v6.19.3) to ./node_modules/@prisma/client in 33ms
 
Running seed command `tsx prisma/seed.ts` ...
seeded
 
🌱  The seed command has been executed.
$ echo $?
0

v7 に上げると

$ npm pkg get prisma
{
  "seed": "tsx prisma/seed.ts"
}
$ npx prisma migrate reset --force
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
Applying migration `20261113014539_init`
 
Database reset successful
 
The following migration(s) have been applied:
 
migrations/
  └─ 20261113014539_init/
    └─ migration.sql
$ echo $?
0
$ npx prisma db seed
Loaded Prisma config from prisma.config.ts.
 
⚠️ No seed command configured
 
To seed your database, add a seed property to the migrations section in your Prisma config file.
 
Example
 
  // prisma7.config.ts
  export default defineConfig({
    migrations: {
      seed: 'bun·./prisma/seed.ts',
    },
    datasource: {
      url: '[your database URL]',
    },
  })
$ echo $?
0

v7 で直すと

$ npm pkg delete prisma
$ cat prisma.config.ts
import "dotenv/config";
import { defineConfig, env } from "prisma/config";
 
export default defineConfig({
  schema: "prisma/schema.prisma",
  migrations: {
    seed: "tsx prisma/seed.ts",
  },
  datasource: {
    url: env("DATABASE_URL"),
  },
});
$ npx prisma migrate reset --force
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
Datasource "db": SQLite database "dev.db" at "file:./dev.db"
 
Applying migration `20261113014539_init`
 
Database reset successful
 
The following migration(s) have been applied:
 
migrations/
  └─ 20261113014539_init/
    └─ migration.sql
$ echo $?
0
$ npx prisma db seed
Loaded Prisma config from prisma.config.ts.
 
Running seed command `tsx prisma/seed.ts` ...
seeded
 
🌱  The seed command has been executed.
$ echo $?
0

prisma.config.ts の migrations.seed に seed のコマンドを書き、package.json の "prisma" を消す。
7 は seed を書いたあとも migrate reset で seed を走らせないので、npx prisma db seed を自分で打つ。
公式の移行ガイドによると、migrate dev も seed を走らせなくなった(migrate dev では打っていない)。

db seed の案内に出る例は、prisma7.config.ts というファイル名と bun のコマンドを使っている。
このページは prisma.config.ts に書き、7.10.1 はそれを読んだ(出力の Loaded Prisma config from prisma.config.ts.)。

migrate diff の --to-schema-datamodel と --from-schema-datasource が無くなった

migrate diff で schema のファイルを入力にする --to-schema-datamodel は、--to-schema に名前が変わった。
データベースを入力にする --from-schema-datasource は無くなり、prisma.config.ts の接続先を使う --from-config-datasource に替わった。
7 は古い名前を見ると、替わりのオプションを示してヘルプを出し、終了コード 1 で止まる。

v6 では

$ npx prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script
-- CreateTable
CREATE TABLE "User" (
    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
    "email" TEXT NOT NULL,
    "name" TEXT
);
 
-- CreateIndex
CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
$ echo $?
0
$ npx prisma migrate diff --from-schema-datasource prisma/schema.prisma --to-schema-datamodel prisma/schema.prisma --exit-code
No difference detected.
$ echo $?
0
$ npx prisma migrate diff --from-empty --to-schema prisma/schema.prisma --script > diff.log 2>&1
$ echo $?
1
$ head -n 2 diff.log
Error: 
unknown or unexpected option: --to-schema

v7 に上げると

$ npx prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script
Loaded Prisma config from prisma.config.ts.
 
Error: 
`--to-schema-datamodel` was removed. Please use `--[from/to]-schema` instead.
 
Usage
 
  $ prisma migrate diff [options]
 
Options
 
  -h, --help               Display this help message
  --config                 Custom path to your Prisma config file
  -o, --output             Writes to a file instead of stdout
 
From and To inputs (1 `--from-...` and 1 `--to-...` must be provided):
  --from-empty             Flag to assume from or to is an empty datamodel
  --to-empty
 
  --from-schema            Path to a Prisma schema file, uses the datamodel for the diff
  --to-schema
 
  --from-migrations        Path to the Prisma Migrate migrations directory
  --to-migrations
 
  --from-config-datasource Flag to use the datasource from the Prisma config file
  --to-config-datasource
 
Flags
 
  --script                 Render a SQL script to stdout instead of the default human readable summary (not supported on MongoDB)
  --exit-code              Change the exit code behavior to signal if the diff is empty or not (Empty: 0, Error: 1, Not empty: 2). Default behavior is Success: 0, Error: 1.
$ echo $?
1
$ npx prisma migrate diff --from-schema-datasource prisma/schema.prisma --to-schema-datamodel prisma/schema.prisma --exit-code > diff.log 2>&1
$ echo $?
1
$ head -n 4 diff.log
Loaded Prisma config from prisma.config.ts.
 
Error: 
`--from-schema-datasource` was removed. Please use `--[from/to]-config-datasource` in combination with a Prisma config file that contains the appropriate datasource instead.

v7 で直すと

$ npx prisma migrate diff --from-empty --to-schema prisma/schema.prisma --script
Loaded Prisma config from prisma.config.ts.
 
-- CreateTable
CREATE TABLE "User" (
    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
    "email" TEXT NOT NULL,
    "name" TEXT
);
 
-- CreateIndex
CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
$ echo $?
0
$ npx prisma migrate diff --from-config-datasource --to-schema prisma/schema.prisma --exit-code
Loaded Prisma config from prisma.config.ts.
 
No difference detected.
$ echo $?
0

--to-schema-datamodel を --to-schema に、--from-schema-datasource を --from-config-datasource に書き換える。
--from-config-datasource は値を取らず、prisma.config.ts の datasource.url につなぐ。
--from-schema-datamodel と --to-schema-datasource も同じように替わる(7.0.0 のリリースノート)。

6.19 は新しい --to-schema を受け付けない(v6 の段の 3 つ目)。
先に書き換えると 6 のうちに止まるので、CI のスクリプトは版を上げるのと同じ変更で書き換える。

7.0.0 のリリースノートによると、--from-url と --to-url も無くなり、--from-config-datasource と --to-config-datasource に替わった。
2 つの URL どうしを比べる使い方はできなくなった。
どちらも、このページでは打っていない。

db execute の --schema が無くなった

6 の db execute は、接続先を --schema か --url で渡す必要があり、どちらも無いと止まった。
7 は --schema を受け付けず、接続先を prisma.config.ts から読む。

v6 では

$ cat prisma/backfill.sql
UPDATE "User" SET "name" = 'unknown' WHERE "name" IS NULL;
$ npx prisma db execute --file prisma/backfill.sql --schema prisma/schema.prisma
Script executed successfully.
$ echo $?
0
$ npx prisma db execute --file prisma/backfill.sql
Error: Either --url or --schema must be provided.
See `prisma db execute -h`
$ echo $?
1

v7 に上げると

$ npx prisma db execute --file prisma/backfill.sql --schema prisma/schema.prisma
Loaded Prisma config from prisma.config.ts.
 
Error: 
unknown or unexpected option: --schema
 
Usage
 
  $ prisma db execute [options]
 
  The datasource URL configuration is read from the Prisma config file (e.g., prisma7.config.ts).
 
Options
 
-h, --help            Display this help message
--config              Custom path to your Prisma config file
 
Script input, only 1 must be provided:
--file                Path to a file. The content will be sent as the script to be executed
 
Flags
 
--stdin              Use the terminal standard input as the script to be executed
$ echo $?
1

v7 で直すと

$ npx prisma db execute --file prisma/backfill.sql
Loaded Prisma config from prisma.config.ts.
 
Script executed successfully.
$ echo $?
0

--schema を外し、--file だけで打つ。
6 で --schema を外すと止まり、7 で付けると止まるので、スクリプトは版を上げるのと同じ変更で書き換える。
公式の移行ガイドによると、--url も無くなった。
こちらは、このページでは打っていない。

プレビュー機能の metrics が無くなった

metrics のプレビュー機能は 6.14.0 で非推奨になり(6.14.0 のリリースノート)、7 で無くなった。
6.19 は generate で非推奨の警告を出すだけで、prisma.$metrics.json() はクエリの数などのカウンターを返した。
7 は previewFeatures に metrics があると schema の検査で P1012 になり、generate もできない。

v6 では

$ cat prisma/schema.prisma
generator client {
  provider        = "prisma-client-js"
  previewFeatures = ["metrics"]
}
 
datasource db {
  provider = "sqlite"
  url      = env("DATABASE_URL")
}
 
model User {
  id    Int     @id @default(autoincrement())
  email String  @unique
  name  String?
}
$ npx prisma generate
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
warn Preview feature "metrics" is deprecated. It will be removed in a future version of Prisma.
 
✔ Generated Prisma Client (v6.19.3) to ./node_modules/@prisma/client in 30ms
 
Start by importing your Prisma Client (See: https://pris.ly/d/importing-client)
 
Tip: Interested in query caching in just a few lines of code? Try Accelerate today! https://pris.ly/tip-3-accelerate
$ echo $?
0
$ npx tsx src/metrics.ts
prisma_client_queries_total 2
prisma_datasource_queries_total 2
prisma_pool_connections_closed_total 0
prisma_pool_connections_opened_total 1
$ echo $?
0

v7 に上げると

$ npx prisma generate
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
Error: Prisma schema validation - (get-config wasm)
Error code: P1012
error: The preview feature "metrics" is not known. Expected one of: nativeDistinct, partialIndexes, postgresqlExtensions, relationJoins, schemaEngineDriverAdapters, shardKeys, strictUndefinedChecks, typedSql, views
  -->  prisma/schema.prisma:3
   | 
 2 |   provider        = "prisma-client-js"
 3 |   previewFeatures = ["metrics"]
   | 
 
Validation Error Count: 1
[Context: getConfig]
 
Prisma CLI Version : 7.10.1
$ echo $?
1

v7 で直すと

$ head -n 3 prisma/schema.prisma
generator client {
  provider = "prisma-client-js"
}
$ npx prisma generate
Loaded Prisma config from prisma.config.ts.
 
Prisma schema loaded from prisma/schema.prisma.
 
✔ Generated Prisma Client (v7.10.1) to ./node_modules/@prisma/client in 38ms
 
Start by importing your Prisma Client (See: https://pris.ly/d/importing-client)
$ echo $?
0
$ cat src/metrics.ts
import "dotenv/config";
import { PrismaClient } from "@prisma/client";
import { PrismaBetterSqlite3 } from "@prisma/adapter-better-sqlite3";
 
let queries = 0;
 
const adapter = new PrismaBetterSqlite3({ url: process.env.DATABASE_URL! });
const prisma = new PrismaClient({ adapter }).$extends({
  query: {
    $allModels: {
      async $allOperations({ args, query }) {
        queries += 1;
        return query(args);
      },
    },
  },
});
 
async function main() {
  await prisma.user.findMany();
  await prisma.user.count();
  console.log("queries", queries);
}
 
main().finally(() => prisma.$disconnect());
$ npx tsx src/metrics.ts
queries 2
$ echo $?
0

previewFeatures から metrics を外し、prisma.$metrics を使うコードを書き換える。
クエリの数だけが要るなら、公式の移行ガイドの例のように、Client Extensions の $allOperations で数える。
7.0.0 のリリースノートは、接続プールの数などをドライバー(PostgreSQL の pg のプールなど)から取る方法も挙げている。

検証環境Node.js 24.22.3 / npm 11.19.1 / Python 3.11.2 / 2026-11-13 検証(ほか 9 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.3
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • Prisma(旧) 6.19.3
  • Prisma(新) 7.10.1
  • @prisma/client(旧) 6.19.3
  • @prisma/client(新) 7.10.1
  • @prisma/adapter-better-sqlite3 7.10.1
  • better-sqlite3 12.11.1
  • dotenv 18.0.10
  • tsx 4.23.15

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。