CREATETABLEcomando en Amazon QLDB

importante

Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte Migración de un Amazon QLDB Ledger a Amazon Aurora SQL Postgre.

En AmazonQLDB, usa el CREATE TABLE comando para crear una tabla nueva.

Las tablas tienen nombres simples que no tienen espacios de nombres. QLDBadmite contenido abierto y no aplica el esquema, por lo que no se definen atributos o tipos de datos al crear tablas.

nota

Para obtener información sobre cómo controlar el acceso para ejecutar este comando PartiQL en el libro mayor, consulte Cómo empezar con el modo de permisos estándar en Amazon QLDB.

Sintaxis

CREATE TABLE table_name [ WITH (aws_tags = `{'key': 'value'}`) ]

Parámetros

table_name

Nombre de la tabla única que se va a crear. No debe existir ya una tabla activa con el mismo nombre. Estas son las restricciones de denominación:

• Las etiquetas solo deben contener de 1 a 128 caracteres alfanuméricos o guiones bajos.

• Debe tener una letra o un guion bajo para el primer carácter.

• Puede contener cualquier combinación de caracteres alfanuméricos y guiones bajos para el resto de los caracteres.

• Distingue entre mayúsculas y minúsculas.

• No debe ser una palabra reservada para QLDB PartiQL.

'key': 'value'

(Opcional) Las etiquetas que se deben adjuntar al recurso de tabla durante la creación. Cada etiqueta se define como un par clave-valor, donde la clave y el valor se indican cada uno entre comillas simples. Cada par clave-valor se define dentro de una estructura de Amazon Ion que se indica con acentos graves.

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

Valor devuelto

tableId: el identificador único de la tabla que creó.

Etiquetado de tablas al crearlas

nota

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

También puede etiquetar los recursos de la tabla especificando las etiquetas en una instrucción CREATE TABLE. Para obtener más información acerca de las etiquetas, consulte Etiquetado de los recursos de Amazon QLDB. En el siguiente ejemplo, se crea una tabla llamada Vehicle con la etiqueta environment=production.

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

Para etiquetar las tablas al crearlas, es necesario acceder a las acciones qldb:PartiQLCreateTable y qldb:TagResource. Para obtener más información sobre los permisos de los QLDB recursos, consulteCómo QLDB trabaja Amazon con IAM.

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 en función de esas etiquetas. Por ejemplo, puede conceder acceso total solo a las tablas que tengan una etiqueta específica. Para ver un ejemplo JSON de política, consulteAcceso completo a todas las acciones basadas en las etiquetas de las tablas.

Ejemplos

CREATE TABLE VehicleRegistration

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

CREATE TABLE Vehicle WITH (aws_tags = `{'key1': 'value1', 'key2': 'value2'}`)

Ejecución mediante programación con el controlador

Para obtener información sobre cómo ejecutar esta sentencia mediante programación mediante el QLDB controlador, consulte los siguientes tutoriales en Introducción al controlador:

• Java: Tutorial de inicio rápido | Referencia de libro de recetas

• .NET: Tutorial de inicio rápido | Referencia de libro de recetas

• Go: Tutorial de inicio rápido | Referencia de libro de recetas

• Node.js: Tutorial de inicio rápido | Referencia de libro de recetas

• Python: Tutorial de inicio rápido | Referencia de libro de recetas