Conectando ao DynamoDB

O DynamoOps abre em um cartão de login de tela cheia. Nada mais no app fica disponível até que uma conexão seja bem-sucedida. O cartão tem quatro abas, uma por método de conexão.

Dois botões do rodapé são compartilhados pela maioria das abas: Test Connection valida a conexão sem sair da tela de login, e o botão principal conecta. O rótulo dele muda conforme a aba: Connect to DynamoDB, Assume Role & Connect ou Sign in with AWS in browser.

O Quick Connect usa um perfil local do AWS CLI (ou a cadeia padrão do SDK) para acessar o DynamoDB em uma região, opcionalmente por meio de um endpoint personalizado.

AWS Regionselectobrigatório

Uma de sete regiões: us-east-1 (N. Virginia), us-east-2 (Ohio), us-west-1 (N. California), us-west-2 (Oregon), eu-west-1 (Irlanda), eu-central-1 (Frankfurt) e sa-east-1 (São Paulo). O padrão é us-east-1.

AWS Profiletext

O nome de um perfil em ~/.aws/credentials ou ~/.aws/config. Deixe default ou vazio para usar a cadeia de credenciais padrão do SDK, exatamente como ao executar o AWS CLI sem --profile. Se um perfil nomeado não puder ser carregado, o DynamoOps recorre à cadeia padrão.

Custom Endpoint (Optional)url

Aponta a conexão para o DynamoDB Local, o LocalStack ou qualquer endpoint compatível com o DynamoDB, por exemplo http://localhost:8000. Veja DynamoDB Local e LocalStack.

Environmenttoggle

None, Dev, QA, Staging, Prod ou Local. Uma tag visual exibida no cabeçalho depois de conectar. Veja abaixo.

Save this connectioncheckbox

Exibe um campo Profile Name. A conexão é salva localmente com esse nome e listada em Saved Profiles.

1. Preencha a região e o perfil

   Escolha a região onde estão suas tabelas e digite o nome do perfil.

2. Clique em Connect to DynamoDB

   O DynamoOps reinicia qualquer sessão anterior, cria os clientes AWS e os valida com uma chamada de ListTables limitada a um resultado.

3. Comece a trabalhar

   Em caso de sucesso, você vê o toast “Connected to <region>”, o cartão de login desaparece e a barra lateral lista suas tabelas. A conexão também é registrada em Recent Connections.

Se a conexão falhar, o erro retornado pela AWS aparece logo abaixo do formulário, por exemplo “Connection failed: The security token included in the request is invalid” (o token de segurança incluído na requisição é inválido).

Toda conexão pode ter uma tag de ambiente. Depois de conectar, a tag aparece como um selo colorido no cabeçalho (DEV, QA, STAGING, PROD ou LOCAL), para que você sempre saiba a qual conta uma aba pertence. A tag é puramente visual: ela não adiciona confirmações nem proteção contra escrita. Ela é salva junto com os perfis salvos, as conexões recentes e o histórico de Assume Role, e restaurada quando você os reutiliza.

Test Connection faz a mesma validação que a conexão: cria os clientes e chama ListTables. Você vê “Connection test successful!” (teste de conexão bem-sucedido) ou “Test failed: <message>” (falha no teste) sem sair da tela de login.

Depois de conectado, o cabeçalho mostra o estado da sessão em um relance.

• Selo de provedor — ☁ AWS <region> para endpoints reais da AWS, ou ⚡ LocalStack <region> quando o endpoint personalizado contém localhost, 127.0.0.1 ou localstack.
• Selo de role — 🛡️ <RoleName> quando uma sessão de Assume Role ou SSO está ativa. No Assume Role, inclui uma contagem regressiva ao vivo até a expiração.
• Selo de ambiente — a tag que você escolheu ao conectar.
• Indicador de status — Connected, Connecting…, Assuming role…, Failed ou Disconnected.

Use o botão 🔄 (Switch AWS Connection) no cabeçalho para trazer de volta a tela de login enquanto a sessão atual continua ativa. No momento em que você se conecta a outra coisa, o DynamoOps encerra a sessão anterior: descarta as credenciais temporárias, fecha todas as abas e limpa a lista de tabelas. Abas de duas conexões diferentes nunca coexistem.

O botão de logout encerra a sessão imediatamente: as credenciais temporárias são descartadas, todas as abas são fechadas, os selos são limpos e o status passa a Disconnected. Os tokens SSO em cache no disco não são removidos pelo logout; para isso, use Forget this SSO session na aba AWS SSO.