prisma-upgrade-v7-schema-changes

作者: prisma

Schema 變更。使用此 Prisma 功能時的參考。

npx skills add https://github.com/prisma/cursor-plugin --skill prisma-upgrade-v7-schema-changes

Schema Changes

Prisma v7 introduces a new prisma-client generator. Update your generator block and import paths accordingly.

Generator Provider

Before (v6)

generator client {
  provider = "prisma-client-js"
  engineType = "binary"  // or "library"
}

After (v7)

generator client {
  provider = "prisma-client"
  output   = "../generated"
}

Key Changes

1. Provider name

Use prisma-client in Prisma v7.

2. Output is required (for prisma-client)

The output field is mandatory when using prisma-client. Prisma Client no longer generates to node_modules with this generator.

generator client {
  provider = "prisma-client"
  output   = "../generated"  // Required for prisma-client
}

3. Engine type removed

engineType is removed in Prisma v7. Remove any engineType setting from your generator block.

Example Output Paths (prisma-client)

Standard project

output = "../generated"

Creates: generated/client

Monorepo

output = "../../packages/database/generated"

Same directory as schema

output = "./generated"

Creates: prisma/generated/client

Datasource Block

The url, directUrl, and shadowDatabaseUrl values now live in prisma.config.ts in Prisma v7. Keep only the provider in schema.prisma:

Before (v6)

datasource db {
  provider  = "postgresql"
  url       = env("DATABASE_URL")
  directUrl = env("DIRECT_URL")
}

After (v7)

datasource db {
  provider = "postgresql"
  // URLs configured in prisma.config.ts
}
// prisma.config.ts
export default defineConfig({
  datasource: {
    url: env('DATABASE_URL'),
    directUrl: env('DIRECT_URL'),
    shadowDatabaseUrl: env('SHADOW_DATABASE_URL'),
  },
})

Full Example

v6 Schema

generator client {
  provider   = "prisma-client-js"
  engineType = "library"
}

datasource db {
  provider  = "postgresql"
  url       = env("DATABASE_URL")
  directUrl = env("DIRECT_URL")
}

v7 Schema

generator client {
  provider = "prisma-client"
  output   = "../generated"
}

datasource db {
  provider = "postgresql"
}

After Schema Changes

  1. Run prisma generate:

    npx prisma generate
    
  2. Update imports throughout your codebase:

    // Before (prisma-client-js)
    import { PrismaClient } from '@prisma/client'
    
    // After (prisma-client, output = "../generated")
    import { PrismaClient } from '../generated/client'
    
  3. Update .gitignore (if using prisma-client output):

    generated
    

Preview Features

Preview features work the same:

generator client {
  provider        = "prisma-client"
  output          = "../generated"
  previewFeatures = ["relationJoins", "fullTextSearch"]
}

來自 prisma 的更多技能

prisma-cli-migrate-reset
prisma
prisma migrate reset
official
prisma-cli-validate
prisma
prisma validate。使用此 Prisma 功能時的參考。
official
prisma-next-extension-upgrade
prisma
Upgrade Prisma Next in your extension. Bumps every `@prisma-next/*` dependency to the requested target (or npm `latest`), runs the per-transition upgrade…
official
adr-review
prisma
以全新的視角(如同沒有先前背景的團隊成員)審查一或多個 ADR,找出敘事與結構上的問題,然後重新撰寫。適用於當…
official
prisma-next-upgrade
prisma
Upgrade Prisma Next in your app. Bumps every `@prisma-next/*` dependency from the version pinned in the lockfile to the requested target (or npm `latest`),…
official
prisma-cli
prisma
Prisma CLI 指令、選項及工作流程的完整參考,涵蓋設定、遷移與資料庫操作。包含 20 多個按優先順序組織的指令:設定(init)、生成(generate)、開發(dev)、資料庫操作(db pull/push/seed/execute)以及遷移(migrate dev/deploy/reset/status/diff/resolve)。包含 Prisma 7.x 的變更:新的 prisma.config.ts 設定檔、已移除的旗標(--skip-generate、--skip-seed、--schema、--url)以及明確...
official
prisma-client-api
prisma
完整的 Prisma Client API 參考,涵蓋模型查詢、CRUD 操作、過濾、關聯與事務。包含 17 種模型查詢方法,如 findUnique、findMany、create、update、delete、upsert 及批量操作與回傳變體。提供查詢選項以塑造結果:select、include、omit、orderBy、take、skip、cursor 與 distinct。包含標量與邏輯過濾運算子(equals、in、contains、startsWith、lt、gt)以及關聯過濾(some、...)
official
prisma-compute
prisma
Prisma Compute deployment and hosting guide. Use whenever the user mentions Prisma Compute, `prisma.compute.ts`, `defineComputeConfig`, deploying or hosting a Prisma app, `@prisma/cli app deploy`, `compute:deploy`, `create-prisma --deploy`, `PRISMA_SERVICE_TOKEN`, `auth workspace`, Compute apps/deployments/build logs/domains, `@prisma/cli agent install`, localhost vs `0.0.0.0`, deploy port binding, or framework deploy readiness for Hono, Elysia, Next.js, TanStack Start, Astro, Nuxt, Svelte,...
developmentdevopsofficial