Wie groß darf ein Item in DynamoDB maximal sein?

400 KB. Die maximale Item-Größe in DynamoDB beträgt 400 KB. Diese Summe zählt sowohl Attributnamen (UTF-8-Byte-Länge) als auch alle Attributwerte (binäre Länge), inklusive verschachtelter Listen und Maps. Binärwerte werden nach ihrer rohen Byte-Länge gemessen. Es gibt keine Möglichkeit, diese Grenze anzuheben — größere Objekte gehören nach Amazon S3.

Was auf die 400 KB angerechnet wird

Die Item-Größe ist die Summe aus:

jedem Attributnamen, gemessen in UTF-8-Bytes, und
jedem Attributwert, gemessen in binärer Länge (Strings als UTF-8, Zahlen kompakt, Binärdaten als rohe Bytes).

Verschachtelte Map- und Listenstruktur fügt außerdem einen kleinen Overhead pro Element hinzu. Lange Attributnamen kosten echten Platz — kürze sie, um Raum zu sparen.

400 KB sind 409.600 Bytes, und der Name gehört dazu

AWS misst in Binäreinheiten: "DynamoDB denotes 1 KB = 1024 bytes." Die Obergrenze liegt also bei 409.600 Bytes, nicht bei 400.000. Die exakte Kante findest du, indem du PutItem mit einem String-Attribut binär durchsuchst:

await client.send(
  new PutItemCommand({
    TableName: 'sizes',
    Item: {pk: {S: 'A'}, a: {S: 'x'.repeat(n)}}
  })
);

Das größte n, das durchgeht, ist 409.596. Addiere den Key-Namen (pk, 2 Bytes), den Key-Wert (A, 1 Byte) und den Attributnamen (a, 1 Byte), und du landest exakt bei 409.600. Ein Byte mehr liefert dir:

ValidationException: Item size has exceeded the maximum allowed size
HTTP 400

Benenne dieses Attribut jetzt von a in attributeName um und ändere sonst nichts. Der größte passende Wert fällt auf 409.584 — genau 12 Bytes weniger, und 12 Bytes ist die zusätzliche Länge des Namens.

AWS' eigene Empfehlung folgt aus dieser Rechnung. "We recommend that you choose shorter attribute names rather than long ones."

Genau deshalb ist ein 400-KB-Budget bei einem Item mit vielen Attributen enger, als es aussieht. Jeder Name wird bei jedem Write und bei jedem Read bezahlt, für die gesamte Lebensdauer des Items.

Warum das zählt

Die Item-Größe treibt die Kapazitätskosten: Jeder Read wird in 4-KB-Schritten und jeder Write in 1-KB-Schritten abgerechnet (siehe Kapazitätseinheit). Ein größeres Item kostet pro Operation mehr — und riskiert zusätzlich die harte Grenze.

Wenn du an sie stößt

Verteile die Daten auf mehrere Items, oder verlagere große Blobs nach Amazon S3 und speichere in DynamoDB eine Referenz.

Tiefer einsteigen

Miss ein beliebiges Item mit dem Item-Größen-Rechner und lies den Leitfaden zum Item-Größen-Limit. Lade DynoTable herunter, um Item-Größen schon beim Bearbeiten zu sehen.

Referenzen

Zuletzt verifiziert am 2026-07-13 gegen die oben verlinkte offizielle AWS-Dokumentation. Die 400-KB-Beschränkung wurde am 2026-07-28 erneut geprüft: Sie steht jetzt in Constraints.html, nicht mehr auf der Quotas-Seite.

Am 2026-07-28 gegen DynamoDB Local 3.3.0 via @aws-sdk/client-dynamodb 3.1095.0 auf Node v24.18.0 gemessen. Die Byte-Zahlen stammen aus einer Binärsuche über PutItem; die ValidationException ist wortgetreue Engine-Ausgabe.