.alter table-Befehl

  • Artikel

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

Mit dem Befehl .alter table:

  • Sichert Daten in "beibehaltenen" Spalten
  • Neuanordnen von Tabellenspalten
  • Legt ein neues Spaltenschema und docstringeinen neuen Ordner auf eine vorhandene Tabelle fest, überschreibt das vorhandene Spaltenschema, docstringund ordner
  • Muss im Kontext einer bestimmten Datenbank ausgeführt werden, die den Tabellennamen eingrenzt

Warnung

Die Falsche Verwendung des .alter Befehls kann zu Datenverlust führen.

Berechtigungen

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

Syntax

.altertable 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.

Warnung

Vorhandene Spalten, die nicht im Befehl angegeben sind, werden gelöscht. Dies kann zu unerwartetem Datenverlust führen.

Tipp

Dient .show table [tableName] cslschema zum Abrufen des vorhandenen Tabellenschemas, 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 in Spalten, die im Befehl aufgelistet sind, werden nicht geändert.
  • Vorhandene Daten in Spalten, die nicht im Befehl aufgeführt sind, werden gelöscht.
  • Neue Spalten werden am Ende des Schemas hinzugefügt.
  • Daten in neuen Spalten werden als NULL angenommen.
  • Die Tabelle hat die gleichen Spalten in derselben Reihenfolge wie angegeben.

Hinweis

Wenn Sie versuchen, einen Spaltentyp zu ändern, schlägt der Befehl fehl. Verwenden Sie stattdessen .alter column.

Warnung

  • Datenaufnahme, die die Reihenfolge der Spalten ignoriert und parallel mit .alter table risiken beim Aufnehmen von Daten in die falschen Spalten auftritt. Um dies zu verhindern, stellen Sie sicher, dass bei der Aufnahme ein Zuordnungsobjekt verwendet wird oder die Aufnahme beendet wird, während der .alter table Befehl ausgeführt wird.
  • Datenaufnahme kann das Spaltenschema einer Tabelle ändern. Achten Sie darauf, die gewünschten Spalten, die während der Aufnahme hinzugefügt wurden, versehentlich zu entfernen.

Beispiele

.alter table MyTable (ColumnX:string, ColumnY:int) 
.alter table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")

Zugehöriger Inhalt