Conectarse a DynamoDB

DynamoOps se abre con una tarjeta de inicio de sesión a pantalla completa. Nada más en la app está disponible hasta que una conexión se establece correctamente. La tarjeta tiene cuatro pestañas, una por cada método de conexión.

La mayoría de las pestañas comparten dos botones en el pie: Test Connection valida la conexión sin salir de la pantalla de inicio de sesión, y el botón principal conecta. Su etiqueta cambia según la pestaña: Connect to DynamoDB, Assume Role & Connect o Sign in with AWS in browser.

Quick Connect usa un perfil local de AWS CLI (o la cadena predeterminada del SDK) para llegar a DynamoDB en una región, con la opción de usar un endpoint personalizado.

AWS Regionselectobligatorio

Una de siete regiones: us-east-1 (Norte de Virginia), us-east-2 (Ohio), us-west-1 (Norte de California), us-west-2 (Oregón), eu-west-1 (Irlanda), eu-central-1 (Fráncfort) y sa-east-1 (São Paulo). El valor predeterminado es us-east-1.

AWS Profiletext

El nombre de un perfil en ~/.aws/credentials o ~/.aws/config. Deja default o el campo vacío para usar la cadena de credenciales predeterminada del SDK, exactamente como al ejecutar AWS CLI sin --profile. Si no se puede cargar un perfil con nombre, DynamoOps recurre a la cadena predeterminada.

Custom Endpoint (Optional)url

Apunta la conexión a DynamoDB Local, LocalStack o cualquier endpoint compatible con DynamoDB, por ejemplo http://localhost:8000. Consulta DynamoDB Local y LocalStack.

Environmenttoggle

None, Dev, QA, Staging, Prod o Local. Una etiqueta visual que aparece en el encabezado después de conectarte. Consulta más abajo.

Save this connectioncheckbox

Muestra un campo Profile Name. La conexión se guarda localmente con ese nombre y aparece en Saved Profiles.

1. Completa la región y el perfil

   Elige la región donde están tus tablas y escribe el nombre del perfil.

2. Haz clic en Connect to DynamoDB

   DynamoOps reinicia cualquier sesión anterior, crea los clientes de AWS y los valida con una llamada a ListTables limitada a un resultado.

3. Empieza a trabajar

   Si todo sale bien, verás el aviso “Connected to <region>” (conectado a la región), la tarjeta de inicio de sesión desaparece y la barra lateral lista tus tablas. La conexión también queda registrada en Recent Connections.

Si la conexión falla, el error de AWS se muestra debajo del formulario, por ejemplo “Connection failed: The security token included in the request is invalid” (el token de seguridad incluido en la solicitud no es válido).

Cada conexión puede llevar una etiqueta de entorno. Después de conectarte, la etiqueta aparece como una insignia de color en el encabezado (DEV, QA, STAGING, PROD o LOCAL) para que siempre sepas a qué cuenta pertenece una pestaña. La etiqueta es puramente visual: no agrega confirmaciones ni protección contra escritura. Se guarda junto con los perfiles guardados, las conexiones recientes y el historial de Assume Role, y se restaura cuando los vuelves a usar.

Test Connection realiza la misma validación que al conectarte: crea los clientes y llama a ListTables. Verás “Connection test successful!” (prueba exitosa) o “Test failed: <message>” (la prueba falló) sin salir de la pantalla de inicio de sesión.

Una vez conectado, el encabezado muestra el estado de la sesión de un vistazo.

• Insignia de proveedor — ☁ AWS <region> para endpoints reales de AWS, o ⚡ LocalStack <region> cuando el endpoint personalizado contiene localhost, 127.0.0.1 o localstack.
• Insignia de rol — 🛡️ <RoleName> cuando hay una sesión de Assume Role o SSO activa. En el caso de Assume Role, incluye una cuenta regresiva en vivo hasta el vencimiento.
• Insignia de entorno — la etiqueta que elegiste al conectarte.
• Indicador de estado — Connected, Connecting…, Assuming role…, Failed o Disconnected.

Usa el botón 🔄 (Switch AWS Connection) del encabezado para volver a la pantalla de inicio de sesión mientras la sesión actual sigue activa. En cuanto te conectas a otra cosa, DynamoOps reinicia la sesión anterior: descarta las credenciales temporales, cierra todas las pestañas y vacía la lista de tablas. Las pestañas de dos conexiones distintas nunca coexisten.

El botón de cerrar sesión termina la sesión de inmediato: se descartan las credenciales temporales, se cierran todas las pestañas, se limpian las insignias y el estado indica Disconnected. Cerrar sesión no elimina los tokens de SSO almacenados en caché en el disco; para eso, usa Forget this SSO session en la pestaña AWS SSO.