为数据库建立基线
创建初始迁移
要将 Prisma Migrate 用于上一节中内省的数据库,你需要为数据库建立基线。
建立基线(Baselining)是指为你已包含数据且无法重置的数据库(例如你的生产数据库)初始化迁移历史。建立基线会告诉 Prisma Migrate 假定一个或多个迁移已经应用到你的数据库。
要为数据库建立基线,请使用prisma migrate diff
来比较你的 schema 和数据库,并将输出保存到 SQL 文件中。
首先,创建一个 migrations
目录,并在其中添加一个用于迁移的目录,名称可以自由选择。在此示例中,我们将使用 0_init
作为迁移名称。
mkdir -p prisma/migrations/0_init
信息
-p
会在你提供的路径中递归地创建所有缺失的文件夹。
接下来,使用 prisma migrate diff
生成迁移文件。使用以下参数:
--from-empty
: 假定你从中进行迁移的数据模型是空的--to-schema-datamodel
: 使用datasource
块中的 URL 获取当前的数据库状态--script
: 输出 SQL 脚本
npx prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script > prisma/migrations/0_init/migration.sql
审查迁移
该命令将生成一个迁移脚本,其内容应类似于以下内容:
prisma/migrations/0_init/migration.sql
CREATE TABLE "User" (
id INT8 PRIMARY KEY DEFAULT unique_rowid(),
name STRING(255),
email STRING(255) UNIQUE NOT NULL
);
CREATE TABLE "Post" (
id INT8 PRIMARY KEY DEFAULT unique_rowid(),
title STRING(255) UNIQUE NOT NULL,
"createdAt" TIMESTAMP NOT NULL DEFAULT now(),
content STRING,
published BOOLEAN NOT NULL DEFAULT false,
"authorId" INT8 NOT NULL,
FOREIGN KEY ("authorId") REFERENCES "User"(id)
);
CREATE TABLE "Profile" (
id INT8 PRIMARY KEY DEFAULT unique_rowid(),
bio STRING,
"userId" INT8 UNIQUE NOT NULL,
FOREIGN KEY ("userId") REFERENCES "User"(id)
);
审查 SQL 迁移文件,确保一切正确。
接下来,使用带有 --applied
参数的 prisma migrate resolve
将迁移标记为已应用。
npx prisma migrate resolve --applied 0_init
该命令会将 0_init
添加到 _prisma_migrations
表中,从而将其标记为已应用。
现在,你的当前数据库 schema 已建立基线。要对数据库 schema 进行进一步更改,你可以更新 Prisma schema 并使用 prisma migrate dev
将更改应用到数据库。