Polecenie alter-merge table

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Polecenie .alter-merge table:

• Zabezpiecza dane w istniejących kolumnach
• Dodaje nowe kolumny, docstringi folder do istniejącej tabeli
• Musi działać w kontekście określonej bazy danych, która określa zakres nazwy tabeli

Uprawnienia

Aby uruchomić to polecenie, musisz mieć co najmniej uprawnienia administratora tabeli.

Składnia

.alter-mergetableName columnName: (columnType [, ...]) [with( propertyName = propertyValue [, ...]])table

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko	Type	Wymagania	opis
tableName	string	✔️	Nazwa tabeli do zmiany.
columnName, columnType	string	✔️	Nazwa istniejącej lub nowej kolumny zamapowana na typ danych w tej kolumnie. Lista tych mapowań definiuje schemat kolumn wyjściowych.
propertyName, propertyValue	string		Rozdzielona przecinkami lista par właściwości klucz-wartość. Zobacz obsługiwane właściwości.

Uwaga

Jeśli spróbujesz zmienić typ kolumny, polecenie zakończy się niepowodzeniem. Użycie w zamian parametru .alter column.

Napiwek

Użyj polecenia .show table [tableName] cslschema , aby uzyskać istniejący schemat kolumny przed jego zmianą.

Obsługiwane właściwości

Nazwisko	Pisz	Opis
docstring	string	Dowolny tekst opisujący jednostkę do dodania. Ten ciąg jest wyświetlany w różnych ustawieniach środowiska użytkownika obok nazw jednostek.
folder	string	Nazwa folderu, który ma zostać dodany do tabeli.

Jak polecenie wpływa na dane

• Istniejące dane nie zostaną zmodyfikowane ani usunięte
• Nowe kolumny zostaną dodane na końcu schematu
• Przyjmuje się, że dane w nowych kolumnach mają wartość null

Przykłady

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

Powiązana zawartość

.alter Użyj polecenia tabeli, jeśli chcesz ponownie zdefiniować ustawienia tabeli. Aby uzyskać więcej informacji, zobacz .alter table.