建立資料庫基準線
建立初始遷移
若要搭配您在上個章節中內省的資料庫使用 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
-- CreateTable
CREATE TABLE "Post" (
"id" SERIAL NOT NULL,
"title" VARCHAR(255) NOT NULL,
"createdAt" TIMESTAMP(6) NOT NULL DEFAULT CURRENT_TIMESTAMP,
"content" TEXT,
"published" BOOLEAN NOT NULL DEFAULT false,
"authorId" INTEGER NOT NULL,
CONSTRAINT "Post_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "Profile" (
"id" SERIAL NOT NULL,
"bio" TEXT,
"userId" INTEGER NOT NULL,
CONSTRAINT "Profile_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "User" (
"id" SERIAL NOT NULL,
"name" VARCHAR(255),
"email" VARCHAR(255) NOT NULL,
CONSTRAINT "User_pkey" PRIMARY KEY ("id")
);
-- CreateIndex
CREATE UNIQUE INDEX "Profile_userId_key" ON "Profile"("userId");
-- CreateIndex
CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
-- AddForeignKey
ALTER TABLE "Post" ADD CONSTRAINT "Post_authorId_fkey" FOREIGN KEY ("authorId") REFERENCES "User"("id") ON DELETE NO ACTION ON UPDATE NO ACTION;
-- AddForeignKey
ALTER TABLE "Profile" ADD CONSTRAINT "Profile_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE NO ACTION ON UPDATE NO ACTION;
檢閱 SQL 遷移檔案以確保一切正確。
接下來,使用 prisma migrate resolve
和 --applied
引數將遷移標記為已套用。
npx prisma migrate resolve --applied 0_init
此命令會將 0_init
標記為已套用,方法是將其新增至 _prisma_migrations
表格。
您現在已為目前的資料庫 schema 建立基準線。若要進一步變更您的資料庫 schema,您可以更新您的 Prisma schema 並使用 prisma migrate dev
將變更套用至您的資料庫。