.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:
- Updaterichtlinie
- Autorisierte Prinzipale: Bei Verwendung des
.create table based-on
Befehls wird der aktuelle Prinzipal den Tabellenadministratoren hinzugefügt.
Berechtigungen
Sie müssen mindestens über Datenbankadministratorberechtigungen verfügen, um diesen Befehl auszuführen.
Syntax
.create
tableName 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.
- Wenn
Beispiel
.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")