Příkaz .alter table

Příkaz .alter table:

• Zabezpečí data v "zachovaných" sloupcích.
• Změní pořadí sloupců tabulky.
• Nastaví nové schéma sloupců a docstringsložku na existující tabulku a přepíše existující schéma docstringsloupců a složku.
• Musí běžet v kontextu konkrétní databáze, která definuje název tabulky.

Upozornění

.alter Nesprávné použití příkazu může vést ke ztrátě dat.

Oprávnění

Ke spuštění tohoto příkazu musíte mít alespoň Správa oprávnění.

Syntax

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

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Typ	Vyžadováno	Popis
Tablename	string	✔️	Název tabulky, která se má změnit.
columnName, columnType	string	✔️	Název existujícího nebo nového sloupce namapovaného na typ dat v daném sloupci. Seznam těchto mapování definuje schéma výstupního sloupce.
propertyName, propertyValue	string		Seznam párů vlastností klíč-hodnota oddělený čárkami. Projděte si podporované vlastnosti.

Upozornění

Existující sloupce, které nejsou v příkazu zadané, budou vyřazeny. To může vést k neočekávané ztrátě dat.

Tip

Použijte .show table [tableName] cslschema k získání existujícího schématu tabulky, než ho změníte.

Podporované vlastnosti

Název	Typ	Description
docstring	string	Volný text popisující entitu, která se má přidat. Tento řetězec se zobrazuje v různých nastaveních uživatelského prostředí vedle názvů entit.
folder	string	Název složky, která se má přidat do tabulky.

Vliv příkazu na data

• Existující data ve sloupcích uvedených v příkazu se nezmění.
• Existující data ve sloupcích, která nejsou uvedená v příkazu , se odstraní.
• Na konec schématu se přidají nové sloupce.
• Předpokládá se, že data v nových sloupcích mají hodnotu null.
• Tabulka bude mít stejné sloupce ve stejném pořadí, v jakém jsou zadané.

Poznámka

Pokud se pokusíte změnit typ sloupce, příkaz se nezdaří. Místo toho použijte .alter column.

Upozornění

• Příjem dat, který ignoruje pořadí sloupců a probíhá paralelně s .alter table rizikem ingestování dat do nesprávných sloupců. Chcete-li tomu zabránit, ujistěte se, že příjem dat používá objekt mapování nebo zastaví příjem dat při spuštění .alter table příkazu.
• Příjem dat může změnit schéma sloupců tabulky. Dávejte pozor, abyste omylem neodebrali požadované sloupce, které byly přidány během příjmu dat.

Příklady

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

Související obsah

Použijte .alter-merge , když chcete zachovat nastavení tabulky a přepsat nebo rozbalit jenom určité sloupce. Další informace najdete v tématu .alter-merge table.