Příkaz .alter table

Příkaz .alter table:

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

Upozorňující

.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ň oprávnění správce tabulky.

Syntaxe

.altertable tableName (columnType: [, ...]) [with (propertyName = propertyValue [, ...]])

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

Parametry

Název	Type	Pož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		Čárkami oddělený seznam párů vlastností klíč-hodnota. Viz podporované vlastnosti.

Upozorňující

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

Tip

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

Podporované vlastnosti

Name	Typ	Popis
docstring	string	Volný text popisující entitu, která se má přidat. Tento řetězec se zobrazí 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, budou odstraněna.
• Na konec schématu se přidají nové sloupce.
• U dat v nových sloupcích se předpokládá, že mají hodnotu null.
• Tabulka bude mít stejné sloupce ve stejném pořadí jako zadaná tabulka.

Poznámka:

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

Upozorňující

• Příjem dat, který ignoruje pořadí sloupců a dochází paralelně s .alter table riziky 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 zastavit 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 přidané 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 , pokud chcete zachovat nastavení tabulky a přepsat nebo rozbalit pouze určité sloupce. Další informace naleznete v tématu .alter-merge table.