跳到主内容

为数据库建立基线

创建初始迁移

要将 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 将更改应用到数据库。