Mejores prácticas para Amazon DynamoDB: claves, consultas y costos

Amazon DynamoDB funciona mejor cuando sus claves y consultas responden a las operaciones concretas de una aplicación. Antes de crear tablas, anota qué datos debe obtener cada pantalla o proceso, qué claves tiene disponibles y con qué frecuencia leerá o escribirá. Ese diseño evita depender de recorridos completos de tabla para las consultas habituales.

Esta guía reúne prácticas para modelar claves, decidir cuándo agregar índices, elegir capacidad, diagnosticar throttling y proteger los datos. DynamoDB administra la infraestructura, pero no convierte una tabla en un motor de consultas libres: si necesitas buscar repetidamente por atributos que no forman parte de una clave, debes modelar ese acceso o añadir un índice.

Diseña las claves desde los patrones de acceso

Empieza por enumerar las consultas y escrituras que la aplicación necesita. Para cada patrón, identifica:

La guía de AWS para modelar datos en DynamoDB recomienda entender primero las preguntas que la aplicación debe responder. El diseño de una sola tabla puede ser útil si consultas juntas varias entidades relacionadas; varias tablas pueden ser más claras cuando esas entidades tienen necesidades operativas distintas. Ninguna forma es obligatoria para todas las aplicaciones. AWS explica esos dos enfoques de diseño.

Una tabla puede tener una clave primaria simple, formada solo por una clave de partición, o una clave compuesta por clave de partición y clave de ordenación. La clave de partición determina cómo se distribuyen los elementos; la de ordenación organiza los elementos que comparten la partición. Elige la clave de partición según el tráfico real: muchos valores distintos suelen ayudar, pero un valor muy popular todavía puede concentrar solicitudes y provocar una partición caliente. Una clave como el estado del pedido, con pocos valores posibles, requiere cuidado. Consulta las recomendaciones de AWS para distribuir la carga.

Si quieres practicar claves y consultas sin enviar operaciones al servicio de AWS, la guía Amazon DynamoDB para principiantes: claves y consultas propone un ejercicio local con AWS CLI y DynamoDB Local. El ejercicio permite familiarizarte con operaciones básicas, pero no mide cuotas, latencia, permisos ni costos de una tabla en AWS.

Ejemplo: pedidos por cliente y por estado

Supón que necesitas dos accesos:

  1. Listar los pedidos de un cliente durante un mes.
  2. Encontrar pedidos pendientes de todos los clientes durante un mes.

La tabla usa PK y SK como clave primaria compuesta; el GSI define GSI1PK y GSI1SK como sus claves de partición y ordenación. Para este ejemplo, podrían representar las consultas así:

PK SK GSI1PK GSI1SK estado
CLIENTE#42 PEDIDO#2026-10-04T08:00:00Z#9000 — — enviado
CLIENTE#42 PEDIDO#2026-10-05T14:30:00Z#9001 ESTADO#PENDIENTE#2026-10 2026-10-05T14:30:00Z#9001 pendiente
CLIENTE#77 PEDIDO#2026-10-06T09:00:00Z#9002 ESTADO#PENDIENTE#2026-10 2026-10-06T09:00:00Z#9002 pendiente

Para la primera consulta, usa Query sobre la tabla con PK = CLIENTE#42 y el prefijo PEDIDO#2026-10 en la clave de ordenación. Para la segunda, consulta el GSI con GSI1PK = ESTADO#PENDIENTE#2026-10 y un prefijo de octubre en GSI1SK. Las marcas de tiempo con el mismo formato UTC se ordenan cronológicamente como texto; el identificador al final distingue pedidos con la misma marca.

El índice del ejemplo es disperso: solo los pedidos pendientes tienen atributos GSI1PK y GSI1SK, así que son los únicos que aparecen en ese GSI. Agrupar por estado y mes ilustra una consulta posible, pero no garantiza una distribución uniforme: si un valor del índice concentra demasiado tráfico, revisa el diseño y la carga antes de usarlo en producción.

Para ver un diseño aplicado, la grabación AWS User Group Córdoba Meetup #18 incluye una charla sobre cómo modelar datos de una tienda en DynamoDB y otra sobre OpenSearch. La publica el canal Cloud en Español.

Usa Query para leer por clave y Scan con cuidado

GetItem recupera un elemento cuando conoces todos los valores de su clave primaria. Query requiere el valor exacto de la clave de partición y puede acotar resultados por la clave de ordenación. Por eso permite resolver los dos accesos del ejemplo sin recorrer los pedidos de otros clientes o estados. Revisa la documentación de Query y su paginación al implementar recorridos de resultados extensos.

Scan lee todos los elementos de una tabla o de un índice, en páginas de hasta 1 MB. Puede servir para una tarea ocasional, una tabla pequeña o un proceso de mantenimiento; no suele ser la base adecuada para una consulta repetida de una aplicación. Un filtro de Query o Scan elimina elementos de la respuesta después de leerlos y no reduce la capacidad consumida por esos elementos. Para un patrón frecuente, resuélvelo con las claves de la tabla o un índice. AWS describe cómo funciona Scan y cuándo se aplican sus filtros.

Los resultados de Query también se devuelven en páginas de hasta 1 MB; sigue la clave de paginación que devuelve la operación hasta completar la consulta. No fijes un tamaño de página universal: elige cuánto procesar por llamada según la respuesta que la aplicación pueda manejar y la latencia que necesite.

Agrega índices solo para consultas que lo necesitan

Un índice secundario ofrece otra clave para Query, pero se mantiene junto con la tabla y tiene costos de almacenamiento y escritura. Define qué atributos necesita devolver la consulta y proyecta solo esos atributos; una consulta a un GSI solo puede devolver las claves y atributos proyectados en él.

