near "QUALIFY": syntax error
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
SELECT client_id, data, total
FROM comenzi
WHERE total > 0
QUALIFY ROW_NUMBER() OVER (
PARTITION BY client_id ORDER BY data DESC) = 1;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
SELECT categorie, nume, pret FROM produse
WHERE stoc > 0
QUALIFY RANK() OVER (PARTITION BY categorie
ORDER BY pret DESC) <= 3;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ă 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.
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;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ă.
Reparația
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
ORDER BY client_id;De ce merge
SQLite nu are QUALIFY. În CTE, ROW_NUMBER() numerotează comenzile fiecărui client de la cea mai nouă, iar rn devine o coloană obișnuită, pe care WHERE rn = 1 o poate filtra.
Comanda 4 a clientului 2 are totalul 0 și e eliminată înainte de numerotare, așa că ultima lui comandă validă rămâne cea din 20 august.
Alte forme ale mesajului
near "rn": syntax errorERROR: 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
misuse of window function ROW_NUMBER() O funcție fereastră (ROW_NUMBER, RANK, LAG) e folosită în WHERE, GROUP BY sau fără OVER. Funcțiile fereastră se calculează după WHERE, deci nu poți filtra direct cu ele. Calculează-le într-o subinterogare sau CTE și filtrează rezultatul în interogarea exterioară. misuse of aliased window function rn Ai folosit în WHERE (sau GROUP BY) aliasul unei funcții fereastră din SELECT, de exemplu WHERE rn = 1, unde rn este ROW_NUMBER() OVER (...). Aliasul nu există încă în WHERE. Pune interogarea într-un CTE sau într-o subinterogare și filtrează după rn în exterior. near "WITH": syntax error GROUP BY ... WITH ROLLUP (MySQL) și GROUP BY ROLLUP(...) (PostgreSQL, SQL Server) nu există în SQLite. Rândul de total se adaugă cu UNION ALL: un SELECT cu totalurile pe grupe și încă unul cu totalul general. Î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.
