Administrar tablas

En esta sección, se describe cómo administrar tablas utilizando las instrucciones DROP TABLE y UNDROP TABLE de Amazon QLDB. También se describe cómo etiquetar las tablas mientras las crea. Las cuotas para el número de tablas activas y el total de tablas que puede crear se definen en Cuotas y límites de Amazon QLDB.

Etiquetar tablas al crearlas

nota

El etiquetado de tablas al crearlas solo se admite en los libros mayores en el modo de permisos STANDARD.

Puede etiquetar los recursos de tabla. Para administrar las etiquetas de las tablas existentes, utilice la AWS Management Console o las operaciones TagResource, UntagResource y ListTagsForResource de la API. Para obtener más información, consulte Etiquetado de recursos de Amazon QLDB.

También puede definir etiquetas de tabla mientras crea la tabla mediante la consola de QLDB o especificándolas en una instrucción CREATE TABLE de PartiQL. En el siguiente ejemplo, se crea una tabla llamada Vehicle con la etiqueta environment=production.

CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'production'}`)

Al etiquetar los recursos en el momento de su creación, ya no es necesario ejecutar scripts de etiquetado personalizados después de la creación del recurso. Una vez etiquetada una tabla, puede controlar el acceso a la tabla según esas etiquetas. Por ejemplo, puede conceder acceso total solo a las tablas que tengan una etiqueta específica. Para ver una política de ejemplo JSON, consulte Acceso completo a todas las acciones basadas en las etiquetas de las tablas.

Eliminar tablas

Para eliminar una tabla, use una instrucción DROP TABLE básica. Cuando elimina una tabla en QLDB, simplemente la está desactivando.

Por ejemplo, la siguiente instrucción desactiva la tabla VehicleRegistration.

DROP TABLE VehicleRegistration

Una instrucción DROP TABLE devuelve el identificador asignado por el sistema a la tabla. El estado VehicleRegistration ahora debería ser INACTIVE en la tabla del catálogo del sistema information_schema.user_tables.

SELECT status FROM information_schema.user_tables
WHERE name = 'VehicleRegistration'

Consultar el historial de tablas inactivas

Además del nombre de una tabla, también puede consultar Función de historial de QLDB con un identificador de tabla como primer argumento de entrada. Debe usar el identificador de la tabla para consultar el historial de una tabla inactiva. Una vez desactivada una tabla, ya no podrá consultar su historial con el nombre de la tabla.

En primer lugar, busque el ID de la tabla consultando la tabla del catálogo del sistema. Por ejemplo, la siguiente consulta devuelve el tableId de la tabla VehicleRegistration.

SELECT tableId FROM information_schema.user_tables
WHERE name = 'VehicleRegistration'

A continuación, puede usar este ID para ejecutar la misma consulta de historial desde Consultar el historial de revisiones. A continuación, se muestra un ejemplo en el que se consulta el historial del identificador del documento ADR2Ll1fGsU4Jr4EqTdnQF a partir del identificador de la tabla 5PLf9SXwndd63lPaSIa0O6. El identificador de tabla es un literal de cadena que se debe incluir entre comillas simples.

--replace both the table and document IDs with your values
SELECT * FROM history('5PLf9SXwndd63lPaSIa0O6', `2000T`, `2019-06-05T23:59:59Z`) AS h
WHERE h.metadata.id = 'ADR2Ll1fGsU4Jr4EqTdnQF'

Reactivar tablas

Luego de desactivar una tabla en QLDB, puede utilizar la instrucción UNDROP TABLE para reactivarla.

En primer lugar, busque el identificador de la tabla en information_schema.user_tables. Por ejemplo, la siguiente consulta devuelve el tableId de la tabla VehicleRegistration. El estado debería ser INACTIVE.

SELECT tableId FROM information_schema.user_tables
WHERE name = 'VehicleRegistration'

A continuación, utilice este identificador para reactivar la tabla. A continuación, se muestra un ejemplo que anula la acción de descartar el ID de tabla 5PLf9SXwndd63lPaSIa0O6. En este caso, el identificador de la tabla es un identificador único que se escribe entre comillas dobles.

UNDROP TABLE "5PLf9SXwndd63lPaSIa0O6"

El estado de VehicleRegistration ahora debería ser ACTIVE.

Para obtener información sobre cómo crear, describir y eliminar índices, continúe con Administrar índices.