O tamanho agregado de todas as chaves de intervalo excedeu o limite de tamanho de 1.024 bytes

TL;DR — DynamoDB limita um valor de chave de classificação (intervalo) a 1.024 bytes e um valor de chave de partição (hash) a 2.048 bytes (medido codificado em UTF-8). O valor da sua chave de classificação ultrapassou 1.024 bytes - geralmente uma chave composta sobrecarregada. Encurte-o, faça hash da parte longa ou mova o volume para um atributo não-chave.

O que significa

ValidationException: One or more parameter values were invalid: Aggregated size of all range keys has exceeded the size limit of 1024 bytes

# on DynamoDB Local you get one combined sentence instead, naming neither key:
ValidationException: Hash primary key values must be under 2048 bytes, and range primary key values must be under 1024 bytes

Este é um limite rígido de tamanho da chave, separado do limite de item de 400 KB. O valor da chave de classificação (medido como bytes UTF-8) pode ter no máximo 1.024 bytes; o valor da chave de partição é no máximo 2048. Cruze-o e a gravação será rejeitada com um HTTP 400 ValidationException — um erro de solicitação que não pode ser repetido até que a chave seja menor.

Por que isso acontece

Chaves de classificação compostas muito longas — concatenando muitos segmentos (ORG#…#PROJECT#…#DOC#…#veryLongTitle…) até que o valor exceda 1.024 bytes.
Codificando um valor grande na chave — colocando um URL completo, caminho, descrição ou blob serializado na chave de classificação.
Caracteres multibyte — o texto não ASCII custa de 2 a 4 bytes cada em UTF-8, portanto, uma string de "aparência curta" pode ultrapassar o limite de bytes.
Chave de partição muito grande — a mesma classe de erro em relação ao limite de chave hash de 2.048 bytes.

Como corrigir

Corte a chave composta apenas para os segmentos que você realmente consulta; descarte o preenchimento legível por humanos.
Hash da parte longa — armazene um resumo determinístico curto (por exemplo, um SHA-256 truncado) na chave e mantenha o valor completo como um atributo normal.
Mova o volume para fora da chave — a chave de classificação deve identificar/order o item, não carregar sua carga útil; coloque texto longo em um atributo não-chave (que aproveita o orçamento de itens de 400 KB).
Medida em bytes, não em caracteres — Codificação e contagem UTF-8, especialmente para dados não ASCII.

Veja no DynoTable

Cole um item de rascunho na calculadora de tamanho do item e verifique a contagem de bytes dos atributos principais antes de escrever. No DynoTable, abra a tabela com ⌘K, crie um item de teste com preparação (⌘S) e confirme os ajustes da chave - chaves superdimensionadas falham antes da confirmação.

Ao redesenhar chaves compostas, crie protótipos de consultas no Query Builder com segmentos de chave mais curtos. Alternar perfis com ⌘P; Testar conexão em Configurações → Perfis. Consulte Conectar ao AWS e Instalar.

Fontes

Tipos de dados e regras de nomenclatura suportados (verificado em 13/07/2026)
BatchWriteItem — Referência Amazon DynamoDB API (verificado em 13/07/2026)

Erros relacionados

O tamanho do item excedeu o tamanho máximo permitido (400 KB) — o item inteiro, não apenas a chave, é muito grande.
O elemento-chave fornecido não corresponde ao esquema — uma incompatibilidade de tipo de chave/shape.
Aprenda: limite de tamanho do item DynamoDB

Referências

Última verificação em 13/07/2026 em relação à documentação oficial do AWS vinculada acima.