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

argument of ntile must be a positive integer

Pe scurt

NTILE(n) împarte rândurile în n grupe, deci n trebuie să fie un număr întreg mai mare decât 0. Ai pus 0, un număr negativ sau o fracție (de exemplu 0.25 pentru sferturi). Pentru sferturi scrie NTILE(4).

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

Ce înseamnă

NTILE(n) OVER (ORDER BY ...) împarte rândurile ordonate în n grupe cât mai egale și dă fiecărui rând numărul grupei lui, de la 1 la n. Cu NTILE(4) primești quartile, cu NTILE(10) decile.

Argumentul e numărul de grupe, așa că SQLite acceptă doar un întreg pozitiv. Mesajul apare când argumentul e 0, negativ sau zecimal. Greșeala clasică e să gândești în procente: „vreau sferturi, deci 0.25” sau „vreau top 10%, deci 0.1”. Corect e numărul de grupe: 4, respectiv 10.

Apare și când argumentul vine dintr-o expresie care dă 0 sau o fracție, de exemplu NTILE(COUNT(*) / 100) pe un tabel mic.

De ce apare: cauzele frecvente

1Procent în loc de numărul de grupe

Greșit
SQL
SELECT nume,
  NTILE(0.25) OVER (ORDER BY total DESC) AS sfert
FROM clienti;
Corect
SQL
SELECT nume,
  NTILE(4) OVER (ORDER BY total DESC) AS sfert
FROM clienti;

Sferturile înseamnă 4 grupe. NTILE(4) dă fiecărui client un număr de la 1 la 4.

2Zero sau număr negativ

Greșit
SQL
SELECT nume,
  NTILE(0) OVER (ORDER BY total DESC) AS segment
FROM clienti;
Corect
SQL
SELECT nume,
  NTILE(3) OVER (ORDER BY total DESC) AS segment
FROM clienti;

Nu poți împărți rândurile în zero grupe. Cu 3, primești segmentele 1, 2 și 3.

Repară tu

Repară eroarea, direct în pagină

Vrem să împărțim clienții în sferturi după totalul cheltuit, cei mai buni în sfertul 1. Afișează nume și sfert, ordonat după total descrescător. Interogarea dă argument of ntile must be a positive integer. Repar-o.

Codul care dă eroarea
SQL
SELECT nume,
  NTILE(0.25) OVER (ORDER BY total DESC) AS sfert
FROM clienti
ORDER BY total DESC;
După reparație, programul afișează
nume | sfert
George Matei | 1
Dan Pop | 1
Ion Popa | 2
Mihai Tudor | 2
Elena Stan | 3
Ana Vasile | 3
Ioana Dinu | 4
Laura Enache | 4
Indiciu

Argumentul lui NTILE e numărul de grupe, nu mărimea unei grupe.

Alte forme ale mesajului

  • ERROR: argument of ntile must be greater than zero

Cum o eviți pe viitor

Scrie mereu numărul de grupe dorit, ca întreg: 2 (jumătăți), 3 (segmente), 4 (quartile), 10 (decile), 100 (percentile). Dacă vrei „top 10%”, folosește NTILE(10) și păstrează grupa 1, sau PERCENT_RANK() cu condiția <= 0.1. Când argumentul e calculat, asigură-te că nu poate ieși 0, de exemplu cu MAX(1, ...).

Întrebări frecvente

Ce se întâmplă dacă rândurile nu se împart exact?

Primele grupe primesc câte un rând în plus. Cu 10 rânduri și NTILE(3), grupele au 4, 3 și 3 rânduri.

Și dacă am mai puține rânduri decât grupe?

Nu e eroare: fiecare rând ajunge în propria grupă, iar grupele mari rămân goale.

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.