Estadísticas de tabla

Toda tabla abierta tiene un botón Estadísticas — el icono de gráfico de barras — en la barra de herramientas de la pestaña, tanto en modo Visual como en modo PartiQL. Abre un panel por tabla que muestra de un vistazo la forma de la tabla, te permite indexarla para que el autocompletado conozca tus campos y exporta un esquema inferido en TypeScript, Zod o JSON Schema.

El panel de Estadísticas de tabla: claves e índices, estimaciones de tamaño, estado de indexación y la lista de campos indexados.
El panel de Estadísticas de tabla: claves e índices, estimaciones de tamaño, estado de indexación y la lista de campos indexados.

Resumen

La parte superior del panel expone la estructura de la tabla:

  • Clave primaria — la clave de partición y la clave de ordenación, si la tabla tiene una.
  • Índices secundarios — cada índice secundario global o local y sus claves. Una tabla con muchos índices se mantiene compacta — la lista se desplaza en su sitio.
  • Elementos · Tamaño · Elemento medio — las propias estimaciones de DynamoDB. Se actualizan aproximadamente cada seis horas, así que trátalas como cifras aproximadas, no como recuentos exactos. Pasa el cursor sobre estimación de DynamoDB para ver la salvedad.

Indexing your table

Sin campos indexados, los editores de consultas del Workbench y de PartiQL no muestran ninguna sugerencia de campos ni de valores. El autocompletado de palabras clave, funciones y operadores sigue funcionando.

El índice alimenta:

  • Editores de consultas: las sugerencias de campos y valores del Workbench y de PartiQL, más la comprobación de columnas desconocidas del Workbench.
  • Editor de elementos: los datos indexados aportan todas las sugerencias de nombres de campo que no son clave y todas las sugerencias de valores. Los nombres de clave PK, SK, GSI y LSI vienen de la definición de la tabla y no necesitan índice.
  • Herramientas visuales de tabla: el selector de columnas, los filtros visuales de Query y de Scan, los nodos de Smart Table y el selector de atributos de relación.
  • IA: las sugerencias @column para la tabla activa, las herramientas de schema, las pistas de schema para el texto fantasma y las ediciones en línea en ambos editores de consultas, y la normalización de las columnas unidas de Smart Table.
  • Estadísticas y uso compartido: la lista de Campos indexados, la exportación de esquema inferido y la publicación de índices en el espacio de trabajo de equipo.

El autocompletado basado en el índice y el texto fantasma de IA son cosas distintas. Las sugerencias del índice en el Workbench y en PartiQL no están restringidas; el texto fantasma de IA está desactivado por defecto y requiere una licencia activa.

En el editor de elementos, el modo DynamoDB JSON suprime el autocompletado de valores indexados. El autocompletado de nombres de campo sí sigue funcionando ahí.

Un índice puede aparecer o crecer de cinco formas:

  1. Escaneo manual: Indexar tabla escanea hasta 10.000 elementos por defecto. Reindexar borra primero el índice actual y luego escanea hasta el mismo tope. En tablas anchas o de cola larga, los atributos que se ven por primera vez más allá del tope siguen ausentes.
  2. Páginas obtenidas: a medida que traes páginas de la tabla, DynoTable añade esos elementos al índice sin borrarlo.
  3. Smart Tables: la primera página obtenida arranca el índice.
  4. Espacio de trabajo de equipo: el índice publicado de un compañero se puede importar sin ningún escaneo local. Consulta Espacio de trabajo de equipo para ver qué reemplaza una importación.
  5. Arranque por IA: ante un fallo de schema, la IA construye un índice de mejor esfuerzo de unos 100 elementos antes de responder. Se suma a cualquier índice existente.

El escaneo manual muestra el progreso en vivo y consume lecturas de DynamoDB. Tras la indexación, Campos indexados lista los atributos encontrados, incluidas las rutas anidadas con puntos como commonData.status.

Cada campo muestra su tipo observado y si era requerido u opcional entre los elementos muestreados. Pasado un puñado de campos, aparece una caja de filtro para que encuentres uno rápidamente. Borrar índice elimina el índice local.

Exportar un esquema

Desde una tabla indexada, abre Exportar y elige un formato para convertir tus elementos en un esquema tipado:

  • TypeScript — una interface.
  • Zod — un esquema z.object(...) (compatible con Standard-Schema).
  • JSON Schema — draft 2020-12.

Cópialo al portapapeles o guárdalo en un archivo. Toda exportación se abre con una nota que indica que fue inferido a partir de los elementos muestreados — un buen punto de partida, no un contrato autoritativo. La opcionalidad refleja con qué frecuencia apareció cada atributo durante la indexación; los atributos de clave primaria siempre se marcan como requeridos.

Este es un esquema de la forma de tus datos — distinto de una Exportación de los datos en sí.

Actualizado