Comando .create table based-on

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Crea una nueva tabla vacía basada en una tabla existente. Este comando debe ejecutarse en el contexto de una base de datos específica.

Nota:

Todas las propiedades de la tabla de origen se copian en la nueva tabla, con las siguientes excepciones:

• Directiva de actualización
• Entidades de seguridad autorizadas: al usar el .create table based-on comando , la entidad de seguridad actual se agrega a los administradores de la tabla.

Permisos

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

Sintaxis

.createtableName based-on otherTable [ifnotexists] [with( propertyName = propertyValue [, ...])]table

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

Parámetros

Nombre	Type	Obligatorio	Descripción
ifnotexists	string		Si se especifica, la tabla solo se creará si aún no existe.
tableName	string	✔️	El objeto de la tabla que se va a crear. El nombre del senestivo de mayúsculas y minúsculas debe ser único en la base de datos.
otherTable	string	✔️	Nombre de una tabla existente que se va a usar como origen para las columnas, docstring y carpeta de la tabla que se va a crear.
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. El valor predeterminado se crea en función de< tableName>.
folder	string	Nombre de la carpeta donde se va a agregar la tabla. El valor predeterminado es la misma carpeta que tableName.

Devoluciones

Este comando devuelve el esquema de la nueva tabla en formato JSON, similar a ejecutar el siguiente comando:

.show table MyLogs schema as json

Nota:

• Si la tabla ya existe:
  • Si ifnotexists se especifica la marca, se omite el comando (no se aplica ningún cambio).
  • Si ifnotexists no se especifica flag, se devuelve un error.

Ejemplo

.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")