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

unsupported frame specification

Pe scurt

Cadrul ferestrei (ROWS/RANGE BETWEEN ... AND ...) are capetele în ordinea greșită: începutul vine după sfârșit, de exemplu BETWEEN CURRENT ROW AND 2 PRECEDING. Scrie întâi capătul din trecut, apoi pe cel din viitor: BETWEEN 2 PRECEDING AND CURRENT ROW.

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

Ce înseamnă

Cadrul unei funcții fereastră spune ce rânduri intră în calcul, relativ la rândul curent: ROWS BETWEEN <început> AND <sfârșit>. Capetele posibile, de la cel mai vechi la cel mai nou, sunt: UNBOUNDED PRECEDING, n PRECEDING, CURRENT ROW, n FOLLOWING, UNBOUNDED FOLLOWING.

Începutul trebuie să fie înaintea sfârșitului în această listă. Când scrii BETWEEN CURRENT ROW AND 2 PRECEDING, cadrul ar porni de la rândul curent și s-ar termina cu două rânduri în urmă, ceea ce n-are sens, iar SQLite dă unsupported frame specification. La fel pentru BETWEEN UNBOUNDED FOLLOWING AND ... sau BETWEEN ... AND UNBOUNDED PRECEDING.

De obicei e o inversare: ai vrut „ultimele 3 rânduri” și ai scris capetele invers.

De ce apare: cauzele frecvente

1Capetele cadrului inversate

Greșit
SQL
SELECT luna, AVG(suma) OVER (
  ORDER BY luna
  ROWS BETWEEN CURRENT ROW AND 2 PRECEDING
) FROM vanzari;
Corect
SQL
SELECT luna, AVG(suma) OVER (
  ORDER BY luna
  ROWS BETWEEN 2 PRECEDING AND CURRENT ROW
) FROM vanzari;

Cadrul pornește cu două rânduri în urmă și se termină la rândul curent, exact media pe 3 luni.

2UNBOUNDED pus la capătul greșit

Greșit
SQL
SELECT luna, SUM(suma) OVER (
  ORDER BY luna
  ROWS BETWEEN CURRENT ROW AND UNBOUNDED PRECEDING
) FROM vanzari;
Corect
SQL
SELECT luna, SUM(suma) OVER (
  ORDER BY luna
  ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
) FROM vanzari;

Totalul cumulat începe de la primul rând (UNBOUNDED PRECEDING) și se oprește la cel curent.

Repară tu

Repară eroarea, direct în pagină

Vrem pentru fiecare lună media vânzărilor din luna curentă și cele două dinainte (media_3_luni), ordonată după lună. Interogarea dă unsupported frame specification. Repar-o.

Codul care dă eroarea
SQL
SELECT luna, ROUND(AVG(suma) OVER (
  ORDER BY luna
  ROWS BETWEEN CURRENT ROW AND 2 PRECEDING
 ), 2) AS media_3_luni
FROM vanzari
ORDER BY luna;
După reparație, programul afișează
luna | media_3_luni
1 | 100
2 | 150
3 | 150
4 | 200
5 | 233.33
Indiciu

Cadrul se scrie de la capătul mai vechi la cel mai nou.

Alte forme ale mesajului

  • ERROR: frame starting from current row cannot have preceding rows
  • ERROR: frame start cannot be UNBOUNDED FOLLOWING
  • ERROR: frame end cannot be UNBOUNDED PRECEDING

Cum o eviți pe viitor

Citește cadrul ca pe o propoziție: „de la două rânduri în urmă până la rândul curent”. Începutul e mereu în trecut sau la rândul curent, sfârșitul la rândul curent sau în viitor. Tiparele de ținut minte: ROWS BETWEEN 2 PRECEDING AND CURRENT ROW (medie mobilă pe 3), ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW (total cumulat), ROWS BETWEEN 1 PRECEDING AND 1 FOLLOWING (vecinii).

Întrebări frecvente

Dacă nu scriu deloc cadrul, ce se folosește?

Cu ORDER BY în fereastră, implicit e RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW, adică totalul cumulat. Fără ORDER BY, toată partiția.

Pot scrie doar ROWS 2 PRECEDING?

Da, e prescurtarea pentru ROWS BETWEEN 2 PRECEDING AND CURRENT ROW.

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.