Referência
Solução de problemas
Soluções para as mensagens que você tem mais chance de encontrar: falhas de conexão, acesso negado, sessões expiradas, erros de validação em consultas, importações que falham e botões que você não encontra.
Problemas de conexão
| Sintoma | Causa e solução |
|---|---|
| Connection failed: The security token included in the request is invalid | As chaves do perfil estão incorretas ou expiradas. Execute aws sts get-caller-identity --profile <name> em um terminal para verificar e depois reconecte. |
| Connection failed: Could not load credentials from any providers | Nenhum perfil correspondeu e a cadeia padrão está vazia. Crie um com aws configure --profile dev ou digite o nome de um perfil existente. |
| Banner de acesso negado (Access denied) na barra lateral | O principal não tem dynamodb:ListTables. Use o atalho do banner para fazer Assume Role em uma role que tenha essa permissão. |
| Tabelas da região errada | O seletor de região oferece apenas sete regiões. Confirme se a escolhida corresponde às suas tabelas; ListTables é regional. |
| Conectado ao LocalStack, mas sem tabelas | Verifique a porta do endpoint (4566 para LocalStack, 8000 para DynamoDB Local) e se o serviço dynamodb está habilitado no contêiner. |
Sessões e SSO
| Sintoma | Causa e solução |
|---|---|
| As requisições começam a falhar depois de cerca de uma hora | Uma sessão de Assume Role expirou e o aviso de renovação foi ignorado. Reconecte ou use o diálogo de renovação da próxima vez. |
| SSO: AWS did not recognize this SSO start URL | A região do SSO deve ser aquela em que o IAM Identity Center está habilitado, não a região das suas tabelas. |
| SSO: o navegador não abre | Clique em Open the page again. Bloqueadores de pop-up e sessões de área de trabalho remota às vezes engolem a primeira tentativa. |
| SSO: Your SSO user has no AWS accounts assigned | O login funcionou, mas nenhuma conta está atribuída a você. Fale com o administrador do Identity Center. |
Erros de consulta
| Mensagem | Solução |
|---|---|
| ValidationException: Invalid FilterExpression: Attribute name is a reserved keyword | Use um placeholder: #status na expressão e {"#status":"status"} em Expression Attribute Names. |
| ValidationException: Value provided in ExpressionAttributeValues unused | Remova o valor excedente do mapa JSON ou referencie-o na expressão. |
| A consulta não retorna nada para uma chave que você está vendo | A chave é uma String com cara de número e foi enviada como Number. Use o modo SQL e coloque-a entre aspas: WHERE "id" = '001'. |
| Invalid JSON in Expression Attribute Names | A caixa de nomes ou de valores não contém um JSON válido. As chaves devem estar entre aspas duplas. |
| Partition key value is required for Query | Preencha o valor de Partition Key antes de executar. |
| ProvisionedThroughputExceededException | A tabela está sofrendo throttling. Reduza o Page Size, aguarde um momento ou aumente a capacidade. |
Dica
Pressione ⌘+↵ depois de cada correção; a notificação de erro e o erro SQL inline somem na próxima execução.Falhas de importação e escrita
| Mensagem | Solução |
|---|---|
| Batch n: One or more parameter values were invalid: Missing the key … | Faltam nas linhas a chave de partição ou a chave de ordenação com o nome exato do atributo. Use “Rename to” na etapa de mapeamento. |
| Batch n: Type mismatch for key | A coluna da chave tem um tipo diferente do da tabela (por exemplo, String em vez de Number). Defina o tipo explicitamente na grade de mapeamento. |
| D deleted, U not processed (throttled) | A exclusão em massa sofreu throttling mesmo após as novas tentativas. Execute a consulta novamente, selecione os itens de novo e exclua outra vez. |
| Item exceeds 400 KB | É o limite de tamanho de item do DynamoDB. Divida o item ou mova atributos grandes para o S3. |
Obtendo ajuda
Abra uma issue no GitHub informando a versão do app, o seu sistema operacional e a mensagem exata que você viu. Inclua a região e se você estava usando um endpoint personalizado; não envie credenciais nem dados das tabelas.
Relacionados
Conectando ao DynamoDB
A tela de login, os quatro métodos de conexão, o Quick Connect com perfis do AWS CLI, tags de ambiente, teste de conexão e como trocar de conta ou sair.
Segurança e privacidade
O que o DynamoOps armazena, o que envia e para onde. As credenciais ficam na sua máquina, os dados das tabelas nunca saem dela e o app não tem conta, verificação de licença nem telemetria.
Como contribuir
Relate bugs, sugira recursos e envie pull requests. Estas são as convenções que mantêm o código consistente e seguro.