跳到主要內容

建立資料庫基線

建立初始遷移

若要搭配您在上一個章節中內省的資料庫使用 Prisma Migrate,您需要建立資料庫基線

建立基線是指為可能已包含資料且無法重設的資料庫(例如您的生產環境資料庫)初始化您的遷移歷史記錄。建立基線會告知 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 遷移檔案以確保一切正確。

接下來,使用 prisma migrate resolve--applied 引數將遷移標記為已套用。

npx prisma migrate resolve --applied 0_init

此命令會將 0_init 標記為已套用,方法是將其新增至 _prisma_migrations 表格。

您現在已為目前的資料庫 schema 建立基線。若要對資料庫 schema 進行進一步的變更,您可以更新您的 Prisma schema 並使用 prisma migrate dev 將變更套用至您的資料庫。