...
Eroare PostgreSQL · Constrângeri, chei și secvențe

ERROR: nextval: reached maximum value of sequence "bilete_id_seq" (32767)

Pe scurt

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ă

Greșit
SQL
CREATE TABLE bilete (id smallint GENERATED BY DEFAULT AS IDENTITY, ...);
Corect
SQL
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

Greșit
SQL
CREATE SEQUENCE numar_factura MAXVALUE 9999;
Corect
SQL
ALTER SEQUENCE numar_factura MAXVALUE 999999;

Limita explicită se poate ridica direct.

Repară tu

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.

Codul care dă eroarea
SQL
INSERT INTO bilete (eveniment) VALUES ('Teatru');
SELECT max(id) FROM bilete;
După reparație, programul afișează
ALTER TABLE
ALTER SEQUENCE
INSERT 0 1
  max
-------
 32768
(1 rând)
Indiciu

ALTER TABLE ... TYPE bigint și ALTER SEQUENCE ... AS bigint

Cum o eviți pe viitor

  • Folosește bigint pentru cheile generate ale tabelelor care pot crește mult.
  • Monitorizează secvențele: SELECT seqrelid::regclass, last_value, max_value FROM pg_sequences comparat cu limita.
  • Planifică migrarea la bigint cu mult înainte de limită, pentru că rescrierea tabelelor mari durează.
  • Nu folosi CYCLE pentru 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

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