了解使用迁移的 Prisma 工作流程
prisma 是一种现代 orm(对象关系映射),可促进 node.js 和 typescript 应用程序中与数据库的交互。 prisma 最重要的功能之一是迁移系统,它允许您保持数据库架构与应用程序的数据模型同步。在这篇文章中,我们将探索使用迁移的 prisma 工作流程。
什么是迁移?
迁移是一种以系统化和版本化的方式控制和应用数据库模式更改的方法。它们允许您以增量和可逆的方式定义数据库的结构更改,例如创建或更改表。
prisma 迁移工作流程
prisma 中迁移的典型工作流程涉及以下步骤:
- 安装和初始配置
- 方案定义
- 创建迁移
- 移民申请
- 迁移管理
第 1 步:安装和初始配置
首先,我们需要将prisma安装到项目中并初始化:
npm install @prisma/clientnpx prisma init
此命令创建一个包含 schema.prisma 文件的 prism 目录,我们在其中定义数据模型。
第 2 步:架构定义
在 schema.prisma 文件中,我们定义了表示数据库表的模型。例如,我们定义一个模型 user:
model user { id int @id @default(autoincrement()) email string @unique name string?}
在这里,我们定义一个包含 id、email 和 name 列的 user 表。
第 3 步:创建迁移
定义或更改架构后,我们创建一个迁移以反映数据库中的这些更改:
npx prisma migrate dev --name init
migrate dev 命令创建一个新的迁移并将更改应用到数据库。 --name 参数允许您为迁移指定一个描述性名称,例如上面示例中的 init 。
第四步:移民申请
当我们使用 migrate dev 命令时,迁移会自动应用于数据库。这确保数据库始终与 schema.prisma 中定义的数据模型同步。
如果你想在生产环境应用迁移,请使用命令:
npx prisma migrate deploy
此命令将所有挂起的迁移应用到生产数据库。
第5步:迁移管理
prisma 保留应用于数据库的所有迁移的历史记录。这对于跟踪更改并在必要时恢复迁移非常有用。要查看迁移历史,您可以使用:
npx prisma migrate status
此命令显示迁移的当前状态,包括哪些迁移已应用,哪些迁移正在等待。
实际例子
让我们看一个实际示例,了解如何向用户模型添加新字段并为此更改创建迁移。
将字段添加到 schema.prisma 中的 user 模型:
model user { id int @id @default(autoincrement()) email string @unique name string? birthdate datetime?}
创建新迁移:
npx prisma migrate dev --name add-birthdate-to-user
应用迁移:
migrate dev 命令已经将迁移应用到数据库。现在数据库将在 user 表中添加新的生日字段。
检查迁移状态:
npx prisma migrate status
此命令将显示添加出生日期到用户迁移已成功应用。
结论
prisma 使用迁移的工作流程是管理数据库架构更改的高效且安全的方法。通过一系列清晰的步骤——定义模式、创建迁移、应用更改和管理迁移历史记录——可以使数据库与应用程序的数据模型保持同步,从而促进软件的开发和维护。
使用 prisma,您不仅可以简化数据库管理,而且还获得了一个强大的工具来确保所有更改都是可追踪和可逆的,从而有助于更强大和敏捷的开发流程。