心理模型
本指南概念性地概述了在使用关系数据库时如何使用 Prisma Migrate 进行数据库迁移。它涵盖了：什么是数据库迁移、它们的价值，以及什么是 Prisma Migrate，以及如何在不同环境中使用 Prisma Migrate 演进您的数据库 schema。
如果您正在使用 MongoDB，请使用 prisma db push 来演进您的 schema。
什么是数据库迁移？
数据库迁移是一组受控的更改，用于修改和演进您的数据库 schema 的结构。迁移帮助您将数据库 schema 从一种状态过渡到另一种状态。例如，在迁移中，您可以创建或删除表和列，拆分表中的字段，或向数据库添加类型和约束。
演进数据库 schema 的模式
本节介绍用于演进数据库 schema 的通用 schema 迁移模式。
两种主要的 schema 迁移模式是
- 模型/实体优先迁移： 使用这种模式，您可以使用代码定义数据库 schema 的结构，然后使用迁移工具生成 SQL，例如，用于同步您的应用程序和数据库 schema。
- 数据库优先迁移： 使用这种模式，您定义数据库的结构，并使用 SQL 将其应用到您的数据库。然后，您内省数据库以生成描述数据库结构的代码，从而同步您的应用程序和数据库 schema。
注意
为了简洁起见，我们选择了上述术语来描述演进数据库 schema 的不同模式。其他工具和库可能使用不同的术语来描述不同的模式。
迁移文件 (SQL) 理想情况下应与您的应用程序代码一起存储。它们还应在版本控制中进行跟踪，并与团队中其他开发人员共享。
迁移提供状态管理，帮助您跟踪数据库的状态。
迁移还允许您在特定时间点复制数据库的状态，这在与团队的其他成员协作时非常有用，例如在不同分支之间切换。
有关数据库迁移的更多信息，请参阅 Prisma 数据指南。
什么是 Prisma Migrate？
Prisma Migrate 是一种数据库迁移工具，支持模型/实体优先迁移模式，用于管理本地环境和生产环境中的数据库 schema。
在您的项目中使用 Prisma Migrate 的工作流程将是迭代式的，如下所示
本地开发环境（功能分支）
- 演进您的 Prisma schema
- 使用
prisma migrate dev或prisma db push将您的 Prisma schema 与本地开发数据库的数据库 schema 同步
预览/暂存环境（功能拉取请求）
- 将您的更改推送到功能拉取请求
- 使用 CI 系统（例如 GitHub Actions）使用
prisma migrate deploy将您的 Prisma schema 和迁移历史记录与您的预览数据库同步
生产环境（主分支）
- 将您的应用程序代码从功能分支合并到您的主分支
- 使用 CI 系统（例如 GitHub Actions）使用
prisma migrate deploy将您的 Prisma schema 和迁移历史记录与您的生产数据库同步
Prisma Migrate 如何跟踪迁移状态
Prisma Migrate 使用以下状态片段来跟踪您的数据库 schema 的状态
- Prisma schema：您的真理来源，定义数据库 schema 的结构。
- 迁移历史记录：
prisma/migrations文件夹中的 SQL 文件，表示对数据库 schema 所做更改的历史记录。 - 迁移表：数据库中的
prisma_migrations表，用于存储已应用于数据库的迁移的元数据。 - 数据库 schema：数据库的状态。
使用 Prisma Migrate 的要求
- 理想情况下，您应该每个环境使用一个数据库。例如，您可能需要为开发、预览和生产环境分别设置数据库。
- 您在开发环境中使用的数据库是可随意使用的 — 您可以根据需要轻松创建、使用和删除数据库。
- 每个环境中使用的数据库配置应保持一致。这对于确保跨工作流程的特定迁移对数据库产生相同的更改非常重要。
- Prisma schema 充当真理来源 — 描述您的 数据库 schema 的形状。
使用 Prisma Migrate 演进您的数据库 schema
本节介绍如何在不同环境（开发、暂存和生产）中使用 Prisma Migrate 演进您的数据库 schema。
开发环境（本地）中的 Prisma Migrate
使用 prisma migrate dev 跟踪您的迁移历史记录
prisma migrate dev 命令允许您跟踪对数据库所做的更改。prisma migrate dev 命令自动生成 SQL 迁移文件（保存在 /prisma/migrations 中）并将它们应用到数据库。当迁移应用到数据库时，数据库中的迁移表 (_prisma_migrations) 也会更新。
prisma migrate dev 命令使用以下状态片段跟踪数据库的状态
- Prisma schema
- 迁移历史记录
- 迁移表
- 数据库 schema
注意：用于跟踪迁移状态的状态片段与 Prisma Migrate 如何跟踪迁移状态 章节中描述的相同。
您可以使用 --create-only 标志在将迁移应用到数据库之前对其进行自定义。例如，如果您想重命名列而不造成任何数据丢失，或者加载数据库扩展（在 PostgreSQL 中）和数据库视图（目前不支持），您可能需要编辑迁移。
在幕后，Prisma Migrate 使用 影子数据库 来检测 schema 漂移 并生成新的迁移。
注意：
prisma migrate dev旨在仅在开发环境中使用，并配合可随意使用的数据库。
如果 prisma migrate dev 检测到 schema 漂移或迁移历史记录冲突，系统将提示您重置（删除并重新创建数据库）数据库，以同步迁移历史记录和数据库 schema。
展开以查看使用卡通解释的影子数据库
解决 schema 漂移
当预期的数据库 schema 与迁移历史记录中的内容不同时，就会发生 schema 漂移。例如，当您手动更新数据库 schema 而没有相应地更新 Prisma schema 和 prisma/migrations 时，可能会发生这种情况。
对于这种情况，您可以使用 prisma migrate diff 命令来比较您的迁移历史记录并还原对数据库 schema 所做的更改。
您可以使用 migrate diff 生成 SQL，它可以
- 还原数据库 schema 中所做的更改，使其与当前的 Prisma schema 同步
- 向前移动您的数据库 schema，以应用来自 Prisma schema 和
/migrations的缺失更改
然后，您可以使用 prisma db execute 命令将更改应用到您的数据库。
原型化您的 schema
prisma db push 命令允许您同步您的 Prisma schema 和数据库 schema，而无需持久化迁移 (/prisma/migrations)。prisma db push 命令使用以下状态片段跟踪数据库的状态
- Prisma schema
- 数据库 schema
prisma db push 命令在以下情况下很有用
- 您想快速原型化和迭代本地的 schema 设计，而无需将这些更改部署到其他环境，例如其他开发人员，或暂存和生产环境。
- 您优先考虑达到期望的最终状态，而不是为达到该最终状态而执行的更改或步骤（无法预览
prisma db push所做的更改） - 您不需要控制 schema 更改如何影响数据。无法编排 schema 和数据迁移 - 如果
prisma db push预计更改将导致数据丢失，您可以选择使用--accept-data-loss选项接受数据丢失或停止该过程 - 无法自定义更改。
如果 prisma db push 命令检测到对您的数据库 schema 的破坏性更改，它将提示您重置数据库。例如，当您向具有现有内容的表添加必填字段而未提供默认值时，就会发生这种情况。
schema 漂移发生在您的数据库 schema 与您的迁移历史记录和迁移表不同步时。
暂存和生产环境中的 Prisma Migrate
同步您的迁移历史记录
prisma migrate deploy 命令允许您将开发环境中的迁移历史记录与暂存或生产环境中的数据库同步。
在幕后，migrate deploy 命令
- 比较已应用的迁移（捕获的
_prisma_migrations）和迁移历史记录 (/prisma/migrations) - 应用待处理的迁移
- 使用新的迁移更新
_prisma_migrations表
该命令应在自动化的 CI/CD 环境中运行，例如 GitHub Actions。
如果您没有迁移历史记录 (/migrations)，即使用 prisma db push，您将必须继续在暂存和生产环境中使用 prisma db push。请注意应用于数据库 schema 的更改，因为其中一些更改可能具有破坏性。例如，prisma db push 无法判断您何时执行列重命名。它将提示数据库重置（删除并重新创建）。