メインコンテンツへスキップ

データベースをベースライン化する

TypeScript
SQL Server

初期マイグレーションを作成する​

前のセクションでイントロスペクトしたデータベースで Prisma Migrate を使用するには、データベースをベースライン化する必要があります。

ベースライン化とは、本番データベースなど、すでにデータが含まれており、リセットできないデータベースのマイグレーション履歴を初期化することを指します。ベースライン化は、Prisma Migrate に、1 つ以上のマイグレーションがすでにデータベースに適用されていると想定するように指示します。

データベースをベースライン化するには、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

コマンドは、_prisma_migrations テーブルに追加することで、0_init を適用済みとしてマークします。

これで、現在のデータベーススキーマのベースラインができました。データベーススキーマにさらに変更を加えるには、Prisma スキーマを更新し、prisma migrate dev を使用して変更をデータベースに適用できます。