跳到主要内容

限制和已知问题

以下限制适用于 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.

为了手动切换数据库提供商，您必须

  • 更改 schema 中 datasource 块中的 provider 和 url 参数
  • 归档或移除现有的迁移历史 - 不得存在 ./prisma/migrations 文件夹
  • 运行 prisma migrate dev 以开始新的迁移历史

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

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

重置数据库时的数据丢失​

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

  • 您明确调用了 prisma migrate reset 命令
  • 您调用了 prisma migrate dev 命令，且 Prisma Migrate 检测到数据库存在漂移或迁移历史冲突

prisma migrate dev 和 prisma migrate reset 命令仅设计用于开发环境，不应影响生产数据。

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

注意：对于在数据库重置时重新创建数据的一种简单集成方式，请查阅我们的数据填充指南。

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​

Prisma ORM 会检测您何时在非交互式环境（例如 Docker、Node 脚本或 bash shell）中运行 CLI 命令。此时会显示警告，表明环境是非交互式的，并且不支持 migrate dev 命令。

为了确保 Docker 环境能够接收到该命令，请以 interactive 模式运行镜像，使其能够响应 migrate dev 命令。

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

# Example usage
docker run -it node