PostgreSQLСредний

UPSERT (ON CONFLICT)

Вставляет строку или обновляет её при конфликте уникального ключа. Атомарная операция.

Синтаксис

INSERT INTO table (cols) VALUES (...)
ON CONFLICT (unique_col) DO UPDATE
  SET col = EXCLUDED.col;

Объяснение

UPSERT = INSERT + UPDATE при конфликте. В PostgreSQL: ON CONFLICT DO UPDATE или ON CONFLICT DO NOTHING. Атомарен — нет race condition между проверкой и вставкой. Безопаснее, чем проверять через SELECT + INSERT/UPDATE в приложении.

Пример

-- Атомарный счётчик
INSERT INTO page_views (page, views) VALUES ('home', 1)
ON CONFLICT (page) DO UPDATE
  SET views = page_views.views + 1;

-- Обновить профиль или создать
INSERT INTO profiles (user_id, bio) VALUES ($1, $2)
ON CONFLICT (user_id) DO UPDATE
  SET bio = EXCLUDED.bio, updated_at = NOW();

Связанные термины

PRIMARY KEYУникальный идентификатор строки. Автоматически создаёт уникальный индекс, не допускает NULL.RETURNINGВозвращает строки после INSERT, UPDATE или DELETE без дополнительного SELECT.Транзакция (TRANSACTION)Группа SQL операций, выполняемых как единое целое: либо все успешно, либо ни одна.

Анекдоты по теме

PostgreSQL Extensions: — uuid-ossp: генерация UUID — pg_trgm: поиск по подстроке — postgis: геопространственные данные — timescaledb: временные ряды — pg_stat_statements: статистика запросов — hstore: key-value в колонке — pg_cron: cron задачи внутри БД PostgreSQL — это не просто база. Это платформа.

— Что такое schema в PostgreSQL? — Пространство имён внутри базы данных. — Как папка? — Да. public — дефолтная схема. Можно создать orders_schema, users_schema. — Зачем? — Разграничение прав, мультитенантность, логическое разделение модулей.

Начинающий: — Я написал WHERE возраст = '18'. А база говорит, что ничего нет. Опытный: — А у тебя возраст — число или текст? Начинающий: — А это важно? Опытный: — Очень. '18' и 18 — это разные вещи.

Все анекдоты →

Потренироваться →← Все термины