Incidentu reaģēšana

PostgreSQL "current transaction is aborted, commands ignored until end of transaction block": ko tas nozīmē un kā to novērst

Šī kļūda nekad nav īstā problēma. Tā nozīmē, ka agrāks vaicājums tajā pašā transakcijā jau ir neizdevies, un PostgreSQL atteiks visu, līdz transakcija tiks atcelta. Risinājums ir atrast pirmo kļūdu un panākt, lai kods pareizi pabeidz neizdevušās transakcijas.

· 15 min lasīšanai · AG Data komanda

"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ā:

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:

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ā:

Galvenās atziņas

PostgreSQL Kļūdas Transakcijas Saglabāšanas punkti
Sadarbība ar mums

Kļūdas izplatās pa jūsu transakcijām?

Mēs atrodam sākotnējās kļūdas jūsu žurnālos, salabojam transakciju apstrādi lietotnē un pūlā un iestatām taimautus, lai bojātas sesijas vairs neaizturētu savienojumus un bloķējumus.

Sazināties Vairāk no emuāra