Как создавать, изменять и удалять данные в Drizzle?
На этой странице
insert, update и delete строят соответствующий SQL. Метод returning() позволяет сразу получить созданные, изменённые или удалённые строки PostgreSQL.
Вопрос
Как создавать, изменять и удалять данные в Drizzle? Как получить результат операции и обработать конфликт уникальности?
Создание
const [createdUser] = await db
.insert(users)
.values({
name: input.name,
email: input.email,
})
.returning();createdUser содержит и значения, заданные базой: идентификатор и даты.
Несколько строк
await db.insert(users).values([
{ name: "Анна", email: "anna@example.com" },
{ name: "Илья", email: "ilya@example.com" },
]);Конфликт уникальности
const [createdUser] = await db
.insert(users)
.values(input)
.onConflictDoNothing({ target: users.email })
.returning();Если почта занята, массив будет пустым. Для обычного API также можно позволить PostgreSQL вернуть ошибку 23505 и преобразовать её в 409.
Частичное изменение
const [updatedUser] = await db
.update(users)
.set({
...input,
updatedAt: new Date(),
})
.where(eq(users.id, id))
.returning();Если строка не найдена, updatedUser равен undefined.
Удаление
const [deletedUser] = await db
.delete(users)
.where(eq(users.id, id))
.returning({ id: users.id });Опасность запроса без where
// Изменит все строки.
await db.update(users).set({ isBlocked: true });
// Удалит все строки.
await db.delete(users);Drizzle делает запрос явным, но не угадывает намерение разработчика. Включай строгие проверки Drizzle Kit и внимательно просматривай код изменения данных.
Проверка входа остаётся обязательной
const input = updateUserSchema.parse(request.body);Не передавай request.body прямо в .set(): клиент может попытаться изменить id, роль или другое запрещённое поле.
Что важно помнить
.returning()возвращает строки, которые реально изменил PostgreSQL.onConflictDoNothing()иonConflictDoUpdate()решают конфликт уникальности на стороне базы.updateиdeleteбез.where()затрагивают всю таблицу.- В
.set()передаются только проверенные поля, а не весьrequest.body.
Мини-шпаргалка
.insert().values()создаёт строки..update().set().where()изменяет выбранные строки..delete().where()удаляет выбранные строки..returning()возвращает результат PostgreSQL.- Никогда не передавай необработанный
request.bodyв запрос.