不支持的数据库功能(Prisma Schema)
Prisma ORM 支持的数据库并非所有功能都具有 Prisma Schema 语言等效项。有关支持功能的完整列表,请参阅数据库功能矩阵。
原生数据库函数
Prisma Schema 语言支持多种函数,你可以使用它们来设置字段的默认值。以下示例使用 Prisma ORM 级别的 uuid() 函数来设置 id 字段的值
model Post {
id String @id @default(uuid())
}
但是,你也可以在关系型数据库上使用原生数据库函数通过dbgenerated(...)定义默认值(MongoDB 没有数据库级别函数的概念)。以下示例使用 PostgreSQL 的 gen_random_uuid() 函数来填充 id 字段
model User {
id String @id @default(dbgenerated("gen_random_uuid()")) @db.Uuid
}
何时使用数据库级别函数
使用数据库级别函数有两个原因
-
没有等效的 Prisma ORM 函数(例如,PostgreSQL 中的
gen_random_bytes)。 -
你无法或不想依赖
uuid()和cuid()等函数,这些函数仅在 Prisma ORM 级别实现,并且不会在数据库中体现。考虑以下示例,它将
id字段设置为随机生成的UUIDmodel Post {
id String @id @default(uuid())
}仅当你使用 Prisma Client 创建
Post时,才会生成 UUID。如果你以任何其他方式创建帖子,例如使用纯 SQL 编写的批量导入脚本,则必须自行生成 UUID。
为原生数据库函数启用 PostgreSQL 扩展
在 PostgreSQL 中,某些原生数据库函数是扩展的一部分。例如,在 PostgreSQL 12.13 及更早版本中,gen_random_uuid() 函数是 pgcrypto 扩展的一部分。
要使用 PostgreSQL 扩展,你必须首先将其安装在数据库服务器的文件系统上。
在 Prisma ORM 4.5.0 及更高版本中,你可以在 Prisma schema 中使用 postgresqlExtensions 预览功能声明扩展来激活它
generator client {
provider = "prisma-client"
output = "./generated"
previewFeatures = ["postgresqlExtensions"]
}
datasource db {
provider = "postgresql"
extensions = [pgcrypto]
}
In earlier versions of Prisma ORM, you must instead run a SQL command to activate the extension:
```sql
CREATE EXTENSION IF NOT EXISTS pgcrypto;
如果你的项目使用 Prisma Migrate,你必须将扩展作为迁移的一部分安装。请勿手动安装扩展,因为影子数据库也需要它。
如果扩展不可用,Prisma Migrate 将返回以下错误
Migration `20210221102106_failed_migration` failed to apply cleanly to a temporary database.
Database error: Error querying the database: db error: ERROR: type "pgcrypto" does not exist
不支持的字段类型
某些关系型数据库类型,例如 polygon 或 geometry,没有 Prisma Schema 语言等效项。使用 Unsupported 字段类型在 Prisma schema 中表示该字段
model Star {
id Int @id @default(autoincrement())
position Unsupported("circle")? @default(dbgenerated("'<(10,4),11>'::circle"))
}
prisma migrate dev 和 prisma db push 命令都将在数据库中创建一个类型为 circle 的 position 字段。但是,该字段在生成的 Prisma Client 中将不可用。
不支持的数据库功能
某些功能,如 SQL 视图或部分索引,无法在 Prisma schema 中表示。如果你的项目使用 Prisma Migrate,你必须将不支持的功能作为迁移的一部分包含在内。