ERROR: nextval: reached maximum value of sequence "bilete_id_seq" (32767)
Secvența unei coloane a ajuns la valoarea maximă: limita tipului (32767 pentru smallint, 2147483647 pentru integer) sau un MAXVALUE setat explicit. Nu se mai pot genera id-uri. Schimbă tipul coloanei și al secvenței în bigint (ALTER TABLE ... TYPE bigint, ALTER SEQUENCE ... AS bigint).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare secvență are o valoare maximă: implicit limita tipului declarat (smallint, integer, bigint), sau valoarea dată cu MAXVALUE. Când nextval ar depăși-o, iar secvența nu este CYCLE, apare această eroare, iar orice INSERT care are nevoie de un id nou eșuează. Mesajul arată numele secvenței și limita.
Este o problemă de producție clasică: un tabel cu serial (integer) ajunge la 2,1 miliarde de rânduri sau de id-uri consumate (inclusiv cele pierdute la ROLLBACK). Soluția este trecerea la bigint: ALTER TABLE ... ALTER COLUMN id TYPE bigint (rescrie tabelul și indecșii, deci are nevoie de o fereastră de mentenanță pe tabele mari) și ALTER SEQUENCE ... AS bigint (care ridică și MAXVALUE). Monitorizarea secvențelor apropiate de limită previne urgența.
De ce apare: cauzele frecvente
1Coloană smallint plină
CREATE TABLE bilete (id smallint GENERATED BY DEFAULT AS IDENTITY, ...);ALTER TABLE bilete ALTER COLUMN id TYPE bigint;
ALTER SEQUENCE bilete_id_seq AS bigint;Tipul mai mare ridică limita la aproximativ 9,2 × 10^18.
2MAXVALUE setat prea mic
CREATE SEQUENCE numar_factura MAXVALUE 9999;ALTER SEQUENCE numar_factura MAXVALUE 999999;Limita explicită se poate ridica direct.
Repară eroarea, direct în pagină
Tabelul bilete folosește id smallint generat, iar secvența a ajuns la 32767. Vânzarea unui bilet nou dă nextval: reached maximum value of sequence "bilete_id_seq" (32767). Schimbă coloana și secvența în bigint, inserează biletul și afișează cel mai mare id.
INSERT INTO bilete (eveniment) VALUES ('Teatru');
SELECT max(id) FROM bilete;ALTER TABLE ALTER SEQUENCE INSERT 0 1 max ------- 32768 (1 rând)
Indiciu
ALTER TABLE ... TYPE bigint și ALTER SEQUENCE ... AS bigint
Reparația
ALTER TABLE bilete ALTER COLUMN id TYPE bigint;
ALTER SEQUENCE bilete_id_seq AS bigint;
INSERT INTO bilete (eveniment) VALUES ('Teatru');
SELECT max(id) FROM bilete;De ce merge
Secvența era limitată de tipul smallint, cu maximul 32767. ALTER COLUMN id TYPE bigint mărește tipul coloanei, iar ALTER SEQUENCE bilete_id_seq AS bigint ridică limita secvenței. Biletul nou primește id-ul 32768. Pe un tabel mare, schimbarea tipului coloanei rescrie datele și trebuie planificată.
Cum o eviți pe viitor
- Folosește
bigintpentru cheile generate ale tabelelor care pot crește mult. - Monitorizează secvențele:
SELECT seqrelid::regclass, last_value, max_value FROM pg_sequencescomparat cu limita. - Planifică migrarea la
bigintcu mult înainte de limită, pentru că rescrierea tabelelor mari durează. - Nu folosi
CYCLEpentru chei primare: valorile reîncepute ar intra în conflict cu cele existente.
Întrebări frecvente
Pierd id-uri la ROLLBACK?
Da. Valorile luate cu nextval nu se returnează, deci secvența poate avansa mai repede decât numărul de rânduri.
Ajunge să schimb doar secvența?
Nu, dacă și coloana e integer: valorile peste limită ar da integer out of range. Schimbi ambele.
Erori înrudite
ERROR: integer out of range Un calcul sau o valoare depășește limitele tipului integer (aproximativ ±2,1 miliarde). Apare la sume mari (sum pe integer întoarce bigint, dar înmulțirea a două integer nu), la conversii (valoare::int) sau la coloane id care au ajuns la limită. Folosește bigint sau numeric pentru valori mari. ERROR: duplicate key value violates unique constraint "produse_pkey" Încerci să inserezi sau să actualizezi un rând cu o valoare care există deja într-o coloană cu cheie primară sau UNIQUE. Linia DETAIL arată cheia duplicată. Un caz frecvent: secvența unei coloane identity/serial a rămas în urmă după inserări cu id-uri explicite, iar următorul id generat există deja. ERROR: currval of sequence "comenzi_id_seq" is not yet defined in this session Ai apelat currval (sau lastval) înainte ca sesiunea curentă să fi apelat nextval pe acea secvență. currval întoarce doar valoarea generată în sesiunea ta. Pentru id-ul rândului tocmai inserat, folosește INSERT ... RETURNING id. Î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.
