Comando CREATE TABLE en Amazon QLDB

En Amazon QLDB, utilice el comando CREATE TABLE para crear una tabla nueva.

Las tablas tienen nombres simples que no tienen espacios de nombres. QLDB admite 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 Introducción al 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 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 acerca de los permisos para los recursos de QLDB, consulte Cómo funciona Amazon QLDB 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 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.

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 aprender a ejecutar esta instrucción mediante programación con el controlador de QLDB, 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