跳到主要內容

建立資料庫基準

建立初始遷移

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

建立基準是指為可能已包含資料且無法重設的資料庫 (例如您的生產資料庫) 初始化您的遷移歷史記錄。建立基準會告知 Prisma Migrate 假設一或多個遷移已套用至您的資料庫。

若要建立資料庫基準,請使用 prisma migrate diff 來比較您的結構描述和資料庫,並將輸出儲存至 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 [dbo].[Post] (
[id] INT NOT NULL IDENTITY(1,1),
[createdAt] DATETIME2 NOT NULL CONSTRAINT [Post_createdAt_df] DEFAULT CURRENT_TIMESTAMP,
[updatedAt] DATETIME2 NOT NULL,
[title] VARCHAR(255) NOT NULL,
[content] NVARCHAR(1000),
[published] BIT NOT NULL CONSTRAINT [Post_published_df] DEFAULT 0,
[authorId] INT NOT NULL,
CONSTRAINT [Post_pkey] PRIMARY KEY ([id])
);

CREATE TABLE [dbo].[Profile] (
[id] INT NOT NULL IDENTITY(1,1),
[bio] NVARCHAR(1000),
[userId] INT NOT NULL,
CONSTRAINT [Profile_pkey] PRIMARY KEY ([id]),
CONSTRAINT [Profile_userId_key] UNIQUE ([userId])
);

CREATE TABLE [dbo].[User] (
[id] INT NOT NULL IDENTITY(1,1),
[email] NVARCHAR(1000) NOT NULL,
[name] NVARCHAR(1000),
CONSTRAINT [User_pkey] PRIMARY KEY ([id]),
CONSTRAINT [User_email_key] UNIQUE ([email])
);

ALTER TABLE [dbo].[Post] ADD CONSTRAINT [Post_authorId_fkey] FOREIGN KEY ([authorId]) REFERENCES [dbo].[User]([id]) ON DELETE NO ACTION ON UPDATE CASCADE;

ALTER TABLE [dbo].[Profile] ADD CONSTRAINT [Profile_userId_fkey] FOREIGN KEY ([userId]) REFERENCES [dbo].[User]([id]) ON DELETE NO ACTION ON UPDATE CASCADE;

檢閱 SQL 遷移檔案,以確保一切正確。

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

npx prisma migrate resolve --applied 0_init

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

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