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

frame starting offset must be a non-negative integer

Pe scurt

Î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”

Greșit
SQL
SUM(suma) OVER (ORDER BY zi
  ROWS BETWEEN -2 PRECEDING AND CURRENT ROW)
Corect
SQL
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

Greșit
SQL
AVG(suma) OVER (ORDER BY zi
  ROWS BETWEEN CURRENT ROW AND -1 FOLLOWING)
Corect
SQL
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

Greșit
SQL
SUM(suma) OVER (ORDER BY zi ROWS '3' PRECEDING)
Corect
SQL
SUM(suma) OVER (ORDER BY zi ROWS 3 PRECEDING)

Distanța trebuie să fie un număr întreg, nu un șir de caractere.

Repară tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
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ă.

Alte forme ale mesajului

  • frame ending offset must be a non-negative integer
  • ERROR: frame starting offset must not be negative
  • ERROR: 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

← 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.