跳到正文
Drizzle

SQL Update

db.update() 完整参考:set 对象、undefined 与 null 的区别、sql 表达式自增、where 过滤、returning 与 PostgreSQL 的 update … from 多表更新。

本页示例沿用快速开始中的 db 实例与 users、cities 表。update 的基本形态是 db.update(表).set(值).where(条件)。

set:更新哪些列

set() 的键必须是 schema 中定义的列,值自动参数化:

import { eq } from 'drizzle-orm';
import { db } from './db';
import { users } from './db/schema';

await db.update(users).set({ name: 'Mr. Dan' }).where(eq(users.name, 'Dan'));
// update "users" set "name" = $1 where "name" = $2

两个容易踩坑的取值规则:

值行为
undefined该列被忽略,不出现在 SET 中(适合“传了才改”的补丁式更新)
null该列被显式设为 NULL(列不可为空时报错)
// PATCH 场景:body 里没传的字段保持原值
await db.update(users).set({ name: body.name, bio: body.bio }).where(eq(users.id, id));

sql 表达式:自增与数据库函数

值的位置可以放任何 SQL 表达式,自增在数据库端原子完成,避免“读-改-写”竞态:

import { sql } from 'drizzle-orm';

await db.update(users).set({ age: sql`${users.age} + 1` }).where(eq(users.id, 1));

await db.update(users).set({ updatedAt: sql`now()` }).where(eq(users.id, 1));

where 与运算符

where() 接收运算符表达式,可组合 and/or/inArray 等:

import { and, eq, lt } from 'drizzle-orm';

await db.update(users)
  .set({ verified: false })
  .where(and(eq(users.role, 'member'), lt(users.lastLoginAt, new Date('2025-01-01'))));

不写 where 会更新全表

db.update(users).set(...) 不带 where() 时更新表中所有行。执行前确认条件存在,必要时在事务中先 select 校验。

returning:拿回更新后的行

// 整行返回
await db.update(users).set({ name: 'Mr. Dan' }).where(eq(users.name, 'Dan')).returning();

// 部分返回
await db.update(users)
  .set({ name: 'Mr. Dan' })
  .where(eq(users.name, 'Dan'))
  .returning({ id: users.id, name: users.name });

多表更新:update … from(PostgreSQL)

PG 支持 UPDATE … FROM,用另一张表的列为本表赋值,.from() 中也可以使用 alias():

import { and, eq } from 'drizzle-orm';
import { alias } from 'drizzle-orm/pg-core';
import { cities } from './db/schema';

await db.update(users)
  .set({ cityId: cities.id })
  .from(cities)
  .where(and(eq(cities.name, 'Seattle'), eq(users.name, 'John')));
// update "users" set "city_id" = "cities"."id" from "cities" where ...

// 表别名
const c = alias(cities, 'c');
await db.update(users).set({ cityId: c.id }).from(c).where(eq(c.name, 'Seattle'));

.returning() 还可以返回 join 进来的表的列。

MySQL / SQLite 的替代写法

.from() 是 PostgreSQL 专属语法。MySQL/SQLite 场景下,通用做法是用子查询圈定行、用 sql 表达式取值:where(inArray(users.id, subquery)) 配合 set({ col: sql`(select ...)` });复杂的多表 UPDATE 也可用 db.execute(sql`...`) 写原生 SQL。

WITH update

与 select 一样,update 也能挂在 CTE 后面:

import { eq, inArray } from 'drizzle-orm';

const target = db.$with('target').as(
  db.select({ id: users.id }).from(users).where(eq(users.verified, false)),
);

await db.with(target)
  .update(users)
  .set({ role: 'guest' })
  .where(inArray(users.id, db.select({ id: target.id }).from(target)));

常见坑

  • set({}) 空对象会报错;动态构造 set 时先过滤 undefined 再判空。
  • 自增务必用 sql`${col} + 1`,不要先查询再在 JS 里加——并发下会丢更新。
  • where() 只能调用一次,分步拼装用 .$dynamic(),见 SQL Select。