跳至主要内容

一对一关系

此页面介绍了一对一关系，并解释了如何在 Prisma 模式中使用它们。

概述​

一对一 (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 关系。

以下示例演示了如何使用复合键 (firstName 和 lastName) 在 SQL 中创建 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 是必需的。这意味着您不能在不连接或创建 Profile 的情况下创建 User。

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?
}