Udostępnij za pośrednictwem

Polecenie alter table

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Polecenie .alter table:

  • Zabezpiecza dane w kolumnach "zachowanych"
  • Zmienia kolejność kolumn tabeli
  • Ustawia nowy schemat kolumny, docstringi folder na istniejącą tabelę, zastępując istniejący schemat kolumny, docstringi folder
  • Musi działać w kontekście określonej bazy danych, która określa zakres nazwy tabeli

Ostrzeżenie

.alter Użycie polecenia niepoprawnie może prowadzić do utraty danych.

Uprawnienia

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

Składnia

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

Ostrzeżenie

Istniejące kolumny, które nie są określone w poleceniu, zostaną porzucone. Może to prowadzić do nieoczekiwanej utraty danych.

Napiwek

Użyj polecenia .show table [tableName] cslschema , aby uzyskać istniejący schemat tabeli 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 w kolumnach wymienionych w poleceniu nie zostaną zmodyfikowane
  • Istniejące dane w kolumnach, które nie są wymienione w poleceniu, zostaną usunięte
  • Nowe kolumny zostaną dodane na końcu schematu
  • Przyjmuje się, że dane w nowych kolumnach mają wartość null
  • Tabela będzie zawierać te same kolumny w tej samej kolejności, co określona

Uwaga

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

Ostrzeżenie

  • Pozyskiwanie danych, które ignoruje kolejność kolumn i występuje równolegle z .alter table ryzykiem pozyskiwania danych do nieprawidłowych kolumn. Aby temu zapobiec, upewnij się, że pozyskiwanie używa obiektu mapowania lub zatrzymaj pozyskiwanie podczas uruchamiania .alter table polecenia.
  • Pozyskiwanie danych może modyfikować schemat kolumn tabeli. Należy zachować ostrożność, aby przypadkowo usunąć żądane kolumny, które zostały dodane podczas pozyskiwania.

Przykłady

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

Powiązana zawartość