.create-merge tables -Befehl

Artikel
11/23/2024

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

Ermöglicht ihnen das Erstellen und Erweitern der Schemas vorhandener Tabellen in einem einzelnen Massenvorgang im Kontext einer bestimmten Datenbank.

Berechtigungen

Dieser Befehl erfordert Datenbankbenutzerberechtigungen und Tabellenadministratorberechtigungen zum Erweitern vorhandener Tabellen.

Syntax

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

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
tableName	`string`	✔️	Der Name der zu erstellenden oder zu erweiternden Tabelle.
columnName, columnType	`string`	✔️	Der Name einer vorhandenen oder neuen Spalte, die dem Datentyp in dieser Spalte zugeordnet ist. Die Liste der 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.

Gibt zurück

Angegebene Tabellen, die nicht vorhanden sind, werden erstellt.
Angegebene Tabellen, die bereits vorhanden sind, werden ihre Schemas erweitert.
- Nicht vorhandene Spalten werden am Ende des Schemas der vorhandenen Tabelle hinzugefügt.
- Vorhandene Spalten, die nicht im Befehl angegeben sind, werden nicht aus dem Schema der vorhandenen Tabelle entfernt.
- Vorhandene Spalten, die mit einem Datentyp im Befehl angegeben werden, der sich von dem in den Schemas der vorhandenen Tabelle unterscheidet, führen zu einem Fehler. Es werden keine Tabellen erstellt.

Beispiel

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

Output

tableName	DatabaseName	Ordner	DocString
MyLogs	TopComparison
MyUsers	TopComparison

Freigeben über