DynamoDB ItemCollectionSizeLimitExceededException

TL;DR — Hanya tabel dengan Indeks Sekunder Lokal (LSI) yang memiliki batas ini: semua item yang berbagi satu kunci partisi ("koleksi item") dapat berjumlah maksimal 10 GB. Salah satu kunci partisi Anda melewatinya. Desain ulang sehingga tidak ada satu pun kunci partisi yang mengumpulkan data tanpa batas — atau hapus LSI.

Apa artinya

ItemCollectionSizeLimitExceededException: Collection size exceeded.

Ini muncul kembali sebagai HTTP 400, dan AWS mencantumkannya sebagai OK untuk mencoba lagi — tetapi percobaan ulang hanya berhasil setelah koleksi menyusut kembali di bawah 10 GB. Membaca, dan menulis yang memperkecil ukuran koleksi (menghapus, menghapus, atau memangkas atribut), masih diperbolehkan, sehingga Anda dapat mencari jalan keluarnya.

Mengapa itu terjadi

• kunci partisi hot/unbounded — satu kunci (penyewa besar, pengguna populer) mengumpulkan lebih banyak item dibandingkan yang lain.
• LSI yang mungkin tidak Anda perlukan — batas 10 GB ada hanya karena tabel memiliki LSI.
• Pertumbuhan hanya tambahan di bawah satu kunci partisi seiring waktu.

Bagaimana cara memperbaikinya

1. Pecahkan ulang kunci partisi. Pisahkan entitas berukuran besar ke beberapa kunci partisi (misalnya TENANT#42#1, TENANT#42#2) sehingga tidak ada satu koleksi pun yang tumbuh tanpa batas.
2. Ganti LSI dengan GSI. GSI memiliki kunci partisinya sendiri dan tidak batas ukuran koleksi item — untuk sebagian besar pola akses, GSI adalah pilihan yang lebih baik (dan dapat ditambahkan/removed setelah pembuatan tabel, tidak seperti LSI).
3. Arsipkan item dingin dari koleksi panas (ke tabel terpisah atau S3).
4. Pantau ukuran koleksi sebelum Anda mencapai batasnya. ReturnItemCollectionMetrics: SIZE saat penulisan mengembalikan perkiraan ukuran koleksi sehingga Anda dapat memperingatkan sebelum penulisan gagal.

Temukan di DynoTable

Temukan kunci partisi mana yang menyimpan item paling banyak sebelum koleksi mencapai 10 GB — buka tabel dengan ⌘K, urutkan berdasarkan kunci partisi, dan pindai kunci dengan daftar item yang sangat panjang. Kalkulator ukuran item membantu memperkirakan pertumbuhan per item saat Anda merencanakan pecahan ulang.

Gunakan kalkulator harga untuk membandingkan amplifikasi tulis LSI dengan alternatif GSI. Ganti profil dengan ⌘P; konfigurasikan di bawah Pengaturan → Profil. Lihat Menghubungkan ke AWS dan Instal.

Sumber

• Indeks sekunder lokal (diverifikasi 13-07-2026)
• Penanganan kesalahan dengan DynamoDB (diverifikasi 13-07-2026)

Kesalahan terkait

• Ukuran item telah melampaui ukuran maksimum yang diizinkan — batas 400 KB per item.
• ProvisionedThroughputExceededException
• Pelajari: GSI vs LSI · Koleksi item

Referensi

• Penanganan kesalahan dengan DynamoDB — Panduan Pengembang Amazon DynamoDB
• Indeks sekunder lokal — Panduan Pengembang Amazon DynamoDB
• Kuota di Amazon DynamoDB — Panduan Pengembang Amazon DynamoDB

Terakhir diverifikasi 2026-07-13 berdasarkan dokumentasi resmi AWS yang ditautkan di atas.