Polecenie alter table

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 do Administracja tabeli.

Składnia

.altertableTablename(Columnname:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa	Typ	Wymagane	Opis
Tablename	string	✔️	Nazwa tabeli do zmiany.
columnName, columnType	string	✔️	Nazwa istniejącej lub nowej kolumny mapowana 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.

Porada

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

Obsługiwane właściwości

Nazwa	Typ	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 do dodania 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
• Zakłada 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. Zamiast tego użyj polecenia cmdlet .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. Uważaj, aby nie usuwać przypadkowo żądanych kolumn, 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")

Zawartość pokrewna

Użyj .alter-merge polecenia , jeśli chcesz zachować ustawienia tabeli i zastąpić tylko niektóre kolumny lub je rozwinąć. Aby uzyskać więcej informacji, zobacz tabelę alter-merge.