frame starting offset must be a non-negative integer
În cadrul ferestrei (ROWS BETWEEN N PRECEDING ...), N trebuie să fie un întreg mai mare sau egal cu 0. Ai pus un număr negativ, un text sau o expresie greșită. Direcția se dă cu PRECEDING sau FOLLOWING, nu cu semnul minus.
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 pentru rândul curent: ROWS BETWEEN 2 PRECEDING AND CURRENT ROW înseamnă rândul curent și cele două dinaintea lui. Numărul din fața lui PRECEDING sau FOLLOWING e o distanță, deci trebuie să fie un întreg nenegativ.
frame starting offset must be a non-negative integer se referă la începutul cadrului (partea de după BETWEEN), iar varianta cu ending la sfârșit (partea de după AND). Apare când scrii -2 PRECEDING crezând că minusul înseamnă „înapoi”, când pui un text ('2' PRECEDING) sau când calculezi distanța dintr-o expresie care dă un număr negativ.
De ce apare: cauzele frecvente
1Minus pentru „înapoi”
SUM(suma) OVER (ORDER BY zi
ROWS BETWEEN -2 PRECEDING AND CURRENT ROW)SUM(suma) OVER (ORDER BY zi
ROWS BETWEEN 2 PRECEDING AND CURRENT ROW)PRECEDING înseamnă deja „înapoi”. Distanța e pozitivă.
2Rândurile următoare scrise cu minus
AVG(suma) OVER (ORDER BY zi
ROWS BETWEEN CURRENT ROW AND -1 FOLLOWING)AVG(suma) OVER (ORDER BY zi
ROWS BETWEEN CURRENT ROW AND 1 FOLLOWING)Pentru rândurile de după cel curent folosești FOLLOWING cu o distanță pozitivă.
3Distanță dată ca text
SUM(suma) OVER (ORDER BY zi ROWS '3' PRECEDING)SUM(suma) OVER (ORDER BY zi ROWS 3 PRECEDING)Distanța trebuie să fie un număr întreg, nu un șir de caractere.
Repară eroarea, direct în pagină
Vrei media mobilă a vânzărilor pe ultimele 3 zile (ziua curentă și cele două dinainte), coloana medie_3, lângă zi și suma, ordonat după zi. Interogarea pune minus în fața distanței și dă frame starting offset must be a non-negative integer. Repar-o.
SELECT zi, suma,
ROUND(AVG(suma) OVER (ORDER BY zi
ROWS BETWEEN -2 PRECEDING AND CURRENT ROW), 1) AS medie_3
FROM vanzari
ORDER BY zi;zi | suma | medie_3 2026-03-01 | 1200 | 1200 2026-03-02 | 800 | 1000 2026-03-03 | 1500 | 1166.7 2026-03-04 | 900 | 1066.7 2026-03-05 | 1100 | 1166.7
Indiciu
PRECEDING arată deja direcția; distanța e pozitivă.
Reparația
SELECT zi, suma,
ROUND(AVG(suma) OVER (ORDER BY zi
ROWS BETWEEN 2 PRECEDING AND CURRENT ROW), 1) AS medie_3
FROM vanzari
ORDER BY zi;De ce merge
-2 PRECEDING nu e o distanță validă: cadrul cere un întreg nenegativ, iar direcția „înapoi” e dată de PRECEDING. Cu 2 PRECEDING, fiecare zi face media dintre ea și cele două zile anterioare.
Primele două zile au mai puține rânduri înainte, deci media se face pe câte rânduri există: 1200, apoi 1000, apoi 1166,7 pentru primele trei zile.
Alte forme ale mesajului
frame ending offset must be a non-negative integerERROR: frame starting offset must not be negativeERROR: frame ending offset must not be negative
Cum o eviți pe viitor
Citește cadrul în cuvinte: „de la 2 rânduri înainte până la rândul curent” devine ROWS BETWEEN 2 PRECEDING AND CURRENT ROW. Distanțele sunt mereu pozitive, direcția o dă cuvântul PRECEDING sau FOLLOWING. Folosește constante întregi; dacă distanța vine din aplicație, verific-o înainte să construiești interogarea.
Întrebări frecvente
0 PRECEDING e valid?
Da, 0 PRECEDING e echivalent cu CURRENT ROW.
Care e diferența dintre ROWS și RANGE aici?
Cu ROWS, distanța se numără în rânduri. Cu RANGE, distanța e o diferență de valoare a coloanei din ORDER BY (de exemplu 2 zile), iar fereastra trebuie să aibă o singură expresie de ordonare.
Erori înrudite
unsupported frame specification 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. RANGE with offset PRECEDING/FOLLOWING requires one ORDER BY expression O fereastră RANGE BETWEEN n PRECEDING ... măsoară distanța pe valoarea coloanei din ORDER BY, deci are nevoie de exact o coloană acolo. Lasă o singură coloană în ORDER BY-ul ferestrei sau folosește ROWS BETWEEN n PRECEDING dacă vrei ultimele n rânduri. second argument to nth_value must be a positive integer Al doilea argument din nth_value(expr, N) trebuie să fie un întreg pozitiv: 1 pentru primul rând din fereastră, 2 pentru al doilea. Ai pus 0, un număr negativ sau o valoare care nu e întreagă. Numărătoarea începe de la 1. Î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.
