Referencia
Solución de problemas
Soluciones para los mensajes que más probablemente encontrarás: fallas de conexión, acceso denegado, sesiones vencidas, errores de validación de consultas, importaciones fallidas y botones que no encuentras.
Problemas de conexión
| Síntoma | Causa y solución |
|---|---|
| Connection failed: The security token included in the request is invalid | Las claves del perfil son incorrectas o vencieron. Ejecuta aws sts get-caller-identity --profile <name> en una terminal para verificarlas y vuelve a conectarte. |
| Connection failed: Could not load credentials from any providers | Ningún perfil coincidió y la cadena predeterminada está vacía. Crea uno con aws configure --profile dev o escribe el nombre de un perfil existente. |
| Banner Access denied en la barra lateral | La entidad principal no tiene dynamodb:ListTables. Usa el acceso directo del banner para hacer Assume Role a un rol que sí lo tenga. |
| Tablas de la región equivocada | El selector de región solo ofrece siete regiones. Asegúrate de que la elegida coincida con tus tablas; ListTables es regional. |
| Conectado a LocalStack pero sin tablas | Revisa el puerto del endpoint (4566 para LocalStack, 8000 para DynamoDB Local) y que el servicio dynamodb esté habilitado en el contenedor. |
Sesiones y SSO
| Síntoma | Causa y solución |
|---|---|
| Las solicitudes empiezan a fallar después de aproximadamente una hora | Una sesión de Assume Role venció y se ignoró el aviso de renovación. Vuelve a conectarte o usa el diálogo de renovación la próxima vez. |
| SSO: AWS did not recognize this SSO start URL | La región de SSO debe ser aquella donde IAM Identity Center está habilitado, no donde están tus tablas. |
| SSO: el navegador nunca se abre | Haz clic en Open the page again. Los bloqueadores de ventanas emergentes y las sesiones de escritorio remoto a veces bloquean el primer intento. |
| SSO: Your SSO user has no AWS accounts assigned | El inicio de sesión funcionó, pero no tienes ninguna cuenta asignada. Pídesela al administrador de Identity Center. |
Errores de consulta
| Mensaje | Solución |
|---|---|
| ValidationException: Invalid FilterExpression: Attribute name is a reserved keyword | Usa un marcador: #status en la expresión y {"#status":"status"} en Expression Attribute Names. |
| ValidationException: Value provided in ExpressionAttributeValues unused | Quita el valor sobrante del mapa JSON o haz referencia a él en la expresión. |
| La consulta no devuelve nada para una clave que sí ves | La clave es un String que parece numérico y se envió como Number. Usa el modo SQL y ponla entre comillas: WHERE "id" = '001'. |
| Invalid JSON in Expression Attribute Names | El cuadro de nombres o de valores no tiene JSON válido. Las claves deben ir entre comillas dobles. |
| Partition key value is required for Query | Completa el valor de Partition Key antes de ejecutar. |
| ProvisionedThroughputExceededException | La tabla está aplicando throttling. Reduce Page Size, espera un momento o aumenta la capacidad. |
Consejo
Presiona ⌘+↵ después de cada corrección; la notificación de error y el error de SQL en línea desaparecen en la siguiente ejecución.Fallas de importación y escritura
| Mensaje | Solución |
|---|---|
| Batch n: One or more parameter values were invalid: Missing the key … | A las filas les falta la clave de partición o de ordenación con el nombre de atributo exacto. Usa “Rename to” en el paso de mapeo. |
| Batch n: Type mismatch for key | La columna de la clave tiene un tipo distinto al de la tabla (por ejemplo, String frente a Number). Define el tipo explícitamente en la grilla de mapeo. |
| D deleted, U not processed (throttled) | La eliminación masiva sufrió throttling después de los reintentos. Vuelve a ejecutar la consulta, selecciona de nuevo y elimina otra vez. |
| Item exceeds 400 KB | Es el límite de tamaño de ítem de DynamoDB. Divide el ítem o mueve los atributos grandes a S3. |
Obtener ayuda
Abre un issue en GitHub con la versión de la app, tu sistema operativo y el mensaje exacto que viste. Incluye la región y si estabas usando un endpoint personalizado; no incluyas credenciales ni datos de tablas.
Relacionados
Conectarse a DynamoDB
La pantalla de inicio de sesión, los cuatro métodos de conexión, Quick Connect con perfiles de AWS CLI, las etiquetas de entorno, cómo probar una conexión y cómo cambiar de conexión o cerrar sesión.
Seguridad y privacidad
Qué guarda DynamoOps, qué envía y a dónde. Las credenciales se quedan en tu equipo, los datos de las tablas nunca salen de él y la app no tiene cuenta, verificación de licencia ni telemetría.
Contribuir
Reporta errores, sugiere funcionalidades y envía pull requests. Estas son las convenciones que mantienen el código consistente y seguro.