建立你的資料庫基準線

TypeScript

PostgreSQL

建立初始 Migration

若要搭配你在上個章節中內省的資料庫使用 Prisma Migrate，你需要建立你的資料庫基準線。

建立基準線指的是為可能已經包含資料且無法重置的資料庫（例如你的生產環境資料庫）初始化你的 migration 歷史記錄。建立基準線告訴 Prisma Migrate 假設一個或多個 migrations 已經套用至你的資料庫。

要建立你的資料庫基準線，請使用prisma migrate diff 來比較你的 schema 和資料庫，並將輸出儲存至 SQL 檔案。

首先，建立一個 migrations 目錄，並在其中新增一個目錄，並使用你偏好的 migration 名稱。在此範例中，我們將使用 0_init 作為 migration 名稱

mkdir -p prisma/migrations/0_init

資訊

-p 將遞迴地在你提供的路徑中建立任何遺失的資料夾。

接下來，使用 prisma migrate diff 產生 migration 檔案。使用以下參數

--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

檢閱 Migration

此命令將產生一個 migration，其應該類似於以下腳本

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 migration 檔案以確保一切正確。

接下來，使用 prisma migrate resolve 和 --applied 參數將 migration 標記為已套用。

npx prisma migrate resolve --applied 0_init

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

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

建立初始 Migration​

檢閱 Migration​

建立初始 Migration

檢閱 Migration