...
Eroare System Design · Replicare, sharding și consistență

ProvisionedThroughputExceededException: The level of configured provisioned throughput for the table was exceeded.

Pe scurt

DynamoDB a limitat cererile pentru că au depășit capacitatea configurată, de multe ori nu a tabelei întregi, ci a unei singure partiții spre care merg prea multe cereri (hot partition). Alege o cheie de partiție cu multe valori distribuite uniform și împarte cheile fierbinți cu sufixe.

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

Ce înseamnă

În bazele NoSQL partiționate (DynamoDB, Cassandra, Cosmos DB), cheia de partiție decide pe ce nod ajunge fiecare element. Capacitatea totală e împărțită între partiții, iar o partiție are o limită proprie. Dacă multe cereri au aceeași cheie, ele lovesc aceeași partiție, iar baza respinge surplusul (ProvisionedThroughputExceededException, ThrottlingException), chiar dacă restul tabelei e liberă.

Cheile tipice care produc partiții fierbinți: data curentă (toate scrierile de azi), un status cu puține valori, un id de tenant mare, un produs viral, un contor global. Metricile arată limitări (throttled requests), deși consumul mediu e sub capacitate.

Soluțiile: o cheie cu cardinalitate mare și acces uniform (client_id, comanda_id), chei compuse, sufixe aleatoare pentru cheile inevitabil fierbinți (write sharding) și cache pentru citirile repetate ale aceluiași element. SDK-urile reîncearcă automat cu backoff, dar asta doar amână problema.

De ce apare: cauzele frecvente

1Cheie de partiție după zi

Greșit
PK = "2026-11-04"   SK = comanda_id
# toate comenzile de azi -> aceeași partiție
Corect
PK = client_id      SK = "COMANDA#2026-11-04#" + comanda_id
# comenzile se împart pe mulți clienți

Cu multe valori ale cheii, cererile se împart pe multe partiții.

2Contor global pe o singură cheie

Greșit
UpdateItem PK = "vizualizari"  ADD total 1
Corect
UpdateItem PK = "vizualizari#" + random(0..9)  ADD total 1
# citire: suma celor 10 elemente

Sufixul împarte scrierile pe 10 partiții; citirea, rară, adună rezultatele.

Repară tu

Repară eroarea, direct în pagină

Răspunde la cele trei întrebări despre ProvisionedThroughputExceededException pe o tabelă de comenzi.

Indiciu

Capacitatea e împărțită pe partiții; uită-te câte valori distincte are cheia.

Alte forme ale mesajului

  • ThrottlingException: Rate of requests exceeds the allowed throughput.
  • Throughput exceeds the current capacity for one or more global secondary indexes.
  • RequestLimitExceeded

Cum o eviți pe viitor

  • Alege cheia de partiție după tiparul de acces: multe valori, acces uniform.
  • Evită cheile după timp, status sau tenant mare ca primă componentă.
  • Pune cache în fața citirilor repetate ale acelorași elemente.
  • Urmărește metricile de throttling per partiție / cheie (de exemplu CloudWatch Contributor Insights).

Întrebări frecvente

Modul on-demand rezolvă problema?

Ajută la vârfuri de trafic total, dar o singură partiție are în continuare o limită. O cheie foarte fierbinte poate fi limitată și în on-demand.

E la fel la Cassandra?

Principiul e același: o partiție mare sau foarte accesată încarcă aceleași noduri. Cassandra nu dă aceeași excepție, dar vezi timeout-uri și latență mare pe acele noduri.

Erori înrudite

← Toate erorile System Design

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ță System Design de la zero, cu exerciții la fiecare lecție

Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.