Scan com filtros
Leia uma tabela página por página e refine os resultados com expressões de filtro, nomes e valores de atributos do DynamoDB, direto no painel Filters.
O painel Filters
Clique em ⚙ Filters na barra de ferramentas para exibir o painel de consulta. Um seletor de modo no topo oferece Scan, Query e SQL. Scan é o modo padrão quando uma tabela é aberta, e o estado de abertura do painel e os valores dos campos ficam salvos por aba. Execute o modo atual com ▶ Execute ou ⌘+↵.
- Page Sizenumber
- Itens solicitados por página, enviados como o Limit do DynamoDB. Padrão 50, intervalo permitido de 1 a 1000. Compartilhado por Scan, Query e SQL.
- Filter Expressiontext
- Uma expressão de filtro do DynamoDB, como
attribute_exists(email) AND #status = :active. Aplicada apenas quando não está vazia. - Expression Attribute NamesJSON
- Placeholders para nomes de atributos que conflitam com palavras reservadas ou contêm caracteres especiais, por exemplo
{"#status": "status"}. - Expression Attribute ValuesJSON
- Valores referenciados na expressão, por exemplo
{":active": "active"}. Os tipos seguem o JSON que você digita: strings, números, booleanos, null, listas e mapas.
Executando um scan
- Escreva a expressão
Use a sintaxe nativa do DynamoDB. Todos os operadores de comparação,
AND,OR,NOTe as funções padrão estão disponíveis. - Mapeie nomes e valores
Todo placeholder
#nameprecisa constar no mapa de nomes; todo placeholder:value, no mapa de valores. - Execute
O DynamoOps faz o scan de uma página, aplica o filtro no lado do servidor e informa o resultado na barra de resultados.
#status = :active AND createdAt > :since
begins_with(#sk, :prefix)
contains(tags, :tag)
attribute_not_exists(deletedAt)
size(items) >= :min
attribute_type(score, :numType)Lendo a barra de resultados
Após cada execução, a barra abaixo da grade resume a página.
Page 1 · 50 items (120 scanned) · ⚡ 12.5 RCU · 💰 $0.001625 · ⏱ 143ms| Segmento | Significado |
|---|---|
| Page N | A página em que você está. Os controles de paginação aparecem quando existem mais páginas. |
| items | Itens retornados nesta página após a filtragem. |
| scanned | Itens que o DynamoDB avaliou antes do filtro. Exibido apenas para Scan e Query. |
| RCU e custo | Capacidade que o DynamoDB informou como consumida e seu custo estimado. Oculto quando o endpoint não informa nenhuma. |
| ms | Tempo de ida e volta da requisição. |
Validação e erros
- JSON inválido em qualquer um dos mapas gera o aviso “Invalid JSON in Expression Attribute Names” ou “… Values”. O scan ainda é executado sem esse mapa, e o DynamoDB normalmente rejeitará a expressão com um erro de validação.
- Erros do servidor são exibidos como “Query error: <AWS message>”, por exemplo quando falta um placeholder ou quando uma palavra reservada é usada sem um placeholder de nome.
- O modo Scan não usa índices secundários; mude para o modo Query para consultar um índice.