Freigeben über


.create table based-on-Befehl

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer

Erstellt eine neue leere Tabelle basierend auf einer vorhandenen Tabelle. Dieser Befehl muss im Kontext einer bestimmten Datenbank ausgeführt werden.

Hinweis

Alle Eigenschaften der Quelltabelle werden mit den folgenden Ausnahmen in die neue Tabelle kopiert:

Berechtigungen

Sie müssen mindestens über Datenbankadministratorberechtigungen verfügen, um diesen Befehl auszuführen.

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
ifnotexists string Wenn angegeben, wird die Tabelle nur erstellt, wenn sie noch nicht vorhanden ist.
tableName string ✔️ Der Name der zu erstellenden Tabelle. Der Name der Groß-/Kleinschreibung muss in der Datenbank eindeutig sein.
otherTable string ✔️ Der Name einer vorhandenen Tabelle, die als Quelle für die zu erstellenden Spalten, Dokumente und Ordner der Tabelle verwendet werden soll.
propertyName, propertyValue string Eine durch Trennzeichen getrennte Liste von Schlüsselwert-Eigenschaftspaaren. Siehe unterstützte Eigenschaften.

Unterstützte Eigenschaften

Name Typ Beschreibung
docstring string Freier Text, der die hinzuzufügende Entität beschreibt. Diese Zeichenfolge wird in verschiedenen UX-Einstellungen neben den Entitätsnamen angezeigt. Der Standardwert wird basierend auf <"tableName>" erstellt.
folder string Der Name des Ordners, in dem die Tabelle hinzugefügt werden soll. Der Standardwert ist derselbe Ordner wie "tableName".

Gibt zurück

Dieser Befehl gibt das Schema der neuen Tabelle im JSON-Format zurück, ähnlich wie beim Ausführen des folgenden Befehls:

.show table MyLogs schema as json

Hinweis

  • Wenn die Tabelle bereits vorhanden ist:
    • Wenn ifnotexists das Flag angegeben ist, wird der Befehl ignoriert (keine Änderung angewendet).
    • Wenn ifnotexists das Flag NICHT angegeben ist, wird ein Fehler zurückgegeben.

Beispiel

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