Как работает INSERT
На этой странице
INSERT INTO таблица (столбцы) VALUES (...) добавляет строки. Столбцы перечисляют явно — так запрос не сломается при изменении порядка или добавлении столбцов, а пропущенные получат DEFAULT (или NULL). Можно вставить несколько строк одним VALUES, результат SELECT (INSERT … SELECT), а в PostgreSQL — сразу получить сгенерированные значения через RETURNING (id, created_at). Для массовой загрузки один многострочный INSERT или COPY в десятки раз быстрее цикла по одной строке. При конфликте уникальности помогает ON CONFLICT (UPSERT). Значения передают только параметрами.
Вопрос
Как работает INSERT и как быстро вставлять много строк?
Базовая вставка
INSERT INTO users (email, name)
VALUES ('anna@x.com', 'Anna')
RETURNING id, created_at;RETURNING избавляет от второго запроса «получить id только что вставленной строки».
Несколько строк
INSERT INTO tags (name)
VALUES ('sql'), ('postgres'), ('indexes');INSERT ... SELECT
-- скопировать подходящие строки
INSERT INTO orders_archive (id, user_id, total, created_at)
SELECT id, user_id, total, created_at
FROM orders
WHERE created_at < '2024-01-01';DEFAULT
INSERT INTO orders (user_id, total) VALUES (1, 500); -- status, created_at — по DEFAULT
INSERT INTO orders (user_id, total, status) VALUES (1, 500, DEFAULT);
INSERT INTO audit_events DEFAULT VALUES; -- все столбцы по умолчаниюМассовая вставка из приложения
// ✗ N запросов и N сетевых round-trip
for (const p of products) await db.query("INSERT INTO products (sku, title) VALUES ($1, $2)", [p.sku, p.title]);
// ✓ один запрос через массивы (PostgreSQL)
await db.query(
`INSERT INTO products (sku, title)
SELECT * FROM unnest($1::text[], $2::text[])`,
[products.map((p) => p.sku), products.map((p) => p.title)],
);Многострочные VALUES тоже работают, но число параметров в одном запросе ограничено (65 535 в протоколе PostgreSQL) — большие объёмы бьют на пачки по 500–5000 строк.
COPY
COPY products (sku, title, price) FROM '/data/products.csv' WITH (FORMAT csv, HEADER true);
-- из psql с клиентской машины
\copy products (sku, title, price) FROM 'products.csv' WITH (FORMAT csv, HEADER true)COPY — самый быстрый способ загрузки миллионов строк; драйверы (pg-copy-streams, psycopg) поддерживают его из кода.
Вставка и транзакции
BEGIN;
INSERT INTO orders (user_id, total) VALUES (1, 800) RETURNING id; -- допустим, 42
INSERT INTO order_items (order_id, product_id, qty, unit_price) VALUES (42, 7, 2, 400);
COMMIT;Заказ и позиции — атомарно: либо всё, либо ничего. В одном запросе это делают через CTE: WITH o AS (INSERT ... RETURNING id) INSERT INTO order_items SELECT o.id, ... FROM o.
Частые ошибки
INSERT INTO t VALUES (...)без списка столбцов.- Вставка в цикле по одной строке.
- Повторный
SELECT max(id)вместоRETURNING— гонка с параллельными вставками. - Склейка значений в SQL-строку вместо параметров.
Что важно помнить
- Всегда перечисляйте столбцы.
RETURNINGвозвращает сгенерированные значения.- Для объёмов — многострочный
INSERT,unnestилиCOPY.
Мини-шпаргалка
INSERT INTO t (a, b) VALUES (...), (...) RETURNING id.INSERT INTO t (...) SELECT ....unnest($1::text[], ...)— пачка из приложения.COPY ... FROM ... (FORMAT csv).
Документация
PostgreSQL: INSERT, PostgreSQL: COPY, PostgreSQL: Populating a Database.