DynamoDB'de maksimum öğe boyutu nedir?

400 KB. DynamoDB'deki maksimum öğe boyutu 400 KB'dır. Bu toplam, hem öznitelik adlarını (UTF-8 bayt uzunluğu) hem de iç içe list ve map'ler dahil tüm öznitelik değerlerini (ikili uzunluk) sayar. İkili değerler ham bayt uzunluğuyla ölçülür. Bu sınırı yükseltmenin bir yolu yoktur — daha büyük nesneler Amazon S3'e aittir.

400 KB'a ne dahildir

Öğe boyutu şunların toplamıdır:

• her öznitelik adı, UTF-8 baytlarıyla ölçülür ve
• her öznitelik değeri, ikili uzunlukla ölçülür (string'ler UTF-8, sayılar sıkışık, ikili veri ham bayt olarak).

İç içe map ve list yapısı da eleman başına küçük bir ek yük getirir. Uzun öznitelik adları gerçek yer kaplar — yer açmak için onları kısaltın.

400 KB, 409.600 bayttır ve ad da buna dahildir

AWS ikili birimlerle ölçer: "DynamoDB denotes 1 KB = 1024 bytes." Dolayısıyla tavan 400.000 değil, 409.600 bayttır. Tam kenarı, tek string özniteliğiyle PutItem üzerinde ikili arama yaparak bulabilirsiniz:

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

Başarılı olan en büyük n 409.596'dır. Anahtar adını (pk, 2 bayt), anahtar değerini (A, 1 bayt) ve öznitelik adını (a, 1 bayt) ekleyin, tam olarak 409.600'e ulaşırsınız. Bir bayt daha size şunu verir:

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

Şimdi o özniteliği a'dan attributeName'e yeniden adlandırın ve başka hiçbir şeyi değiştirmeyin. Sığan en büyük değer 409.584'e düşer — tam olarak 12 bayt daha az ve 12 bayt, adın fazladan uzunluğudur.

AWS'nin kendi tavsiyesi bu aritmetikten çıkar. "We recommend that you choose shorter attribute names rather than long ones."

Çok sayıda özniteliği olan bir öğede 400 KB'lık bütçenin göründüğünden dar olmasının nedeni de budur. Her ad, öğenin ömrü boyunca her yazmada ve her okumada ödenir.

Neden önemli

Öğe boyutu kapasite maliyetini belirler: her okuma 4 KB'lık, her yazma 1 KB'lık adımlarla faturalandırılır (bkz. kapasite birimi). Daha büyük bir öğe, sert sınırı riske atmanın yanı sıra işlem başına daha pahalıya gelir.

Sınıra çarptığınızda

Veriyi birden çok öğeye bölün ya da büyük ikili verileri Amazon S3'e taşıyıp DynamoDB'de bir referans saklayın.

Daha derine inin

Herhangi bir öğeyi öğe boyutu hesaplayıcısıyla ölçün ve öğe boyutu sınırı kılavuzunu okuyun. Düzenlerken öğe boyutlarını görmek için DynoTable'ı indirin.

Kaynaklar

• Constraints in Amazon DynamoDB — Amazon DynamoDB Developer Guide
• DynamoDB item sizes and formats — Amazon DynamoDB Developer Guide
• Local secondary indexes — Amazon DynamoDB Developer Guide

En son 2026-07-13 tarihinde yukarıda bağlantısı verilen resmi AWS belgelerine karşı doğrulandı. 400 KB kısıtı 2026-07-28 tarihinde yeniden denetlendi: artık kota sayfasında değil, Constraints.html içinde bulunuyor.

2026-07-28 tarihinde, Node v24.18.0 üzerinde @aws-sdk/client-dynamodb 3.1095.0 ile DynamoDB Local 3.3.0'a karşı ölçüldü. Bayt rakamları PutItem üzerinde bir ikili aramadan gelir; ValidationException birebir motor çıktısıdır.