Provision
—— XP

Практика: правка в транзакции

практика~20 минут+450 XP

Задача из жизни: покупатель Борис передумал, и все его заказы, которые ещё не оплачены, нужно перевести в статус cancelled. Это одна команда UPDATE — и ровно та ситуация, в которой ошибка в условии стоит чужих данных.

Ты сделаешь правку по ритуалу из прошлого урока, по пути один раз нарочно ошибёшься и откатишься. Понадобятся два терминала: во втором ты посмотришь на базу глазами другого подключения.

Шаг 1. Подключиться

Как и раньше, работаем в интерактивном psql: его история проверяется при сдаче. Флаг -U — имя пользователя.

ubuntu@stand:~$
cd ~/infra/db
docker compose exec db psql -U shop
shop=#

Шаг 2. Найти номер покупателя

Правку делают по номеру, а не по имени: имён может быть два одинаковых, номер — один.

ubuntu@stand:~$
shop=# SELECT id FROM customers WHERE name = 'Борис';
 id
----
  2
(1 row)

Шаг 3. Посчитать, сколько строк заденет правка

Это главный шаг ритуала. Условие пишется один раз здесь и потом слово в слово переносится в UPDATE.

ubuntu@stand:~$
shop=# SELECT count(*) FROM orders
       WHERE customer_id = 2 AND status = 'new';
 count
-------
 13333
(1 row)

Запомни число 13333. Через два шага UPDATE должен назвать ровно его.

Шаг 4. Открыть черновик

BEGIN начинает транзакцию. В приглашении появится звёздочка.

ubuntu@stand:~$
shop=# BEGIN;
BEGIN
shop=*#

Шаг 5. Правка и сверка

Скопируй условие из шага 3 и допиши впереди UPDATE … SET.

ubuntu@stand:~$
shop=*# UPDATE orders SET status = 'cancelled'
        WHERE customer_id = 2 AND status = 'new';
UPDATE 13333

Число совпало. Посмотри, как теперь выглядят заказы Бориса:

ubuntu@stand:~$
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. Выполни тот же запрос с группировкой:

ubuntu@stand:~$
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. Откатить

Вернись в первый терминал. Представь, что заказчик позвонил и сказал: «Подождите, не отменяйте». Выбрасываем черновик:

ubuntu@stand:~$
shop=*# ROLLBACK;
ROLLBACK
shop=#

Звёздочка пропала, транзакции больше нет. Повтори запрос с группировкой — статус new вернулся, cancelled нет.

Шаг 8. Нарочно ошибиться

Теперь самое ценное упражнение раздела. Открой транзакцию и выполни удаление без условия — ту самую ошибку, которая в проде стоит работы.

ubuntu@stand:~$
shop=# BEGIN;
BEGIN
shop=*# DELETE FROM orders;
DELETE 200000

Двести тысяч заказов исчезли — для тебя. Проверь во втором терминале SELECT count(*) FROM orders;: там по-прежнему 200000. Теперь откат в первом:

ubuntu@stand:~$
shop=*# ROLLBACK;
ROLLBACK
shop=# SELECT count(*) FROM orders;
 count
--------
 200000
(1 row)

Запомни ощущение от строки DELETE 200000. Без BEGIN на этом месте начиналось бы восстановление из копии.

Шаг 9. Сделать правку по-настоящему

Заказчик перезвонил: «Всё-таки отменяйте». Повтори ритуал от начала до конца, на этот раз с фиксацией.

ubuntu@stand:~$
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. Проверить из второго терминала

Теперь второй терминал должен увидеть отменённые заказы:

ubuntu@stand:~$
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.

Практика 03+450 XP

Менять данные в рабочей базе так, чтобы любую ошибку можно было отменить: BEGIN, проверка числом, ROLLBACK или COMMIT.

  • Правка шла в транзакции
  • Откат испробован
  • Правка зафиксирована
  • Ни одного заказа не потеряно
  • Отменены ровно нужные заказы
Команда сдачи — выполни на своей машине
команда
cd ~/infra/db 2>/dev/null || echo NODB; H=/root/.psql_history; for w in BEGIN ROLLBACK COMMIT; do echo $w=$(docker compose exec -T db grep -ci $w $H); done; echo TOTAL=$(docker compose exec -T db psql -U shop -Atc 'SELECT count(*) FROM orders'); echo CANCELLED=$(docker compose exec -T db psql -U shop -Atc "SELECT count(*) FROM orders WHERE status = 'cancelled'")

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.