跳到主要内容

一对一关系

本页介绍了一对一关系，并解释了如何在您的 Prisma schema 中使用它们。

概述​

一对一 (1-1) 关系是指关系双方最多可以连接一个记录的关系。在下面的示例中，User 和 Profile 之间存在一对一关系

model User {
  id      Int      @id @default(autoincrement())
  profile Profile?
}

model Profile {
  id     Int  @id @default(autoincrement())
  user   User @relation(fields: [userId], references: [id])
  userId Int  @unique // relation scalar field (used in the `@relation` attribute above)
}

userId 关系标量是底层数据库中外键的直接表示。这种一对一关系表达了以下内容

  • “一个用户可以拥有零个或一个个人资料”（因为 profile 字段在 User 上是可选的）
  • “一个个人资料必须始终连接到一个用户”

在前面的示例中，Profile 模型的 user 关系字段引用了 User 模型的 id 字段。您也可以引用不同的字段。在这种情况下，您需要使用 @unique 属性标记该字段，以保证每个 Profile 仅连接到一个 User。在以下示例中，user 字段引用了 User 模型中标记有 @unique 属性的 email 字段

model User {
  id      Int      @id @default(autoincrement())
  email   String   @unique // <-- add unique attribute
  profile Profile?
}

model Profile {
  id        Int    @id @default(autoincrement())
  user      User   @relation(fields: [userEmail], references: [email])
  userEmail String @unique // relation scalar field (used in the `@relation` attribute above)
}
警告

在 MySQL 中，您可以创建一个外键，该外键仅在被引用端具有索引，而不是唯一约束。在 Prisma ORM 4.0.0 及更高版本中，如果您内省这种类型的关系，它将触发验证错误。要解决此问题，您需要在被引用的字段中添加 @unique 约束。

关系型数据库中的多字段关系​

仅在关系型数据库中，您还可以使用 多字段 ID 来定义 1-1 关系

model User {
  firstName String
  lastName  String
  profile   Profile?

  @@id([firstName, lastName])
}

model Profile {
  id            Int    @id @default(autoincrement())
  user          User   @relation(fields: [userFirstName, userLastName], references: [firstName, lastName])
  userFirstName String // relation scalar field (used in the `@relation` attribute above)
  userLastName  String // relation scalar field (used in the `@relation` attribute above)

  @@unique([userFirstName, userLastName])
}

数据库中的 1-1 关系​

关系型数据库​

以下示例演示了如何在 SQL 中创建 1-1 关系

CREATE TABLE "User" (
    id SERIAL PRIMARY KEY
);
CREATE TABLE "Profile" (
    id SERIAL PRIMARY KEY,
    "userId" INTEGER NOT NULL UNIQUE,
    FOREIGN KEY ("userId") REFERENCES "User"(id)
);

请注意，外键 userId 上有一个 UNIQUE 约束。如果缺少此 UNIQUE 约束，则该关系将被视为 1-n 关系。

以下示例演示了如何在 SQL 中使用复合键（firstName 和 lastName）创建 1-1 关系

CREATE TABLE "User" (
    firstName TEXT,
    lastName TEXT,
    PRIMARY KEY ("firstName","lastName")
);
CREATE TABLE "Profile" (
    id SERIAL PRIMARY KEY,
    "userFirstName" TEXT NOT NULL,
    "userLastName" TEXT NOT NULL,
    UNIQUE ("userFirstName", "userLastName")
    FOREIGN KEY ("userFirstName", "userLastName") REFERENCES "User"("firstName", "lastName")
);

MongoDB​

对于 MongoDB，Prisma ORM 当前使用 规范化的数据模型设计，这意味着文档通过 ID 相互引用，方式类似于关系型数据库。

以下 MongoDB 文档表示一个 User

{ "_id": { "$oid": "60d58e130011041800d209e1" }, "name": "Bob" }

以下 MongoDB 文档表示一个 Profile - 请注意 userId 字段，它引用了 User 文档的 $oid

{
  "_id": { "$oid": "60d58e140011041800d209e2" },
  "bio": "I'm Bob, and I like drawing.",
  "userId": { "$oid": "60d58e130011041800d209e1" }
}

必需和可选的 1-1 关系字段​

在一对一关系中，没有关系标量（表示数据库中外键的字段）的关系侧必须是可选的

model User {
  id      Int      @id @default(autoincrement())
  profile Profile? // No relation scalar - must be optional
}

此限制是在 2.12.0 中引入的。

但是，您可以选择具有关系标量的关系侧应该是可选的还是强制的。

强制性 1-1 关系​

在以下示例中，profile 和 profileId 是强制性的。这意味着您不能创建 User 而不连接或创建 Profile

model User {
  id        Int     @id @default(autoincrement())
  profile   Profile @relation(fields: [profileId], references: [id]) // references `id` of `Profile`
  profileId Int     @unique // relation scalar field (used in the `@relation` attribute above)
}

model Profile {
  id   Int   @id @default(autoincrement())
  user User?
}

可选的 1-1 关系​

在以下示例中，profile 和 profileId 是可选的。这意味着您可以创建一个用户，而无需连接或创建 Profile

model User {
  id        Int      @id @default(autoincrement())
  profile   Profile? @relation(fields: [profileId], references: [id]) // references `id` of `Profile`
  profileId Int?     @unique // relation scalar field (used in the `@relation` attribute above)
}

model Profile {
  id   Int   @id @default(autoincrement())
  user User?
}

选择哪一侧应存储 1-1 关系中的外键​

在 1-1 关系中，您可以自行决定要在关系的哪一侧使用 @relation 属性进行注释（因此持有外键）。

在以下示例中，Profile 模型上的关系字段使用 @relation 属性进行注释。userId 是底层数据库中外键的直接表示

model User {
  id      Int      @id @default(autoincrement())
  profile Profile?
}

model Profile {
  id     Int  @id @default(autoincrement())
  user   User @relation(fields: [userId], references: [id])
  userId Int  @unique // relation scalar field (used in the `@relation` attribute above)
}

您还可以使用 @relation 属性注释关系的另一侧。以下示例注释了 User 模型上的关系字段。profileId 是底层数据库中外键的直接表示

model User {
  id        Int      @id @default(autoincrement())
  profile   Profile? @relation(fields: [profileId], references: [id])
  profileId Int?     @unique // relation scalar field (used in the `@relation` attribute above)
}

model Profile {
  id   Int   @id @default(autoincrement())
  user User?
}