El tamaño agregado de todas las claves de rango ha excedido el límite de tamaño de 1024 bytes

TL;DR — DynamoDB limita un valor de clave de clasificación (rango) a 1024 bytes y un valor de clave de partición (hash) a 2048 bytes (medido UTF-8 codificado). El valor de su clave de clasificación superó los 1024 bytes, normalmente una clave compuesta sobrecargada. Acórtelo, aplique hash a la parte larga o mueva la mayor parte a un atributo que no sea clave.

Qué 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 es un límite de tamaño de clave rígido, distinto del límite de Item de 400 KB. El valor de la clave de ordenación (medido en bytes UTF-8) puede ser como mucho de 1024 bytes; el valor de la clave de partición como mucho de 2048. Crúzalo y la escritura se rechaza con un ValidationException HTTP 400 — un error de solicitud que no es reintentable hasta que la clave sea más pequeña.

Por qué ocurre

• Claves de ordenación compuestas demasiado largas — concatenar muchos segmentos (ORG#…#PROJECT#…#DOC#…#veryLongTitle…) hasta que el valor supera los 1024 bytes.
• Codificar un valor grande en la clave — meter una URL completa, una ruta, una descripción o un blob serializado en la clave de ordenación.
• Caracteres multibyte — el texto no ASCII cuesta 2–4 bytes cada uno en UTF-8, así que una cadena "de aspecto corto" puede superar el límite de bytes.
• Clave de partición demasiado grande — la misma clase de error contra el límite de 2048 bytes de la clave hash.

Cómo solucionarlo

1. Recorta la clave compuesta a solo los segmentos por los que realmente consultas; elimina el relleno legible por humanos.
2. Aplica hash a la porción larga — almacena un resumen determinista corto (p. ej. un SHA-256 truncado) en la clave y guarda el valor completo como un atributo normal.
3. Saca el grueso de la clave — la clave de ordenación debe identificar/ordenar el Item, no cargar con su contenido; pon el texto largo en un atributo que no sea clave (que disfruta del presupuesto de 400 KB del Item).
4. Mide en bytes, no en caracteres — codifica en UTF-8 y cuenta, especialmente para datos no ASCII.

Míralo en DynoTable

Pega un Item borrador en la calculadora de tamaño de Item y comprueba los bytes de los atributos de clave antes de escribir. En DynoTable, abre la tabla con ⌘K, crea un Item de prueba con staging (⌘S) y confirma que la clave cabe — las claves sobredimensionadas fallan antes de confirmarse.

Cuando rediseñes claves compuestas, prototipa las consultas en el Query Builder con segmentos de clave más cortos. Cambia de perfil con ⌘P; Test Connection en Settings → Profiles. Consulta Conectar con AWS e Instalación.

Fuentes

• Supported data types and naming rules (verificado 2026-07-13)
• BatchWriteItem — Amazon DynamoDB API Reference (verificado 2026-07-13)

Errores relacionados

• Item size has exceeded the maximum allowed size (400 KB) — el Item entero, no solo la clave, es demasiado grande.
• The provided key element does not match the schema — una discrepancia de tipo/forma de clave.
• Aprende: Límite de tamaño de Item en DynamoDB

Referencias

• Supported data types and naming rules in Amazon DynamoDB — Developer Guide
• BatchWriteItem — Amazon DynamoDB API Reference (key length limits)
• Error handling with DynamoDB — Amazon DynamoDB Developer Guide

Verificado por última vez el 2026-07-13 contra la documentación oficial de AWS enlazada arriba.