Berapa ukuran item maksimum di DynamoDB?

400 KB. Ukuran item maksimum di DynamoDB adalah 400 KB. Total itu menghitung baik nama atribut (panjang byte UTF-8) maupun seluruh nilai atribut (panjang biner), termasuk list dan map bersarang. Nilai biner diukur dari panjang byte mentahnya. Tak ada cara menaikkan batas ini — objek yang lebih besar tempatnya di Amazon S3.

Apa saja yang dihitung ke dalam 400 KB

Ukuran item adalah jumlah dari:

setiap nama atribut, diukur dalam byte UTF-8, dan
setiap nilai atribut, diukur dalam panjang biner (string sebagai UTF-8, angka secara ringkas, biner sebagai byte mentah).

Struktur map dan list bersarang juga menambah sedikit overhead per elemen. Nama atribut yang panjang memakan ruang sungguhan — perpendek untuk menghemat tempat.

400 KB adalah 409.600 byte, dan namanya termasuk

AWS mengukur dalam satuan biner: "DynamoDB denotes 1 KB = 1024 bytes." Jadi plafonnya 409.600 byte, bukan 400.000. Anda bisa menemukan tepi persisnya dengan pencarian biner atas PutItem memakai satu atribut string:

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

n terbesar yang berhasil adalah 409.596. Tambahkan nama key-nya (pk, 2 byte), nilai key-nya (A, 1 byte), dan nama atributnya (a, 1 byte) dan Anda mendarat tepat di 409.600. Satu byte lagi memberi Anda:

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

Sekarang ganti nama atribut itu dari a menjadi attributeName dan jangan ubah apa pun yang lain. Nilai terbesar yang muat turun menjadi 409.584, persis 12 byte lebih sedikit, dan 12 byte adalah tambahan panjang namanya.

Panduan AWS sendiri mengikuti aritmetika itu. "We recommend that you choose shorter attribute names rather than long ones."

Itu juga sebabnya anggaran 400 KB lebih ketat daripada kelihatannya pada item dengan banyak atribut. Setiap nama dibayar pada setiap penulisan, dan pada setiap pembacaan, sepanjang umur item itu.

Mengapa ini penting

Ukuran item menggerakkan biaya kapasitas: setiap pembacaan ditagih dalam langkah 4 KB dan setiap penulisan dalam langkah 1 KB (lihat capacity unit). Item yang lebih besar berbiaya lebih mahal per operasi sekaligus berisiko menabrak batas kerasnya.

Ketika Anda menabraknya

Pecah datanya ke beberapa item, atau pindahkan blob besar ke Amazon S3 dan simpan rujukannya di DynamoDB.

Pelajari lebih lanjut

Ukur item mana pun dengan kalkulator ukuran item dan baca panduan batas ukuran item. Unduh DynoTable untuk melihat ukuran item sambil Anda menyunting.

Referensi

Terakhir diverifikasi 2026-07-13 terhadap dokumentasi resmi AWS yang ditautkan di atas. Batasan 400 KB diperiksa ulang 2026-07-28: kini ia berada di Constraints.html, bukan di halaman kuota.

Diukur 2026-07-28 terhadap DynamoDB Local 3.3.0 via @aws-sdk/client-dynamodb 3.1095.0 pada Node v24.18.0. Angka byte-nya berasal dari pencarian biner atas PutItem; ValidationException-nya adalah keluaran mesin apa adanya.