Un GSI puede usar una clave de partición y una clave de ordenación distintas de las de la tabla. DynamoDB actualiza el índice de forma asíncrona, por lo que sus lecturas son siempre eventualmente consistentes. En modo aprovisionado, el GSI tiene capacidad de lectura y escritura propia; si no puede procesar las actualizaciones derivadas de escrituras en la tabla, esas escrituras también pueden sufrir throttling.

Un índice secundario local (LSI) conserva la clave de partición de la tabla y cambia la clave de ordenación. Se define al crear la tabla; no puede añadirse después. Sus lecturas y escrituras usan la capacidad de la tabla, y permite pedir lecturas fuertemente consistentes. En tablas con LSI, los elementos de la tabla y las proyecciones de sus LSI que comparten un valor de clave de partición tienen un límite conjunto de 10 GB. No es un índice gratuito ni ofrece una clave de partición alternativa. La comparación oficial entre GSI y LSI explica sus límites y consumo.

Elige el modo de capacidad según la carga

DynamoDB ofrece capacidad bajo demanda (on-demand) y aprovisionada (provisioned):

El modo bajo demanda no significa capacidad ilimitada ni ausencia de throttling. Una clave muy solicitada, una cuota de cuenta o un máximo de solicitudes configurado pueden limitar el tráfico. En el modo aprovisionado también puedes superar la capacidad disponible de la tabla o de un GSI. Compara ambos modos con la carga real y consulta las tarifas vigentes de DynamoDB; no hay un modo que siempre cueste menos.

Un índice tiene su propio almacenamiento, y sus actualizaciones pueden aumentar el trabajo de escritura. Antes de crear un GSI, confirma qué consulta habilita, qué atributos devuelve y si la clave del índice distribuye bien lecturas y escrituras. La guía de capacidad de DynamoDB describe cómo se administran los dos modos.

Diagnostica el throttling antes de subir capacidad

Si una operación se limita, determina primero si el problema está en la tabla, en un GSI o en una clave que concentra tráfico. DynamoDB puede devolver excepciones con un motivo de throttling y el recurso afectado; una tabla con capacidad libre todavía puede tener una clave caliente o un índice que limite las escrituras.

En CloudWatch, revisa ConsumedReadCapacityUnits y ConsumedWriteCapacityUnits para observar el consumo de lecturas y escrituras. Compara ThrottledRequests con ReadThrottleEvents y WriteThrottleEvents para localizar lecturas o escrituras limitadas en la tabla y sus índices. Estas métricas ayudan a diagnosticar capacidad y tráfico; consulta facturación y precios para entender el costo monetario. AWS detalla los motivos y pasos de diagnóstico del throttling y las métricas de DynamoDB en CloudWatch.

Cuando encuentres una clave caliente, revisa el patrón de acceso y la distribución de claves antes de escalar. Si el recurso agotado es un GSI, aumentar solo la capacidad de la tabla no resuelve necesariamente el problema. La guía de diagnóstico de aplicaciones con CloudWatch amplía el trabajo con métricas y señales de otras capas de una aplicación.

Revisa también el comportamiento de reintentos de tu AWS SDK: puede reintentar errores temporales o de throttling con espera progresiva y variación aleatoria. Confirma el modo, la versión y el número máximo de intentos configurados. Los reintentos acotados ayudan a manejar fallos temporales; no corrigen una clave caliente ni la falta sostenida de capacidad.

Elige cuándo necesitas lecturas fuertes

Las lecturas eventualmente consistentes son el valor predeterminado. Una lectura fuertemente consistente refleja las escrituras exitosas anteriores, pero solo está disponible para tablas y LSI; un GSI solo admite lecturas eventualmente consistentes. Solicita consistencia fuerte cuando el flujo de la aplicación dependa de ver inmediatamente una escritura anterior y el origen de datos lo permita. La guía de consistencia de lectura de DynamoDB detalla las opciones.

Protege las escrituras y planifica la recuperación

Por defecto, PutItem puede reemplazar un elemento con la misma clave primaria. Si una creación debe fallar cuando el elemento ya existe, usa una condición como attribute_not_exists(PK). También puedes condicionar una actualización a que el estado actual siga siendo el esperado; esto evita sobrescribir un cambio concurrente que ya modificó ese elemento. Las expresiones de condición de DynamoDB muestran estas operaciones.

Para proteger los datos ante borrados o cambios accidentales, evalúa respaldos bajo demanda y la recuperación a un momento dado (PITR). PITR mantiene puntos de recuperación continuos durante una ventana configurable de hasta 35 días; una restauración crea una tabla nueva, así que revisa el proceso para volver a conectar la aplicación antes de depender de él. Consulta backup y recuperación en DynamoDB para opciones, disponibilidad y cargos.

La seguridad empieza por los permisos: usa roles y otorga solo las acciones que la aplicación necesita sobre sus tablas e índices. DynamoDB cifra los datos en reposo por defecto; el cifrado no sustituye la autorización de IAM. Evita incluir correos, tokens u otros datos sensibles en claves: los nombres y valores de claves pueden aparecer en metadatos y registros. Revisa las prácticas preventivas de seguridad de DynamoDB.

Sigue aprendiendo y conversa con la comunidad

El AWS User Group Córdoba es un grupo abierto a personas interesadas en cloud que comparte experiencias y conocimientos sobre AWS; en su página puedes consultar los encuentros anunciados. Si estás en otro país o ciudad, explora el directorio de comunidades AWS y la agenda de eventos. Para conversar sobre un diseño, lleva los patrones de acceso y un ejemplo de claves con datos ficticios: así puedes comparar cómo otras personas resuelven consultas, índices y distribución de tráfico.