.create-merge table-Befehl
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer
Erstellt eine neue Tabelle oder erweitert eine vorhandene Tabelle.
Der Befehl muss im Kontext einer bestimmten Datenbank ausgeführt werden.
Berechtigungen
Dieser Befehl erfordert Datenbankbenutzerberechtigungen und Tabellenadministratorberechtigungen zum Erweitern vorhandener Tabellen.
Syntax
.create-mergetable tableName columnName:columnType [, ...]) [ propertyName= (propertyValue [, (with...]])
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
Wenn die Tabelle nicht vorhanden ist, funktioniert sie genau als .create table Befehl.
Wenn Tabelle T vorhanden ist und Sie einen .create-merge table T (<columns specification>) Befehl senden, dann:
- Alle Spaltenspezifikationen<>, die zuvor in T nicht vorhanden waren, werden am Ende des T-Schemas hinzugefügt.
- Jede Spalte in T, die nicht in <der Spaltenspezifikation> enthalten ist, wird nicht aus T entfernt.
- Jede Spalte in <Spaltenspezifikation> , die in T vorhanden ist, aber mit einem anderen Datentyp führt dazu, dass der Befehl fehlschlägt.