Esquema e infraestructura

Administrador de índices (GSI)

Inspecciona la clave primaria y los índices secundarios locales y globales de una tabla, crea nuevos índices secundarios globales con cualquier proyección y elimina los que ya no necesites.

Abrir el administrador de índices

Haz clic en Indexes en la barra de información de la tabla. El diálogo Indexes — <table> muestra una tarjeta por índice.

Diálogo Indexes con la clave primaria y dos GSI — El administrador de índices muestra la clave primaria y cada índice secundario.

Tarjeta	Contenido
PRIMARY	El esquema de claves propio de la tabla. Siempre ACTIVE; no se puede eliminar.
LSI	Índices secundarios locales con su clave de ordenación y su proyección. Solo lectura: los LSI solo se pueden definir al crear la tabla.
GSI	Índices secundarios globales con su estado en vivo (CREATING, ACTIVE, UPDATING, DELETING), claves, proyección, capacidad u On-demand, tamaño y cantidad de ítems, además de un botón Delete.

Cada tarjeta detalla las Keys (clave de partición y de ordenación con sus tipos), la Projection (ALL, KEYS_ONLY o INCLUDE con sus atributos) y Capacity / Size (capacidad y tamaño).

Crear un GSI

Haz clic en Add Global Secondary Index para pasar al formulario de creación.

Formulario New Global Secondary Index con una proyección INCLUDE — Creación de un GSI con una proyección INCLUDE.

Index Nametextobligatorio: Por ejemplo, email-index. Debe ser único dentro de la tabla.
Partition Keytextobligatorio: El atributo por el que se indexa, con su tipo (S, N o B).
Sort Keytext: Clave de rango opcional para el índice, con su tipo.
Projectionradio: ALL copia todos los atributos; KEYS_ONLY copia solo las claves del índice y de la tabla; INCLUDE copia las claves más los atributos que indiques, separados por comas.

Completa las claves y la proyección
La validación en línea pide el nombre, la clave de partición y, para INCLUDE, al menos un atributo.
Haz clic en Create GSI
DynamoOps envía un UpdateTable con una acción Create. La notificación dice “GSI creation started — may take a few minutes.” (la creación comenzó y puede tardar unos minutos) y la lista vuelve a mostrarse con el nuevo índice en CREATING.
Revisa el estado más tarde
El estado se lee al abrir el diálogo o al recargar la tabla; vuelve a abrir el diálogo o selecciona de nuevo la tabla para ver cuándo pasa a ACTIVE. El backfill de una tabla grande puede tardar bastante.

Tablas aprovisionadas

El formulario no solicita throughput aprovisionado. En tablas con modo de facturación PROVISIONED, AWS exige capacidad de lectura y escritura para cada GSI, por lo que la creación falla con un error de validación; en ese caso, crea el índice con capacidad desde la consola o mediante IaC. Las tablas bajo demanda funcionan como se espera.

Eliminar un GSI

Haz clic en Delete en la tarjeta de un índice, o en la ✕ de la etiqueta del índice en la barra de información de la tabla. Confirma en el diálogo. Aparece la notificación “GSI deletion started.” y el índice muestra DELETING hasta que AWS termina.

Eliminar un índice no afecta los datos de la tabla, solo la copia del índice.
AWS permite una sola creación o eliminación de índice en curso por tabla; espera a que termine la operación anterior.
Las consultas dirigidas al índice eliminado fallarán; revisa el selector Index del formulario de Query en las pestañas abiertas.

Elegir una proyección

Proyección	Costo de almacenamiento y escritura	Úsala cuando
ALL	El más alto: se duplican todos los atributos	Las consultas sobre el índice necesitan atributos arbitrarios y quieres evitar una segunda lectura.
KEYS_ONLY	El más bajo	Solo necesitas encontrar las claves y luego obtener los ítems de la tabla base.
INCLUDE	Intermedio	Un pequeño conjunto conocido de atributos cubre el patrón de acceso.

Relacionados

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.

Exportar esquema (IaC)

Convierte una tabla existente en código de infraestructura. Copia su esquema como YAML de CloudFormation, HCL de Terraform o TypeScript de Pulumi, con atributos, claves, GSI, LSI y TTL.

Barra lateral, barra de información y barra de herramientas

Encuentra tablas rápido, lee el esquema de claves y los índices de un vistazo, y aprende qué hace cada botón de la barra de información y de la barra de herramientas.

Truncar y eliminar tablas

Exportar esquema (IaC)