Compartir a través de


Comando .create table

Se aplica a: ✅Microsoft FabricAzure Data Explorer

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.

Sintaxis

.createtable tableName (columnName:columnType [ ...]) [with (, propertyName = propertyValue [, ...]])

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

Parámetros

Nombre Type Obligatorio 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 Escribir Descripción
docstring string Texto libre que describe la entidad que se va a agregar. Esta cadena se presenta en varias configuraciones de experiencia del 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 (que distingue mayúsculas de 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 rendimiento y reducir la .create tables carga de datos.