.create table-Befehl

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

Erstellt eine neue leere Tabelle.

Der Befehl muss im Kontext einer bestimmten Datenbank ausgeführt werden.

Berechtigungen

Sie müssen mindestens über Die Berechtigungen des Datenbankbenutzers verfügen, um diesen Befehl auszuführen.

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
tableName	string	✔️	Der Name der zu erstellenden Tabelle.
columnName, columnType	string	✔️	Der Name einer Spalte, die dem Datentyp in dieser Spalte zugeordnet ist. Die Liste dieser Zuordnungen definiert das Ausgabespaltenschema.
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.
folder	string	Der Name des Ordners, der der Tabelle hinzugefügt werden soll.

Hinweis

Wenn eine Tabelle mit demselben Namen (Groß-/Kleinschreibung) bereits im Kontext der Datenbank vorhanden ist, gibt der Befehl erfolglos zurück, ohne die vorhandene Tabelle zu ändern, auch in den folgenden Szenarien:

• Das angegebene Schema stimmt nicht mit dem Schema der vorhandenen Tabelle überein.
• Die folder Parameter docstring werden mit Werten angegeben, die sich von denen unterscheiden, die in der Tabelle festgelegt sind.

Beispiel

.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 ) 

Output

Gibt das Schema der Tabelle im JSON-Format zurück, identisch mit:

.show table MyLogs schema as json

Hinweis

Verwenden Sie zum Erstellen mehrerer Tabellen den Befehl, um die .create tables Leistung zu verbessern und das Laden von Daten zu verringern.