限制和已知问题
以下限制适用于 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块中的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 中检测到种子脚本,它将触发种子填充。
注意:有关重置数据库时重新创建数据的简单集成方式,请参阅我们的种子填充指南。
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