ProvisionedThroughputExceededException: The level of configured provisioned throughput for the table was exceeded.
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
PK = "2026-11-04" SK = comanda_id
# toate comenzile de azi -> aceeași partițiePK = client_id SK = "COMANDA#2026-11-04#" + comanda_id
# comenzile se împart pe mulți cliențiCu multe valori ale cheii, cererile se împart pe multe partiții.
2Contor global pe o singură cheie
UpdateItem PK = "vizualizari" ADD total 1UpdateItem PK = "vizualizari#" + random(0..9) ADD total 1
# citire: suma celor 10 elementeSufixul împarte scrierile pe 10 partiții; citirea, rară, adună rezultatele.
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.
Reparația
- q1: Toate scrierile au aceeași cheie de partiție și lovesc o singură partiție.
- q2:
client_id. - q3: Adevărat.
De ce merge
Throttling-ul apare pe partiția fierbinte, nu pe tabela întreagă. O cheie cu multe valori distribuie cererile, iar pentru cheile inevitabil fierbinți, sufixele aleatoare împart scrierile.
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
Hot key: o singură cheie Redis primește tot traficul și supraîncarcă un nod O cheie foarte populară (promoția zilei, contorul unui clip viral) stă pe un singur nod al cache-ului, deci tot traficul ei lovește acel nod, oricât de mare ar fi clusterul. Adaugă un cache local cu TTL scurt, copiază cheia pe mai multe chei cu sufix sau citește de pe replici. Un shard la 100%, celelalte aproape libere: cheie de sharding după dată Cheia de sharding după dată (sau după un id crescător, pe intervale) trimite toate scrierile noi pe același shard, care devine fierbinte, în timp ce shard-urile cu date vechi stau aproape libere. Alege o cheie cu multe valori, accesate uniform (de exemplu `client_id` cu hash). Baza primară saturată de scrieri, iar replicile nu ajută Scrierile ajung toate la o singură bază primară, iar replicile nu pot prelua scrieri (le primesc și ele, prin replicare). Când volumul de scrieri depășește o mașină, împarte datele pe shard-uri după o cheie bine aleasă (de exemplu `client_id`), fiecare shard cu primara lui. Î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.
