Comando .create-merge tables

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Permite crear y ampliar los esquemas de las tablas existentes en una sola operación masiva, en el contexto de una base de datos específica.

Permisos

Este comando requiere permisos de usuario de base de datos y permisos de administrador de tablas para ampliar las tablas existentes.

Sintaxis

.create-mergetables tableName1 (columnName:columnType [ ...]) [, , tableName2( columnName:columnType [, ...]) ... ] [with( propertyName = propertyValue [, ...]])

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

Parámetros

Nombre	Type	Obligatorio	Descripción
tableName	string	✔️	Nombre de la tabla que se va a crear o extender.
columnName, columnType	string	✔️	Nombre de una columna existente o nueva asignada al tipo de datos de esa columna. La lista de 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.

Devoluciones

• Se crearán tablas especificadas que no existen.
• Las tablas especificadas que ya existen tendrán sus esquemas extendidos.
  • Las columnas inexistentes se agregan al final del esquema de la tabla existente.
  • Las columnas existentes que no se especifican en el comando no se quitarán del esquema de la tabla existente.
  • Las columnas existentes que se especifican con un tipo de datos en el comando que es diferente de la de los esquemas de la tabla existente provocan un error. No se crea ninguna tabla.

Ejemplo

.create-merge tables 
  MyLogs (Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32),
  MyUsers (UserId:string, Name:string)

Salida

tableName	DatabaseName	Carpeta	DocString
MyLogs	TopComparison
MyUsers	TopComparison