"current transaction is aborted, commands ignored until end of transaction block" nozīmē, ka kāds agrāks vaicājums tajā pašā transakcijā neizdevās, un PostgreSQL visu transakciju ir pārslēdzis pārtrauktā stāvoklī. Katrs nākamais vaicājums saņem šo kļūdu, līdz klients transakciju pabeidz. Pats ziņojums neko nepasaka par cēloni; noderīgā kļūda ir tā, kas bija pirms tās.
BEGIN;
INSERT INTO orders (id, customer_id) VALUES (1, 42);
INSERT INTO orders (id, customer_id) VALUES (1, 43);
-- ERROR: duplicate key value violates unique constraint "orders_pkey"
SELECT count(*) FROM orders;
-- ERROR: current transaction is aborted, commands ignored until end of transaction block
COMMIT;
-- ROLLBACK
SQLSTATE kods ir 25P02, nosacījuma nosaukums in_failed_sql_transaction (kļūdu kodi). Atšķirībā no dažām citām datubāzēm PostgreSQL neļauj izlaist neizdevušos vaicājumu un turpināt: tiklīdz kaut kas transakcijas blokā neizdodas, izeja ir tikai transakcijas beigas vai atgriešanās pie saglabāšanas punkta, kas izveidots pirms kļūdas.
1. solis: atrodiet pirmo kļūdu
Izstrādātāji parasti redz 25P02 ziņojumu, jo tieši ar to kods saskaras nākamo, bieži pilnīgi nesaistītā vaicājumā. Sākotnējā kļūda ir agrāk tajā pašā savienojumā:
- Servera žurnāls. Ar noklusējuma
log_min_error_statement = ERRORserveris žurnālā ieraksta katra vaicājuma tekstu, kas beidzas ar kļūdu (žurnālēšanas iestatījumi). Meklējiet pēdējo tā paša procesa ID kļūdu tieši pirms pirmās 25P02 rindas. Jalog_line_prefixvēl nav%p, pievienojiet to, un tas būs vienkārši. - Lietotnes žurnāli. Mūsu pieredzē sākotnējais izņēmums bieži tiek noķerts un ierakstīts debug līmenī vai apslāpēts ar vispārīgu
except/catch, pēc kura kods turpina lietot to pašu savienojumu. Šī apslāpēšana ir īstā kļūda.
Tipiskas pirmās kļūdas ir ierobežojumu pārkāpumi, tipu pārveidošanas kļūda, bloķējuma vai vaicājuma taimauts, strupceļš (deadlock) vai serializācijas kļūda. Salabojiet to, un 25P02 troksnis pazudīs kopā ar to.
2. solis: pareizi pabeidziet transakciju
Pārtrauktu transakciju var aizvērt tikai ar ROLLBACK. Var ierakstīt COMMIT, bet tas neko nesaglabās: pārtrauktā transakcijā PostgreSQL COMMIT apstrādā tieši tāpat kā ROLLBACK un pat atgriež komandas birku ROLLBACK (COMMIT). Dokumentācija norāda, ka tas atšķiras no SQL standarta, kas šādā gadījumā izraisītu kļūdu. Kods, kas izsauc COMMIT, nepārbaudot rezultātu, var tāpēc uzskatīt, ka dati ir saglabāti, lai gan tā nav; mūsu pieredzē tā sākas pieteikumi "dati vienkārši pazuda".
Lietotnes kodā noteikums ir vienkāršs: ja kāds vaicājums transakcijā izraisa kļūdu, atceliet transakciju (vai ļaujiet to izdarīt ietvara transakcijas blokam), pirms šo savienojumu lietojat vēlreiz. psycopg 3 dokumentācija to saka tieši: pēc kļūdas serveris atsaka turpmākās komandas, līdz tiek izsaukts rollback(), un kļūda, ko pa to laiku saņemat, ir InFailedSqlTransaction (psycopg transakcijas). Bloks with conn.transaction(): transakciju atceļ pats, ja to atstāj izņēmums.
3. solis: ja vienam vaicājumam drīkst neizdoties, lietojiet saglabāšanas punktu
Dažreiz viena soļa neveiksme ir pieņemama: neobligāts audita ieraksts vai solis "ievieto, un ja jau eksistē, dari ko citu". Ietiniet to saglabāšanas punktā (savepoint):
BEGIN;
INSERT INTO orders (id, customer_id) VALUES (1, 42);
SAVEPOINT before_optional_step;
INSERT INTO order_audit (order_id, note) VALUES (1, 'imported');
-- if this fails:
ROLLBACK TO SAVEPOINT before_optional_step;
-- the transaction is usable again; the first INSERT is still there
COMMIT;
ROLLBACK TO SAVEPOINT atceļ visu pēc saglabāšanas punkta, iznīcina vēlāk izveidotos saglabāšanas punktus un atstāj pašu punktu derīgu atkārtotai lietošanai (ROLLBACK TO SAVEPOINT). Saglabāšanas punkti pastāv tikai transakcijas blokā (SAVEPOINT). Dublētām atslēgām INSERT ... ON CONFLICT parasti ir labāks risinājums nekā kļūdas ķeršana vispār.
Tas pats mehānisms ir vairāku rīku pamatā, kurus jūs, iespējams, jau lietojat:
- psql ir mainīgais
ON_ERROR_ROLLBACK. Aronpsql pirms katras komandas transakcijas blokā izveido netiešuSAVEPOINTun atgriežas pie tā, ja komanda neizdodas;interactiveto dara tikai interaktīvās sesijās, ne lasot skriptu failus;offir noklusējums (psql). - pgJDBC ir savienojuma īpašība
autosave. Noklusējumsneverneveido saglabāšanas punktus;alwayspirms katra vaicājuma izveido saglabāšanas punktu un kļūdas gadījumā atgriežas pie tā;conservativeizveido punktu, bet atgriežas un atkārto tikai tādos gadījumos kā "cached statement cannot change return type" (pgJDBC savienojuma īpašības). Saistītā īpašībacleanupSavepoints(noklusējumsfalse) atbrīvo saglabāšanas punktu pirms nākamā vaicājuma. - psycopg 3 ligzdotu
conn.transaction()bloku realizē kā saglabāšanas punktu, tāpēc iekšējais bloks var neizdoties, nenogalinot ārējo transakciju. - PL/pgSQL bloki
BEGIN ... EXCEPTION ... ENDatceļ bloka izmaiņas datubāzē, kad kļūda tiek noķerta; dokumentācija brīdina, ka šādu bloku ieeja un izeja ir ievērojami dārgāka, tāpēc nelietojiet tos bez vajadzības (PL/pgSQL kļūdu ķeršana).
Neieslēdziet saglabāšanas punktu katram vaicājumam globāli tikai tāpēc, lai kļūda pazustu. Ja kods negaida, ka vaicājumi var neizdoties, kļūdas slēpšana nozīmē, ka transakcija tiek apstiprināta bez izmaiņas, kas neizdevās. Lietojiet saglabāšanas punktus soļiem, kuriem drīkst neizdoties, un visos citos gadījumos atceliet visu transakciju.
Skripti un migrācijas
Pēc noklusējuma psql pēc kļūdas turpina izpildi. Transakcijas blokā tas pēc pirmās īstās kļūdas rada veselu sienu ar 25P02 kļūdām; ārpus transakcijas tas rada daļēji izpildītu migrāciju. Skriptiem lietojiet:
-- ~/.psqlrc: keep typos from killing a manual transaction,
-- but only at the interactive prompt, never in scripts
\set ON_ERROR_ROLLBACK interactive
-- scripts: stop at the first error instead of ploughing on
psql -v ON_ERROR_STOP=1 --single-transaction -f migration.sql
Ar iestatītu ON_ERROR_STOP psql apstājas pie pirmās kļūdas un beidz darbu ar kodu 3; ar --single-transaction un ON_ERROR_STOP kļūdas gadījumā COMMIT vietā tiek nosūtīts ROLLBACK (psql). Jūsu izvietošanas rīks tad redz nenulles izejas kodu, un pirmā kļūda ir pēdējais, kas redzams izvadē.
Atrodiet sesijas, kas iestrēgušas pārtrauktā transakcijā
Kad kods noķer kļūdu un pēc tam vienkārši aizmirst savienojumu, sesija paliek atvērta pārtrauktā transakcijā. pg_stat_activity to rāda ar stāvokli idle in transaction (aborted) (pg_stat_activity):
SELECT pid, usename, application_name, client_addr,
now() - state_change AS stuck_for,
left(query, 80) AS last_query
FROM pg_stat_activity
WHERE state = 'idle in transaction (aborted)'
ORDER BY state_change;
Šāda sesija tur visus bloķējumus, ko tā paņēma pirms kļūdas, un, tāpat kā jebkura atvērta transakcija, var aizkavēt vacuum. Plašākā problēma un tās sakopšana ir aprakstīta rakstā PostgreSQL idle in transaction. Kā drošības tīklu iestatiet taimautus:
-- per role, so batch jobs can keep their own setting
ALTER ROLE app_user SET idle_in_transaction_session_timeout = '60s';
-- PostgreSQL 17+: hard cap on the whole transaction
ALTER ROLE app_user SET transaction_timeout = '10min';
idle_in_transaction_session_timeout pārtrauc sesiju, kas atvērtā transakcijā gaida klientu ilgāk par limitu; transaction_timeout, kas pievienots PostgreSQL 17, pārtrauc sesijas, kuru transakcija kopumā ilgst pārāk ilgi. Abu noklusējums ir 0, t. i., izslēgts, un dokumentācija neiesaka iestatīt transaction_timeout failā postgresql.conf, jo tas ietekmētu visas sesijas (klienta savienojuma noklusējumi).
Savienojumu pūli
Pūla savienojums, kas atgriezts pūlā pārtrauktas transakcijas vidū, saindē nākamo pieprasījumu, kas to aizņemas: tas krīt ar 25P02, lai gan neko nepareizi nav izdarījis. Lietotņu pūli parasti atgriešanas brīdī izpilda rollback, bet mūsu pieredzē šī kļūda dzīvo pašrakstītos apvalkos un savienojumos, kas "aizņemti ārpus ietvara". Aiz PgBouncer transakciju režīmā servera savienojums ir piešķirts klientam līdz tā transakcijas beigām, tāpēc klients, kas atstāj pārtrauktu transakciju atvērtu, arī atņem servera savienojumu visiem citiem. Pūla režīmi un izmēri ir aprakstīti rakstā PgBouncer savienojumu pūls PostgreSQL.
Kas mainās lielās, noslogotās datubāzēs
Testa datubāzē ar desmit rindām un vienu lietotāju saglabāšanas punkti šķiet bezmaksas, un pārtraukta transakcija šķiet nekaitīga. Produkcijā:
- Apakštransakciju izmaksas. Katrs saglabāšanas punkts ir apakštransakcija. Dokumentācija saka, ka katram servera procesam koplietojamā atmiņā tiek kešoti līdz 64 atvērtiem apakštransakciju ID; pēc tam krātuves I/O izmaksas ievērojami pieaug papildu meklēšanas dēļ
pg_subtrans(apakštransakcijas). ID saņem tikai apakštransakcijas, kas raksta, bet gara rakstīšanas transakcija arautosave=alwaysbezcleanupSavepointsvai PL/pgSQL cikls, kas katrai rindai ieietEXCEPTIONblokā, var šo robežu pārsniegt. Mūsu pieredzē simptoms parādās pie vienlaicīgas slodzes, nevis viena lietotāja testā. - Lielas paketes. Viena slikta rinda desmit miljonu rindu ielādē pārtrauc visu transakciju, un viss jau uzrakstītais tiek atcelts pēc tam, kad tas jau ierakstīts WAL. Ielādējiet daļās, kuru atkārtošanu varat atļauties, vai vispirms ielādējiet starpposma tabulā un pārbaudiet tur. Kopš PostgreSQL 17
COPY FROMarON_ERROR ignoreizlaiž rindas, kuru vērtības nevar pārveidot kolonnas tipā; tas attiecas tikai uz text un CSV formātiem un tikai uz pārveidošanas kļūdām, ne uz ierobežojumu pārkāpumiem (COPY). - Mirušās transakcijas bloķējumi. Rindas bloķējums vai migrācijas
ACCESS EXCLUSIVEbloķējums, kas paņemts pirms kļūdas, paliek spēkā līdz transakcijas beigām. Noslogotā tabulā sesija, kas atstāta pārtrauktā stāvoklī, var nostādīt rindā aiz sevis visus citus rakstītājus. Iepriekš minētie taimauti ir lēta apdrošināšana. - Atkārtojumi. Strupceļi un serializācijas kļūdas ir paredzētas atkārtošanai, bet atkārtojumam jāsāk jauna transakcija pēc
ROLLBACK. Neizdevušās komandas atkārtošana tajā pašā pārtrauktajā transakcijā rada tikai 25P02.
Galvenās atziņas
- 25P02 kļūda ir sekas; atrodiet pirmo kļūdu tajā pašā savienojumā servera vai lietotnes žurnālā.
- Aizveriet pārtrauktu transakciju ar
ROLLBACK;COMMITklusi darbojas kāROLLBACK. - Lietojiet saglabāšanas punktus tikai soļiem, kuriem drīkst neizdoties, un dublikātiem dodiet priekšroku
ON CONFLICT. - Palaidiet skriptus ar
ON_ERROR_STOP=1;ON_ERROR_ROLLBACKatstājiet interaktīvām sesijām. - Sekojiet
idle in transaction (aborted)sesijām un iestatiet dīkstāves un transakcijas taimautus katrai lomai. - Noslogotās sistēmās turiet maz saglabāšanas punktu vienā transakcijā un paketes tik mazas, lai tās varētu atkārtot.