Comando .create table

  • Artículo

Crea una nueva tabla vacía.

El comando debe ejecutarse en el contexto de una base de datos específica.

Permisos

Debe tener al menos permisos de usuario de base de datos para ejecutar este comando.

Syntax

.createtableTablename(Columnname:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Tipo Requerido Descripción
tableName string ✔️ El objeto de la tabla que se va a crear.
columnName, columnType string ✔️ Nombre de una columna asignada al tipo de datos de esa columna. La lista de estas asignaciones define el esquema de columna de salida.
propertyName, propertyValue string Lista separada por comas de pares de propiedades clave-valor. Consulte las propiedades admitidas.

Propiedades admitidas

Nombre Tipo Descripción
docstring string Texto libre que describe la entidad que se va a agregar. Esta cadena se presenta en varias configuraciones de experiencia de usuario junto a los nombres de entidad.
folder string Nombre de la carpeta que se va a agregar a la tabla.

Nota

Si ya existe una tabla con el mismo nombre (con distinción entre mayúsculas y minúsculas) en el contexto de la base de datos, el comando devuelve correctamente sin cambiar la tabla existente, incluso en los escenarios siguientes:

  • El esquema especificado no coincide con el esquema de la tabla existente.
  • Los folder parámetros o docstring se especifican con valores diferentes de los establecidos en la tabla.

Ejemplo

.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 )

Salida

Devuelve el esquema de la tabla en formato JSON, igual que:

.show table MyLogs schema as json

Nota

Para crear varias tablas, use el comando para mejorar el .create tables rendimiento y reducir la carga en el clúster.