...
Eroare PostgreSQL · Tranzacții, blocări și concurență

ERROR: CREATE INDEX CONCURRENTLY cannot run inside a transaction block

Pe scurt

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

Greșit
SQL
BEGIN;
CREATE INDEX CONCURRENTLY comenzi_data_idx ON comenzi (data);
COMMIT;
Corect
SQL
CREATE INDEX CONCURRENTLY comenzi_data_idx ON comenzi (data);

Comanda rulează singură, în autocommit.

2Fișier de migrare cu mai multe comenzi

Greșit
SQL
-- V12__index.sql: ALTER TABLE ...; CREATE INDEX CONCURRENTLY ...;
Corect
SQL
-- V12__alter.sql: ALTER TABLE ...;
-- V13__index.sql (fără tranzacție): CREATE INDEX CONCURRENTLY ...;

Indexul concurent primește migrarea lui.

Repară tu

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.

Codul care dă eroarea
SQL
BEGIN;
CREATE INDEX CONCURRENTLY comenzi_data_idx ON comenzi (data);
COMMIT;
SELECT indexname FROM pg_indexes WHERE tablename = 'comenzi' ORDER BY indexname;
După reparație, programul afișează
CREATE INDEX
    indexname
------------------
 comenzi_data_idx
 comenzi_pkey
(2 rânduri)
Indiciu

Scoate BEGIN și COMMIT.

Alte forme ale mesajului

  • ERROR: DROP INDEX CONCURRENTLY cannot run inside a transaction block
  • ERROR: 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 EXISTS ca migrarea să poată fi reluată.
  • Pe tabele mici, un CREATE INDEX obiș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

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.