Transakcja grupuje polecenia tak, że albo wszystkie zadziałają, albo żadne. Rozpoczynasz ją przez BEGIN, utrwalasz przez COMMIT albo cofasz wszystko od BEGIN przez ROLLBACK. Dopóki nie zatwierdzisz, inne sesje nie widzą twoich zmian.
Alice kończy z 70, a Bob z 80. Gdyby serwer padł między dwiema aktualizacjami, żadna by nie przetrwała: pieniądze nie mogą opuścić jednego konta, nie trafiając na drugie.
Cofanie zmian przez ROLLBACK
ROLLBACK odrzuca każdą zmianę od BEGIN:
DELETE usunął w transakcji wszystkie trzy wiersze, a wycofanie je przywróciło: liczba wynosi 3. W psql tak samo zabezpieczaj ryzykowne ręczne UPDATE albo DELETE. Uruchom je po BEGIN, sprawdź wynik przez SELECT, a potem wybierz COMMIT albo ROLLBACK.
Bez BEGIN PostgreSQL uruchamia każde polecenie we własnej transakcji i zatwierdza je po zakończeniu (autocommit). Sterowniki się różnią: psycopg w Pythonie zaczyna transakcję przy pierwszym poleceniu i czeka na conn.commit().
Wycofanie części transakcji przez SAVEPOINT
Punkt zapisu oznacza miejsce w transakcji. ROLLBACK TO SAVEPOINT name cofa tylko pracę wykonaną po nim, a transakcja trwa dalej:
Log zawiera "import users" i "import products". Krok z zamówieniami został cofnięty bez utraty pierwszego wstawienia. RELEASE SAVEPOINT name zapomina punkt zapisu, którego już nie potrzebujesz.
Naprawa "current transaction is aborted"
Gdy polecenie w transakcji się nie uda, PostgreSQL oznacza całą transakcję jako nieudaną i odrzuca każde kolejne polecenie, dopóki jej nie zakończysz:
BEGIN;
INSERT INTO accounts VALUES ('alice', 10); -- duplicate key: error
UPDATE accounts SET balance = 0;
-- ERROR: current transaction is aborted, commands ignored until end of transaction block
ROLLBACK;
Rozwiązaniem jest ROLLBACK. COMMIT na przerwanej transakcji niczego nie zapisuje; PostgreSQL odpowiada ROLLBACK. Żeby kontynuować po spodziewanym błędzie, ustaw punkt zapisu przed ryzykownym poleceniem i wróć do niego. Sterowniki i ORM-y oferujące „zagnieżdżone transakcje” działają właśnie tak.
Wycofywanie także zmian tabel
CREATE TABLE, ALTER TABLE, DROP TABLE i większość innego DDL są transakcyjne, więc migracja, która nie uda się w połowie, nic po sobie nie zostawia:
to_regclass zwraca NULL: tabela nigdy nie istniała dla nikogo innego. Kilka poleceń odmawia działania w bloku transakcji, między innymi VACUUM, CREATE DATABASE i CREATE INDEX CONCURRENTLY.
Wybór poziomu izolacji
Poziom izolacji decyduje, które zatwierdzenia innych sesji widzi transakcja. Ustawiasz go przez BEGIN ISOLATION LEVEL ....
| Poziom | Co widzi każde polecenie | Kiedy go używać |
|---|---|---|
READ COMMITTED (domyślny) | Dane zatwierdzone przed rozpoczęciem polecenia | Większość aplikacji |
REPEATABLE READ | Jeden snapshot zrobiony przy pierwszym zapytaniu transakcji | Raporty i eksporty, które muszą być spójne |
SERIALIZABLE | Jak REPEATABLE READ, a PostgreSQL anuluje transakcje, których wynik mógłby się różnić od wykonania ich po kolei | Reguły biznesowe, które najpierw czytają, a potem zapisują |
READ UNCOMMITTED jest przyjmowany, ale działa jak READ COMMITTED: PostgreSQL nigdy nie pokazuje niezatwierdzonych danych. Przy REPEATABLE READ i SERIALIZABLE spodziewaj się błędów z SQLSTATE 40001 ("could not serialize access") i po takim błędzie powtórz całą transakcję.
Blokowanie wiersza, który zaraz zmienisz
Żeby inna sesja nie zmieniła wiersza między twoim odczytem a zapisem, zablokuj go przy odczycie przez FOR UPDATE. Inni piszący czekają, aż zatwierdzisz:
BEGIN;
SELECT balance FROM accounts WHERE name = 'alice' FOR UPDATE;
UPDATE accounts SET balance = balance - 30 WHERE name = 'alice';
COMMIT;
Krótkie transakcje
Otwarta transakcja trzyma blokady wierszy do końca i nie pozwala VACUUM usuwać starych wersji wierszy. Sesja pozostawiona przez skrypt, który padł, w stanie "idle in transaction" może blokować innych piszących godzinami. Ustaw idle_in_transaction_session_timeout, żeby takie sesje kończyły się automatycznie.
W transakcji now() zwraca ten sam czas dla każdego polecenia: moment rozpoczęcia transakcji (zobacz funkcje dat). Oficjalny tutorial o transakcjach ma więcej przykładów.
Najczęściej zadawane pytania
Czy PostgreSQL używa autocommit?
Tak. Polecenie wysłane poza BEGIN działa we własnej transakcji i jest zatwierdzane po zakończeniu. Niektóre sterowniki to odwracają: psycopg w Pythonie otwiera transakcję za ciebie i czeka na commit(), chyba że włączysz autocommit.
Jaki jest domyślny poziom izolacji w PostgreSQL?
READ COMMITTED. Każde polecenie widzi dane zatwierdzone przed jego rozpoczęciem. Użyj BEGIN ISOLATION LEVEL REPEATABLE READ albo SERIALIZABLE, gdy transakcja musi widzieć jeden spójny snapshot.
Czy można wycofać CREATE TABLE albo ALTER TABLE w PostgreSQL?
Tak. Prawie cały DDL w PostgreSQL jest transakcyjny, więc CREATE, ALTER albo DROP w transakcji znika po ROLLBACK. Kilka poleceń, takich jak CREATE DATABASE, VACUUM i CREATE INDEX CONCURRENTLY, w ogóle nie może działać w bloku transakcji.
Czym różni się COMMIT od END w PostgreSQL?
Niczym. END to rozszerzenie PostgreSQL, które robi to samo co COMMIT, a START TRANSACTION to standardowy zapis BEGIN.