...
Eroare SQL · Sintaxă din MySQL, PostgreSQL și SQL Server

near "QUALIFY": syntax error

Pe scurt

QUALIFY (filtrul pe funcții fereastră din Snowflake, BigQuery, Databricks, DuckDB) nu există în SQLite. Calculează funcția fereastră într-o subinterogare sau într-un CTE și filtrează rezultatul cu WHERE în interogarea de deasupra.

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

Ce înseamnă

Funcțiile fereastră (ROW_NUMBER, RANK, LAG) se calculează după WHERE, GROUP BY și HAVING, așa că nu le poți folosi în niciuna dintre aceste clauze. Unele baze de date analitice au rezolvat asta cu o clauză în plus, QUALIFY, care filtrează după funcțiile fereastră: QUALIFY ROW_NUMBER() OVER (PARTITION BY client_id ORDER BY data DESC) = 1.

SQLite, PostgreSQL, MySQL și SQL Server nu au QUALIFY. În SQLite, parserul se oprește la acest cuvânt: near "QUALIFY": syntax error. Dacă interogarea nu are WHERE, QUALIFY poate fi citit ca alias al tabelului, iar mesajul arată cuvântul următor (de exemplu near "rn").

Soluția standard: calculezi funcția fereastră ca o coloană într-un CTE sau într-o subinterogare, apoi filtrezi cu WHERE rn = 1 în interogarea exterioară.

De ce apare: cauzele frecvente

1Ultima comandă a fiecărui client

Greșit
SQL
SELECT client_id, data, total
FROM comenzi
WHERE total > 0
QUALIFY ROW_NUMBER() OVER (
  PARTITION BY client_id ORDER BY data DESC) = 1;
Corect
SQL
WITH ordonate AS (
  SELECT client_id, data, total,
    ROW_NUMBER() OVER (PARTITION BY client_id
                       ORDER BY data DESC) AS rn
  FROM comenzi WHERE total > 0
)
SELECT client_id, data, total FROM ordonate WHERE rn = 1;

În CTE, rn devine o coloană obișnuită, pe care interogarea exterioară o poate filtra cu WHERE.

2Top 3 pe categorie

Greșit
SQL
SELECT categorie, nume, pret FROM produse
WHERE stoc > 0
QUALIFY RANK() OVER (PARTITION BY categorie
                     ORDER BY pret DESC) <= 3;
Corect
SQL
SELECT categorie, nume, pret FROM (
  SELECT categorie, nume, pret,
    RANK() OVER (PARTITION BY categorie
                 ORDER BY pret DESC) AS loc
  FROM produse WHERE stoc > 0
) WHERE loc <= 3;

Subinterogarea calculează locul, iar WHERE loc <= 3 păstrează primele trei produse din fiecare categorie.

Repară tu

Repară eroarea, direct în pagină

Vrem ultima comandă (după dată) a fiecărui client, doar dintre comenzile cu total peste 0. Interogarea a fost scrisă pentru Snowflake și dă near "QUALIFY": syntax error. Rescrie-o pentru SQLite și afișează client_id, data, total, ordonate după client_id.

Codul care dă eroarea
SQL
SELECT client_id, data, total
FROM comenzi
WHERE total > 0
QUALIFY ROW_NUMBER() OVER (PARTITION BY client_id ORDER BY data DESC) = 1
ORDER BY client_id;
După reparație, programul afișează
client_id | data | total
1 | 2026-10-15 | 90
2 | 2026-08-20 | 120
3 | 2026-10-02 | 300
Indiciu

Calculează numărul de ordine într-o interogare interioară și filtrează-l în cea exterioară.

Alte forme ale mesajului

  • near "rn": syntax error
  • ERROR: syntax error at or near "QUALIFY"

Cum o eviți pe viitor

Ține minte tiparul „top N pe grup” portabil: un CTE cu ROW_NUMBER() (sau RANK()) OVER (PARTITION BY grup ORDER BY criteriu) și un WHERE rn <= N deasupra. Merge pe SQLite, PostgreSQL, MySQL 8 și SQL Server. Când muți interogări din Snowflake sau BigQuery, caută QUALIFY și transformă-l așa.

Întrebări frecvente

Pot pune funcția fereastră direct în WHERE?

Nu. WHERE se aplică înaintea funcțiilor fereastră, deci primești misuse of window function. De aceea ai nevoie de subinterogare.

ROW_NUMBER sau RANK pentru top N?

ROW_NUMBER dă exact N rânduri pe grup. RANK păstrează egalitățile, deci poate da mai multe rânduri când prețurile sunt egale.

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.