Query por chave e índice
Busque itens pela chave de partição, adicione uma condição na chave de ordenação com qualquer operador suportado e consulte índices secundários globais ou locais sem escrever uma expressão.
Quando usar Query
Uma Query lê apenas os itens que compartilham o mesmo valor de chave de partição, opcionalmente refinados por uma condição na chave de ordenação. É o padrão de acesso eficiente para o qual o DynamoDB foi projetado: o custo é proporcional ao que você lê, não ao tamanho da tabela. Use Query sempre que souber a chave de partição; recorra ao Scan quando não souber.
Campos
Mude o painel Filters para Query. O DynamoOps preenche os nomes das chaves a partir do schema da tabela ou do índice; você só digita os valores.
- Indexselect
- Primary Key por padrão, seguido de cada índice secundário global pelo nome e dos índices secundários locais marcados com “(LSI)”. Trocar o índice reescreve os campos de chave para corresponder ao schema dele.
- Partition Keyvalueobrigatório
- O nome do atributo é exibido somente para leitura; digite o valor a ser buscado.
- Sort Key conditionselect
- Exibido apenas quando a tabela ou o índice tem chave de ordenação. Operadores:
=,<,<=,>,>=,begins_withebetween. Aplicado apenas quando o valor não está vazio. - Value / Value 2value
- Value 2 aparece com
betweene contém o limite superior. - Page Sizenumber
- Itens por página, padrão 50.
Executando uma query
- Escolha o índice
Escolha Primary Key ou o índice cuja chave de partição é o atributo que você quer buscar.
- Informe o valor da chave de partição
Ele é obrigatório. Deixá-lo vazio exibe “Partition key value is required for Query”.
- Opcionalmente, refine pela chave de ordenação
Escolha um operador e um valor. Para uma chave de ordenação prefixada por data,
begins_withcom2026-10retorna um mês inteiro. - Execute
O DynamoOps monta a key condition expression para você e executa a query com o relatório de capacidade consumida.
#pk = :pkval AND #sk BETWEEN :skval AND :skval2Como os valores são tipados
"001" ou "123", o formulário de Query não vai encontrá-la. Nesse caso, use o modo SQL e coloque o valor entre aspas: WHERE "orderId" = '001'.- O modo Query não tem campo de expressão de filtro; para filtrar depois da chave, use PartiQL ou Scan.
- Os resultados são retornados na ordem natural do índice. A ordem inversa está disponível pelo
ORDER BY … DESCdo PartiQL, quando suportado. - As leituras são eventualmente consistentes.
Referência de operadores
| Operador | Corresponde a chaves de ordenação que são… | Exemplo |
|---|---|---|
= | exatamente iguais | 2026-10-24 |
< | estritamente menores | antes de uma data |
<= | menores ou iguais | até uma data, inclusive |
> | estritamente maiores | depois de uma data |
>= | maiores ou iguais | a partir de uma data |
begins_with | iniciadas pelo prefixo informado | ORDER# |
between | dentro do intervalo inclusivo de Value a Value 2 | 2026-01-01 … 2026-12-31 |