Skip to content

Commit

Permalink
docs: imperative vs declarative terminology for Prisma Migrate (#5273)
Browse files Browse the repository at this point in the history
Co-authored-by: Nikolas <[email protected]>
  • Loading branch information
ruheni and nikolasburk authored Nov 23, 2023
1 parent 2b37c44 commit 9b44808
Showing 1 changed file with 6 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,18 @@ toc: false

</Admonition>

Prisma Migrate is an **declarative database schema migration tool** that enables you to:
Prisma Migrate enables you to:

- Keep your database schema in sync with your [Prisma schema](/concepts/components/prisma-schema) as it evolves _and_
- Maintain existing data in your database

Prisma Migrate generates [a history of `.sql` migration files](/concepts/components/prisma-migrate/migration-histories), and plays a role in both [development and production](/concepts/components/prisma-migrate/migrate-development-production).

Prisma Migrate can be considered a _hybrid_ database schema migration tool, meaning it has both of _declarative_ and _imperative_ elements:

- Declarative: The data model is described in a declarative way in the [Prisma schema](/concepts/components/prisma-schema). Prisma Migrate generates SQL migration files from that data model.
- Imperative: All generated SQL migration files are fully customizable. Prisma Migrate hence provides the flexibility of an imperative migration tool by enabling you to modify what and how migrations are executed (and allows you to run custom SQL to e.g. make use of native database feature, perform data migrations, ...).

<Tip>

If you are prototyping, consider using the [`db push` command](db-push) - see [Schema prototyping with `db push`](/guides/migrate/prototyping-schema-db-push) <span class="guide"></span> for examples.
Expand Down

1 comment on commit 9b44808

@vercel
Copy link

@vercel vercel bot commented on 9b44808 Nov 23, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully deployed to the following URLs:

docs – ./

docs-prisma.vercel.app
prisma2-docs.vercel.app
docs-git-main-prisma.vercel.app

Please sign in to comment.