...
Eroare SQL · Coloane generate, indecși și RETURNING

unsupported use of NULLS FIRST

Pe scurt

Ai scris NULLS FIRST sau NULLS LAST într-un CREATE INDEX (sau într-o cheie PRIMARY KEY / UNIQUE). SQLite acceptă NULLS FIRST / LAST doar în ORDER BY-ul interogărilor. Scoate-l din index și pune-l în SELECT.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Din SQLite 3.30, ORDER BY coloana NULLS FIRST sau NULLS LAST controlează unde apar valorile NULL la sortare. Implicit, SQLite consideră NULL mai mic decât orice valoare, deci la ASC sunt primele, iar la DESC ultimele.

În PostgreSQL poți crea și indecși cu această ordine (CREATE INDEX ... (data DESC NULLS LAST)). SQLite nu permite asta: în definiția unui index, a unei chei primare sau a unei constrângeri UNIQUE acceptă doar ASC și DESC. De aceea primești unsupported use of NULLS FIRST (sau NULLS LAST).

Indexul fără NULLS poate fi folosit în continuare de interogarea care cere ordinea. Uneori SQLite mai face o sortare scurtă la final, dar rezultatul e corect.

De ce apare: cauzele frecvente

1Index copiat din PostgreSQL

Greșit
SQL
CREATE INDEX ix_livrare
ON comenzi (data_livrare DESC NULLS LAST);
Corect
SQL
CREATE INDEX ix_livrare
ON comenzi (data_livrare DESC);

În index rămâne doar direcția. Unde apar NULL-urile se cere în interogare.

2Ordinea NULL-urilor cerută în SELECT

Greșit
SQL
CREATE INDEX ix_email ON clienti (email NULLS FIRST);
SELECT nume FROM clienti ORDER BY email;
Corect
SQL
CREATE INDEX ix_email ON clienti (email);
SELECT nume FROM clienti ORDER BY email NULLS FIRST;

NULLS FIRST e permis în ORDER BY, unde chiar decide ordinea rezultatului.

Repară tu

Repară eroarea, direct în pagină

Vrei un index pe data livrării și lista comenzilor ordonate de la cea mai recentă livrare, cu comenzile nelivrate (fără dată) la final. Indexul a fost copiat din PostgreSQL cu NULLS LAST și dă unsupported use of NULLS LAST. Repară scriptul și afișează id și data_livrare.

Codul care dă eroarea
SQL
CREATE INDEX ix_livrare ON comenzi (data_livrare DESC NULLS LAST);
SELECT id, data_livrare FROM comenzi
ORDER BY data_livrare DESC;
După reparație, programul afișează
id | data_livrare
12 | 2026-03-05
10 | 2026-03-02
11 | NULL
Indiciu

NULLS LAST se mută din index în ORDER BY.

Alte forme ale mesajului

  • unsupported use of NULLS LAST
  • sqlite3.OperationalError: unsupported use of NULLS LAST

Cum o eviți pe viitor

În SQLite, scrie indecșii doar cu ASC / DESC și pune NULLS FIRST / NULLS LAST în interogări. Când muți scripturi din PostgreSQL, caută NULLS în toate CREATE INDEX-urile. Dacă rulezi pe un SQLite mai vechi de 3.30, nici în ORDER BY nu există NULLS; acolo folosești ORDER BY coloana IS NULL, coloana.

Întrebări frecvente

Unde apar NULL-urile implicit în SQLite?

La ORDER BY ... ASC primele, la DESC ultimele, pentru că SQLite consideră NULL mai mic decât orice valoare. PostgreSQL face invers.

Cum pun NULL-urile la final fără NULLS LAST?

Cu ORDER BY data IS NULL, data: expresia data IS NULL e 0 pentru valori și 1 pentru NULL, deci NULL-urile ajung la sfârșit.

Erori înrudite

← Toate erorile SQL

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ță SQL de la zero, cu exerciții la fiecare lecție

Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.