Задача из жизни: покупатель Борис передумал, и все его заказы, которые ещё не оплачены, нужно перевести в статус cancelled. Это одна команда UPDATE — и ровно та ситуация, в которой ошибка в условии стоит чужих данных.
Ты сделаешь правку по ритуалу из прошлого урока, по пути один раз нарочно ошибёшься и откатишься. Понадобятся два терминала: во втором ты посмотришь на базу глазами другого подключения.
Шаг 1. Подключиться
Как и раньше, работаем в интерактивном psql: его история проверяется при сдаче. Флаг -U — имя пользователя.
cd ~/infra/db docker compose exec db psql -U shop shop=#
Шаг 2. Найти номер покупателя
Правку делают по номеру, а не по имени: имён может быть два одинаковых, номер — один.
shop=# SELECT id FROM customers WHERE name = 'Борис'; id ---- 2 (1 row)
Шаг 3. Посчитать, сколько строк заденет правка
Это главный шаг ритуала. Условие пишется один раз здесь и потом слово в слово переносится в UPDATE.
shop=# SELECT count(*) FROM orders WHERE customer_id = 2 AND status = 'new'; count ------- 13333 (1 row)
Запомни число 13333. Через два шага UPDATE должен назвать ровно его.
Шаг 4. Открыть черновик
BEGIN начинает транзакцию. В приглашении появится звёздочка.
shop=# BEGIN; BEGIN shop=*#
Шаг 5. Правка и сверка
Скопируй условие из шага 3 и допиши впереди UPDATE … SET.
shop=*# UPDATE orders SET status = 'cancelled' WHERE customer_id = 2 AND status = 'new'; UPDATE 13333
Число совпало. Посмотри, как теперь выглядят заказы Бориса:
shop=*# SELECT status, count(*) FROM orders WHERE customer_id = 2 GROUP BY status; status | count -----------+------- cancelled | 13333 done | 13333 paid | 13334 (3 rows)
Новых не осталось, оплаченные и выполненные не тронуты. Так и задумано.
Шаг 6. Взгляд из второго терминала
Открой второй терминал, перейди в ~/infra/db и подключись тем же docker compose exec db psql -U shop. Выполни тот же запрос с группировкой:
shop=# SELECT status, count(*) FROM orders WHERE customer_id = 2 GROUP BY status; status | count --------+------- done | 13333 new | 13333 paid | 13334 (3 rows)
Второе подключение видит старые статусы. Пока нет COMMIT, правка существует только в первом терминале. Именно поэтому её можно выбросить без следа. Второй терминал не закрывай, он ещё понадобится.
Шаг 7. Откатить
Вернись в первый терминал. Представь, что заказчик позвонил и сказал: «Подождите, не отменяйте». Выбрасываем черновик:
shop=*# ROLLBACK; ROLLBACK shop=#
Звёздочка пропала, транзакции больше нет. Повтори запрос с группировкой — статус new вернулся, cancelled нет.
Шаг 8. Нарочно ошибиться
Теперь самое ценное упражнение раздела. Открой транзакцию и выполни удаление без условия — ту самую ошибку, которая в проде стоит работы.
shop=# BEGIN; BEGIN shop=*# DELETE FROM orders; DELETE 200000
Двести тысяч заказов исчезли — для тебя. Проверь во втором терминале SELECT count(*) FROM orders;: там по-прежнему 200000. Теперь откат в первом:
shop=*# ROLLBACK; ROLLBACK shop=# SELECT count(*) FROM orders; count -------- 200000 (1 row)
Запомни ощущение от строки DELETE 200000. Без BEGIN на этом месте начиналось бы восстановление из копии.
Шаг 9. Сделать правку по-настоящему
Заказчик перезвонил: «Всё-таки отменяйте». Повтори ритуал от начала до конца, на этот раз с фиксацией.
shop=# BEGIN; BEGIN shop=*# UPDATE orders SET status = 'cancelled' WHERE customer_id = 2 AND status = 'new'; UPDATE 13333 shop=*# COMMIT; COMMIT
Число снова 13333 — можно фиксировать. После COMMIT изменение окончательное, и ROLLBACK его уже не вернёт.
Шаг 10. Проверить из второго терминала
Теперь второй терминал должен увидеть отменённые заказы:
shop=# SELECT status, count(*) FROM orders WHERE customer_id = 2 GROUP BY status; status | count -----------+------- cancelled | 13333 done | 13333 paid | 13334 (3 rows)
Правка видна всем — она записана. Выйди из psql в обоих терминалах командой \q, чтобы сохранилась история.
Если что-то пошло не так
Если второй терминал на шаге 10 показывает старые числа — в первом ещё не набран COMMIT. Посмотри на приглашение первого терминала: звёздочка значит, что транзакция открыта. Ждать второй терминал при этом не будет: в Postgres чтение никогда не ждёт чужой открытой транзакции, оно просто видит данные до её начала. Зависнет только тот, кто попробует изменить те же строки, — например, UPDATE во втором терминале. Как находить такие зависания, когда второго терминала под рукой нет, — тема миссии раздела.
Если UPDATE назвал число, отличное от шага 3, — не фиксируй. Сделай ROLLBACK и сравни условия буква в букву: чаще всего виновата опечатка в статусе или лишний пробел внутри кавычек.
Что дальше
Данные ты читаешь и меняешь. Следующий урок — почему один запрос отвечает за миллисекунду, а другой ползёт секунды: индекс и EXPLAIN.