CREATE TABLE - Amazon Quantum Ledger Database (Amazon QLDB)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CREATE TABLE

UsarCREATE TABLEpara crear una nueva tabla en su libro de contabilidad de Amazon QLDB.

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

nota

Para obtener información sobre cómo controlar el acceso para ejecutar este comando de PartiQL en un libro mayor, consulteIntroducció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 único de la tabla que se va a crear. No debe existir ya una tabla activa con el mismo nombre. Las siguientes son las restricciones de denominación:

  • Solo debe contener entre 1 y 128 caracteres alfanuméricos o guiones bajos.

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

  • Puede tener cualquier combinación de caracteres alfanuméricos y guiones bajos para los caracteres restantes.

  • Distingue entre mayúsculas y minúsculas.

  • No debe ser un QLDB PartiQLPalabra reservada.

'clave':'value'

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

El etiquetado de tablas al crearlas se admite actualmente para los libros mayores de laSTANDARDsolo en el modo de permisos.

Valor devuelto

tableId: el ID único de la tabla que ha creado.

Etiquetar tablas durante la creación

nota

El etiquetado de tablas al crearlas se admite actualmente para los libros mayores de laSTANDARDsolo en el modo de permisos.

Si lo desea, puede etiquetar los recursos de la tabla especificando etiquetas en unCREATE TABLEstatement. 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 llamadaVehiclecon la etiquetaenvironment=production.

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

El etiquetado de tablas en el momento de la creación requiere acceso tanto aqldb:PartiQLCreateTableyqldb:TagResourceacciones. Para obtener más información sobre los permisos para los recursos de QLDB, consulteCó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. Después de etiquetar una tabla, puede controlar el acceso a la tabla en función de esas etiquetas. Por ejemplo, puede dar acceso completo solo a tablas que tienen una etiqueta específica. Para ver una política JSON, consulteAcceso completo a todas las acciones basadas en etiquetas de tabla.

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 mediante el controlador

Para obtener información sobre cómo ejecutar esta instrucción mediante programación mediante el controlador QLDB, consulte los siguientes tutoriales enIntroducción al conductor: