跳至主要内容

限制和已知问题

以下限制适用于 Prisma Migrate。

不支持 MongoDB 连接器

Prisma Migrate 目前不支持 MongoDB 连接器。

无法自动切换数据库提供商

Prisma Migrate 生成特定于您的提供商的 SQL 文件。这意味着您不能在生产环境中使用 PostgreSQL,在开发环境中使用 SQLite 的相同迁移文件,因为迁移中的语法将不兼容。

2.15.0 及更高版本中,Prisma Migrate 会检测到迁移与配置的提供商不匹配时,并打印一条有用的错误消息。例如,如果您的迁移是针对 PostgreSQL 数据库,但您的 provider 设置为 mysql

Error: P3014

The datasource provider `postgresql` specified in your schema does not match the one specified in the migration_lock.toml, mysql. Please remove your current migration directory and start a new migration history with prisma migrate dev.

要手动切换数据库提供商,您必须

  • 更改架构中 datasource 块中的 providerurl 参数
  • 归档或删除您现有的迁移历史记录 - 必须没有 ./prisma/migrations 文件夹
  • 运行 prisma migrate dev 以开始新的迁移历史记录

最后一步会创建一个新的初始迁移,该迁移从空数据库到您当前的 schema.prisma。请注意

  • 此迁移将 包含 schema.prisma 中反映的内容。如果您手动编辑了以前的迁移文件以添加自定义 SQL,则需要再次自行添加。
  • 使用新提供商新创建的数据库将不包含任何数据。

重置数据库时的数据丢失

在开发环境中,Prisma Migrate 有时会提示您重置数据库。重置会删除并重新创建数据库,这会导致数据丢失。数据库在以下情况下会被重置

  • 您显式调用 prisma migrate reset
  • 您调用 prisma migrate dev,Prisma Migrate 检测到数据库中的漂移或迁移历史冲突

prisma migrate devprisma migrate reset 命令仅用于开发环境,不应影响生产数据。

当数据库重置时,如果 Prisma Migrate 在 package.json 中检测到种子脚本,它将触发种子填充。

注意:有关重置数据库时重新创建数据的简单集成方式,请参阅我们的种子填充指南

Prisma Migrate 和 PgBouncer

如果你尝试在使用 PgBouncer 进行连接池的环境中运行 Prisma Migrate 命令,你可能会看到以下错误

Error: undefined: Database error
Error querying the database: db error: ERROR: prepared statement "s0" already exists

有关更多信息和解决方法,请参阅 Prisma Migrate 和 PgBouncer 解决方法。请关注 GitHub issue #6485 以获取更新。

非交互环境中的 Prisma Migrate

当您在非交互式环境(如 Docker、Node 脚本或 bash shell)中运行 CLI 命令时,Prisma ORM 会进行检测。此时会显示警告,指示环境是非交互式的,不支持 migrate dev 命令。

为确保 Docker 环境接收到命令,请在 interactive 模式下运行映像,使其对 migrate dev 命令作出反应。

docker run --interactive --tty <image name>
# or
docker -it <image name>

# Example usage
docker run -it node
© . This site is unofficial and not affiliated with Prisma Data, Inc.