Nested Write（update）

update メソッドの data 内でリレーション先のレコードを同時に操作できます。

create の Nested Write で使える操作に加えて、update / delete / deleteMany / disconnect / set 操作が利用できます。

説明例用のシート

リレーション定義のシート例を使用します。

使用できる操作

操作	manyToOne / oneToOne	oneToMany	manyToMany
create	単一のみ	単一 / 配列	単一 / 配列
createMany	-	対応	-
connect	対応	単一 / 配列	単一 / 配列
connectOrCreate	対応	単一 / 配列	単一 / 配列
update	対応	単一 / 配列	-
delete	対応	単一 / 配列	-
deleteMany	-	単一 / 配列	-
disconnect	対応	単一 / 配列	単一 / 配列
set	-	対応	対応

create

リレーション先のレコードを新規作成して関連付けます。create の Nested Write と同じ動作です。

// oneToMany: ユーザー更新時に新しい投稿を作成
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      create: { id: 4, title: "新しい投稿", published: true },
    },
  },
});

connect

既存のリレーション先レコードを関連付けます。

// manyToOne: 投稿の著者を既存ユーザーに変更
gassma.Posts.update({
  where: { id: 1 },
  data: {
    author: {
      connect: { name: "Bob" },
    },
  },
});

connectOrCreate

既存のレコードがあれば関連付け、なければ新規作成して関連付けます。

// manyToOne: 著者が存在すれば接続、なければ作成
gassma.Posts.update({
  where: { id: 1 },
  data: {
    author: {
      connectOrCreate: {
        where: { name: "Dave" },
        create: { id: 4, name: "Dave", email: "dave@example.com" },
      },
    },
  },
});

update

関連するレコードを更新します。

manyToOne / oneToOne

更新データを直接指定します。

// manyToOne: 投稿の著者名を更新
gassma.Posts.update({
  where: { id: 1 },
  data: {
    author: {
      update: { name: "Alice Updated" },
    },
  },
});

oneToMany

where と data を指定して更新対象を絞り込みます。配列で複数指定も可能です。

// oneToMany: 特定の投稿を更新
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      update: {
        where: { id: 1 },
        data: { title: "更新後のタイトル" },
      },
    },
  },
});

// 複数の投稿を同時に更新
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      update: [
        { where: { id: 1 }, data: { title: "タイトルA" } },
        { where: { id: 2 }, data: { title: "タイトルB" } },
      ],
    },
  },
});

delete

関連するレコードを削除します。

manyToOne / oneToOne

delete: true を指定すると、関連先のレコードを削除し、自身の FK を null に設定します。

// manyToOne: 投稿の著者を削除（投稿の authorId は null になる）
gassma.Posts.update({
  where: { id: 1 },
  data: {
    author: { delete: true },
  },
});

oneToMany

where 条件を指定して削除対象を絞り込みます。配列で複数指定も可能です。

// oneToMany: 特定の投稿を削除
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      delete: { id: 3 },
    },
  },
});

// 複数削除
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      delete: [{ id: 2 }, { id: 3 }],
    },
  },
});

deleteMany

条件に合致する関連レコードを一括削除します。oneToMany でのみ使用できます。

// oneToMany: 未公開の投稿を全て削除
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      deleteMany: { published: false },
    },
  },
});

// 複数条件で削除
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      deleteMany: [
        { published: false },
        { title: "下書き" },
      ],
    },
  },
});

disconnect

リレーションの関連付けを解除します。レコード自体は削除されません。

manyToOne / oneToOne

disconnect: true を指定すると、自身の FK を null に設定します。

// manyToOne: 投稿と著者の関連付けを解除
gassma.Posts.update({
  where: { id: 1 },
  data: {
    author: { disconnect: true },
  },
});
// => Posts の authorId が null になる

oneToMany

where 条件を指定して、関連レコードの FK を null に設定します。

// oneToMany: 特定の投稿の関連付けを解除
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      disconnect: { id: 1 },
    },
  },
});
// => Posts の id: 1 の authorId が null になる

// 複数の関連付けを解除
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      disconnect: [{ id: 1 }, { id: 2 }],
    },
  },
});

manyToMany

中間テーブルのレコードを削除します。

// manyToMany: タグの関連付けを解除
gassma.Posts.update({
  where: { id: 1 },
  data: {
    tags: {
      disconnect: { id: 3 },
    },
  },
});
// => PostTags テーブルから対応するレコードが削除される

set

リレーションの関連付けを全て入れ替えます。oneToMany と manyToMany でのみ使用できます。

oneToMany

全ての子レコードの FK を null に設定した後、指定したレコードの FK を親に設定します。

// oneToMany: Alice の投稿を id: 1 と id: 2 のみに置換
gassma.Users.update({
  where: { name: "Alice" },
  data: {
    posts: {
      set: [{ id: 1 }, { id: 2 }],
    },
  },
});
// => 既存の全投稿の authorId が null になった後、
//    id: 1 と id: 2 の authorId が Alice の id に設定される

manyToMany

中間テーブルのレコードを全削除した後、指定したレコードとの関連を新規作成します。

// manyToMany: 投稿のタグを完全に入れ替え
gassma.Posts.update({
  where: { id: 1 },
  data: {
    tags: {
      set: [{ id: 10 }, { id: 11 }],
    },
  },
});
// => PostTags から投稿 id: 1 の全レコードが削除された後、
//    新しい関連レコードが作成される

複数操作の組み合わせ

1 つの update 内で複数のリレーション操作を組み合わせることも可能です。

gassma.Users.update({
  where: { name: "Alice" },
  data: {
    name: "Alice Updated",
    posts: {
      create: { id: 5, title: "新記事", published: true },
      update: { where: { id: 1 }, data: { title: "更新済み" } },
      delete: { id: 3 },
    },
  },
});

エラー

エラー	原因
NestedWriteWithoutRelationsError	リレーション定義なしで Nested Write を実行した
NestedWriteInvalidOperationError	リレーション種別に対応しない操作を指定した
NestedWriteConnectNotFoundError	connect / connectOrCreate で対象レコードが見つからなかった