Query por clave e índice
Obtén ítems por clave de partición, agrega una condición de clave de ordenación con cualquier operador compatible y consulta índices secundarios globales o locales sin escribir una expresión.
Cuándo usar Query
Una Query lee solo los ítems que comparten un valor de clave de partición, opcionalmente acotados por una condición sobre la clave de ordenación. Es el patrón de acceso eficiente para el que se diseñó DynamoDB: el costo es proporcional a lo que lees, no al tamaño de la tabla. Usa Query siempre que conozcas la clave de partición; recurre a Scan cuando no la conozcas.
Campos
Cambia el panel Filters a Query. DynamoOps completa los nombres de las claves a partir del esquema de la tabla o del índice; tú solo escribes los valores.
- Indexselect
- Primary Key (clave primaria) de forma predeterminada, seguida de cada índice secundario global por nombre y de los índices secundarios locales marcados con “(LSI)”. Al cambiar el índice, los campos de clave se reescriben según su esquema.
- Partition Keyvalueobligatorio
- El nombre del atributo se muestra como solo lectura; escribe el valor que debe coincidir.
- Sort Key conditionselect
- Solo se muestra cuando la tabla o el índice tiene clave de ordenación. Operadores:
=,<,<=,>,>=,begins_withybetween. Solo se aplica cuando el valor no está vacío. - Value / Value 2value
- Value 2 aparece con
betweeny contiene el límite superior. - Page Sizenumber
- Ítems por página, 50 de forma predeterminada.
Ejecutar una query
- Elige el índice
Elige Primary Key o el índice cuya clave de partición sea el atributo que quieres buscar.
- Ingresa el valor de la clave de partición
Es obligatorio. Si lo dejas vacío, se muestra “Partition key value is required for Query” (el valor de la clave de partición es obligatorio para Query).
- Opcionalmente, acota por clave de ordenación
Elige un operador y un valor. Para una clave de ordenación con prefijo de fecha,
begins_withcon2026-10devuelve un mes. - Ejecuta
DynamoOps construye la expresión de condición de clave por ti y ejecuta la query con el informe de capacidad consumida.
#pk = :pkval AND #sk BETWEEN :skval AND :skval2Cómo se tipan los valores
"001" o "123", el formulario de Query no lo encontrará. En su lugar, usa el modo SQL y pon el valor entre comillas: WHERE "orderId" = '001'.- El modo Query no tiene campo de expresión de filtro; para filtrar después de la clave, usa PartiQL o Scan.
- Los resultados se devuelven en el orden natural del índice. El orden inverso está disponible mediante
ORDER BY … DESCde PartiQL, donde sea compatible. - Las lecturas son eventualmente consistentes.
Referencia de operadores
| Operador | Coincide con claves de ordenación que son… | Ejemplo |
|---|---|---|
= | exactamente iguales | 2026-10-24 |
< | estrictamente menores que | antes de una fecha |
<= | menores o iguales que | hasta una fecha, inclusive |
> | estrictamente mayores que | después de una fecha |
>= | mayores o iguales que | desde una fecha en adelante |
begins_with | que comienzan con el prefijo indicado | ORDER# |
between | dentro del rango inclusivo de Value a Value 2 | 2026-01-01 … 2026-12-31 |