...
Eroare PostgreSQL · GROUP BY, subinterogări, UNION și ferestre

ERROR: window function rank requires an OVER clause

Pe scurt

Funcțiile rank, row_number, dense_rank, lag, lead, ntile și first_value sunt funcții fereastră și au nevoie de OVER (...), care spune peste ce rânduri și în ce ordine se calculează. Adaugă OVER (ORDER BY pret DESC) sau OVER (PARTITION BY categorie ORDER BY pret DESC).

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

Ce înseamnă

Unele funcții există doar ca funcții fereastră: row_number, rank, dense_rank, percent_rank, cume_dist, ntile, lag, lead, first_value, last_value, nth_value. Ele nu au sens fără o „fereastră”: un set de rânduri și o ordine. Clauza OVER (...) definește fereastra: PARTITION BY împarte rândurile în grupuri independente, ORDER BY stabilește ordinea în fiecare grup, iar opțional un cadru (ROWS BETWEEN ...) limitează rândurile luate în calcul.

Agregatele obișnuite (sum, count, avg) pot fi folosite și cu OVER, devenind funcții fereastră, dar și fără. Funcțiile de rang, nu. Mesajul numește funcția (rank, row_number) care a rămas fără fereastră. Dacă folosești aceeași fereastră de mai multe ori, o poți defini o dată cu clauza WINDOW w AS (...).

De ce apare: cauzele frecvente

1rank fără OVER

Greșit
SQL
SELECT nume, rank() AS loc FROM produse;
Corect
SQL
SELECT nume, rank() OVER (ORDER BY pret DESC) AS loc FROM produse;

OVER spune după ce criteriu se calculează rangul.

2lag fără fereastră

Greșit
SQL
SELECT data, total - lag(total) FROM comenzi;
Corect
SQL
SELECT data, total - lag(total) OVER (ORDER BY data) FROM comenzi;

lag trebuie să știe care este rândul anterior.

3Fereastră folosită de mai multe ori

Greșit
SQL
SELECT rank() OVER (ORDER BY pret DESC), dense_rank() OVER (ORDER BY pret DESC) FROM produse;
Corect
SQL
SELECT rank() OVER w, dense_rank() OVER w FROM produse WINDOW w AS (ORDER BY pret DESC);

WINDOW definește fereastra o singură dată.

Repară tu

Repară eroarea, direct în pagină

Clasamentul produselor după preț dă window function rank requires an OVER clause. Adaugă fereastra potrivită, ca produsul cel mai scump să aibă locul 1, și afișează numele, prețul și locul, ordonate după loc.

Codul care dă eroarea
SQL
SELECT nume, pret, rank() AS loc
FROM produse
ORDER BY loc;
După reparație, programul afișează
        nume        |  pret   | loc
--------------------+---------+-----
 Laptop Nova        | 3499.90 |   1
 Monitor 27         | 1299.00 |   2
 Tastatură Mecanică |  289.00 |   3
 Mouse Wireless     |   59.50 |   4
(4 rânduri)
Indiciu

rank() OVER (ORDER BY ...)

Alte forme ale mesajului

  • ERROR: window function row_number requires an OVER clause
  • ERROR: window function lag requires an OVER clause

Cum o eviți pe viitor

  • Scrie OVER (...) imediat după orice funcție de rang sau de deplasare.
  • Pune întotdeauna ORDER BY în fereastră pentru rank, row_number, lag și lead; fără el ordinea e arbitrară.
  • Folosește WINDOW pentru ferestre repetate, ca interogarea să rămână lizibilă.

Întrebări frecvente

Ce diferență e între rank și dense_rank?

La egalitate, rank sare peste locuri (1, 1, 3), dense_rank nu (1, 1, 2). row_number dă numere distincte mereu.

OVER () gol are sens?

Da, pentru agregate pe tot rezultatul (sum(total) OVER ()). Pentru rank fără ordine, toate rândurile ar avea rangul 1.

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.