...
Eroare SQL · Agregări, GROUP BY și funcții fereastră

second argument to nth_value must be a positive integer

Pe scurt

Al doilea argument din nth_value(expr, N) trebuie să fie un întreg pozitiv: 1 pentru primul rând din fereastră, 2 pentru al doilea. Ai pus 0, un număr negativ sau o valoare care nu e întreagă. Numărătoarea începe de la 1.

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

Ce înseamnă

nth_value(expr, N) OVER (...) întoarce valoarea lui expr de pe al N-lea rând din cadrul ferestrei. N numără de la 1, ca toate pozițiile în SQL: nth_value(salariu, 1) e același lucru cu first_value(salariu).

Mesajul apare când N e 0 (numărare de la zero, ca la listele din Python), negativ, NULL sau un text. Spre deosebire de lag și lead, unde poți da un decalaj, aici nu există „al minus unulea” rând.

Atenție și la cadru: cu ORDER BY în fereastră, cadrul implicit merge doar până la rândul curent, deci pe primul rând nth_value(salariu, 2) e NULL. Dacă vrei valoarea pe toate rândurile, extinde cadrul la UNBOUNDED FOLLOWING.

De ce apare: cauzele frecvente

1Numărare de la zero

Greșit
SQL
SELECT nume,
  nth_value(nume, 0) OVER (ORDER BY salariu DESC)
FROM angajati;
Corect
SQL
SELECT nume,
  nth_value(nume, 1) OVER (ORDER BY salariu DESC)
FROM angajati;

Primul rând din fereastră e poziția 1.

2Index negativ pentru „ultimul”

Greșit
SQL
SELECT nume,
  nth_value(nume, -1) OVER (ORDER BY salariu)
FROM angajati;
Corect
SQL
SELECT nume,
  last_value(nume) OVER (ORDER BY salariu
    ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING)
FROM angajati;

Pentru ultimul rând există last_value, cu cadrul extins până la final.

Repară tu

Repară eroarea, direct în pagină

Vrei să afișezi lângă fiecare angajat (nume, salariu) al doilea cel mai mare salariu din firmă (al_doilea), ordonat după salariu descrescător. Interogarea numără de la zero și dă second argument to nth_value must be a positive integer. Repar-o ca valoarea să apară pe toate rândurile.

Codul care dă eroarea
SQL
SELECT nume, salariu,
  nth_value(salariu, 1 - 1) OVER (ORDER BY salariu DESC
    ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING) AS al_doilea
FROM angajati
ORDER BY salariu DESC;
După reparație, programul afișează
nume | salariu | al_doilea
Mara Ilie | 9000 | 8000
Ilinca Radu | 8000 | 8000
Dan Pop | 7000 | 8000
Elena Stan | 6500 | 8000
Sorin Neagu | 6000 | 8000
Indiciu

Al doilea rând e poziția 2, iar cadrul trebuie să cuprindă toată fereastra.

Alte forme ale mesajului

  • ERROR: argument of nth_value must be greater than zero

Cum o eviți pe viitor

În SQL, pozițiile încep de la 1 (nth_value, ntile, substr, ORDER BY 1). Pentru primul și ultimul rând folosește first_value și last_value. Când folosești nth_value sau last_value cu ORDER BY, scrie explicit cadrul ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING ca să vezi același rezultat pe toate rândurile.

Întrebări frecvente

De ce primesc NULL pe primele rânduri?

Cadrul implicit cu ORDER BY se termină la rândul curent. Pe primul rând, fereastra are un singur rând, deci al doilea nu există încă. Extinde cadrul până la UNBOUNDED FOLLOWING.

Pot folosi o coloană ca N?

În SQLite, N trebuie să fie un întreg pozitiv pentru fiecare rând; o expresie care dă 0 sau NULL va produce eroarea. Cel mai sigur e o constantă.

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.