Příkaz .alter-merge table

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Příkaz .alter-merge table:

• Zabezpečuje data ve stávajících sloupcích.
• Přidá do existující tabulky nové sloupce docstringa složku.
• Musí běžet v kontextu konkrétní databáze, která oboruje název tabulky.

Oprávnění

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

Syntaxe

.alter-mergetable 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.

Poznámka:

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

Tip

Slouží .show table [tableName] cslschema k získání schématu existujícího sloupce před jeho změnou.

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 nebudou změněna ani 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.

Příklady

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

Související obsah

.alter Příkaz table použijte, pokud chcete nastavení tabulky ještě předefinovat. Další informace naleznete v souboru .alter table.