Scan con filtros
Lee una tabla página por página y acota los resultados con expresiones de filtro de DynamoDB, nombres y valores de atributos, directamente desde el panel Filters.
El panel Filters
Haz clic en ⚙ Filters en la barra de herramientas para mostrar el panel de consultas. Un selector de modo en la parte superior ofrece Scan, Query y SQL. Scan es el modo predeterminado al abrir una tabla, y el estado del panel (abierto o cerrado) y los valores de sus campos se recuerdan por pestaña. Ejecuta el modo actual con ▶ Execute o ⌘+↵.
- Page Sizenumber
- Ítems solicitados por página, enviados como el parámetro Limit de DynamoDB. Valor predeterminado 50, rango permitido de 1 a 1000. Compartido por Scan, Query y SQL.
- Filter Expressiontext
- Una expresión de filtro de DynamoDB, como
attribute_exists(email) AND #status = :active. Solo se aplica cuando no está vacía. - Expression Attribute NamesJSON
- Marcadores para nombres de atributos que coinciden con palabras reservadas o contienen caracteres especiales, por ejemplo
{"#status": "status"}. - Expression Attribute ValuesJSON
- Valores referenciados en la expresión, por ejemplo
{":active": "active"}. Los tipos siguen el JSON que escribas: cadenas, números, booleanos, null, listas y mapas.
Ejecutar un scan
- Escribe la expresión
Usa la sintaxis nativa de DynamoDB. Están disponibles todos los operadores de comparación,
AND,OR,NOTy las funciones estándar. - Asigna nombres y valores
Todo marcador
#namedebe aparecer en el mapa de nombres, y todo marcador:value, en el mapa de valores. - Ejecuta
DynamoOps escanea una página, aplica el filtro del lado del servidor e informa el resultado en la 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)Cómo leer la barra de resultados
Después de cada ejecución, la barra debajo de la cuadrícula resume la página.
Page 1 · 50 items (120 scanned) · ⚡ 12.5 RCU · 💰 $0.001625 · ⏱ 143ms| Segmento | Significado |
|---|---|
| Page N | La página en la que estás. Los controles de paginación aparecen cuando hay más páginas. |
| items | Ítems devueltos en esta página después del filtrado. |
| scanned | Ítems que DynamoDB evaluó antes del filtro. Solo se muestra en Scan y Query. |
| RCU y costo | Capacidad que DynamoDB informó como consumida y su costo estimado. Se oculta cuando el endpoint no informa ninguna. |
| ms | Tiempo de ida y vuelta de la solicitud. |
Validación y errores
- Un JSON inválido en cualquiera de los dos mapas genera el aviso “Invalid JSON in Expression Attribute Names” o “… Values”. El scan se ejecuta de todos modos sin ese mapa, y DynamoDB normalmente rechazará la expresión con un error de validación.
- Los errores del servidor se muestran como “Query error: <AWS message>” (el mensaje de AWS), por ejemplo cuando falta un marcador o se usa una palabra reservada sin un marcador de nombre.
- El modo Scan no usa índices secundarios; cambia al modo Query para consultar un índice.