.alter-merge table-Befehl
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer
Mit dem Befehl .alter-merge table:
- Sichert Daten in vorhandenen Spalten
- Fügt einer vorhandenen Tabelle neue Spalten und Ordner hinzu.
docstring - Muss im Kontext einer bestimmten Datenbank ausgeführt werden, die den Tabellennamen eingrenzt
Berechtigungen
Sie müssen mindestens über Die Berechtigungen des Tabellenadministrators verfügen, um diesen Befehl auszuführen.
Syntax
.alter-mergetable tableName columnName:columnType [, ...]) [ propertyName= (propertyValue [, (with...]])
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| tableName | string |
✔️ | Der Name der zu ändernden Tabelle. |
| columnName, columnType | string |
✔️ | Der Name einer vorhandenen oder neuen 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. |
Hinweis
Wenn Sie versuchen, einen Spaltentyp zu ändern, schlägt der Befehl fehl. Verwenden Sie stattdessen .alter column.
Tipp
Dient .show table [tableName] cslschema zum Abrufen des vorhandenen Spaltenschemas, bevor Sie es ändern.
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. |
Auswirkungen des Befehls auf die Daten
- Vorhandene Daten werden nicht geändert oder gelöscht.
- Neue Spalten werden am Ende des Schemas hinzugefügt.
- Daten in neuen Spalten werden als NULL angenommen.
Beispiele
.alter-merge table MyTable (ColumnX:string, ColumnY:int)
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")
Zugehöriger Inhalt
Verwenden Sie den .alter Tabellenbefehl, wenn Sie die Tabelleneinstellungen weiter neu definieren möchten. Weitere Informationen finden Sie in der Tabelle ".alter".