ERROR: CREATE INDEX CONCURRENTLY cannot run inside a transaction block
CREATE INDEX CONCURRENTLY folosește mai multe tranzacții interne, deci nu poate rula într-un bloc BEGIN ... COMMIT. Multe instrumente de migrări pun fiecare fișier într-o tranzacție. Rulează comanda separat, în afara tranzacției (în Flyway sau Liquibase, dezactivează tranzacția pentru acea migrare).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
CREATE INDEX CONCURRENTLY construiește indexul fără să blocheze scrierile în tabel, în mai mulți pași, fiecare în propria tranzacție, așteptând între ei să se termine tranzacțiile care ar putea vedea date vechi. De aceea nu poate rula într-o tranzacție deschisă de client. Aceeași restricție o au DROP INDEX CONCURRENTLY, REINDEX CONCURRENTLY, VACUUM, CREATE DATABASE și ALTER TYPE ... ADD VALUE în versiunile vechi.
În practică, eroarea apare în migrări: Flyway, Liquibase, Alembic sau Rails rulează implicit fiecare migrare într-o tranzacție. Soluția este o migrare separată, marcată să ruleze fără tranzacție (executeInTransaction=false în Flyway, runInTransaction="false" în Liquibase). Dacă construcția concurentă eșuează, rămâne un index INVALID, care trebuie șters (DROP INDEX CONCURRENTLY) și recreat.
De ce apare: cauzele frecvente
1Migrare într-o tranzacție
BEGIN;
CREATE INDEX CONCURRENTLY comenzi_data_idx ON comenzi (data);
COMMIT;CREATE INDEX CONCURRENTLY comenzi_data_idx ON comenzi (data);Comanda rulează singură, în autocommit.
2Fișier de migrare cu mai multe comenzi
-- V12__index.sql: ALTER TABLE ...; CREATE INDEX CONCURRENTLY ...;-- V12__alter.sql: ALTER TABLE ...;
-- V13__index.sql (fără tranzacție): CREATE INDEX CONCURRENTLY ...;Indexul concurent primește migrarea lui.
Repară eroarea, direct în pagină
Migrarea care creează un index pe data comenzilor fără să blocheze scrierile este pusă într-un bloc BEGIN ... COMMIT și dă CREATE INDEX CONCURRENTLY cannot run inside a transaction block. Rulează crearea în afara tranzacției și afișează numele indecșilor tabelului comenzi.
BEGIN;
CREATE INDEX CONCURRENTLY comenzi_data_idx ON comenzi (data);
COMMIT;
SELECT indexname FROM pg_indexes WHERE tablename = 'comenzi' ORDER BY indexname;CREATE INDEX
indexname
------------------
comenzi_data_idx
comenzi_pkey
(2 rânduri)Indiciu
Scoate BEGIN și COMMIT.
Reparația
CREATE INDEX CONCURRENTLY comenzi_data_idx ON comenzi (data);
SELECT indexname FROM pg_indexes WHERE tablename = 'comenzi' ORDER BY indexname;De ce merge
Construcția concurentă are nevoie de mai multe tranzacții proprii, deci nu poate fi închisă într-un bloc deschis de client. Rulată singură, comanda creează indexul comenzi_data_idx, care apare în pg_indexes lângă indexul cheii primare. Pe un tabel mare, scrierile ar continua normal în timpul construcției.
Alte forme ale mesajului
ERROR: DROP INDEX CONCURRENTLY cannot run inside a transaction blockERROR: REINDEX CONCURRENTLY cannot run inside a transaction block
Cum o eviți pe viitor
- Pune fiecare
CREATE INDEX CONCURRENTLYîntr-o migrare separată, fără tranzacție. - Verifică după creare că indexul e valid:
SELECT indexrelid::regclass FROM pg_index WHERE NOT indisvalid. - Folosește
IF NOT EXISTSca migrarea să poată fi reluată. - Pe tabele mici, un
CREATE INDEXobișnuit, în tranzacție, e mai simplu și suficient.
Întrebări frecvente
De ce durează mai mult varianta concurentă?
Scanează tabelul de două ori și așteaptă tranzacțiile active între pași, dar nu blochează scrierile.
Ce fac cu un index INVALID?
Îl ștergi cu DROP INDEX CONCURRENTLY și rulezi din nou crearea. Un index invalid ocupă spațiu și e actualizat la scrieri, dar nu e folosit la citiri.
Erori înrudite
ERROR: VACUUM cannot run inside a transaction block VACUUM (și CREATE DATABASE, DROP DATABASE, ALTER SYSTEM) nu poate rula într-o tranzacție deschisă cu BEGIN și nici într-o funcție. Rulează comanda separat, în modul autocommit, sau dintr-un job de mentenanță extern. ERROR: relation "clienti" already exists Încerci să creezi un tabel, view, index sau secvență cu un nume care există deja în schema respectivă. Fie scriptul rulează a doua oară, fie numele e ocupat de alt obiect (un index și un tabel nu pot avea același nume). Folosește CREATE ... IF NOT EXISTS sau alege alt nume. ERROR: invalid transaction termination Ai folosit COMMIT sau ROLLBACK într-un loc unde nu e permis: într-o funcție (doar procedurile pot controla tranzacții) sau într-o procedură apelată dintr-o tranzacție deschisă explicit, cu BEGIN. Transformă funcția în procedură și apeleaz-o cu CALL, în afara unui bloc BEGIN. Învață PostgreSQL de la zero, cu exerciții la fiecare lecție
Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
