Příkaz .alter-merge table

Příkaz .alter-merge table:

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

Oprávnění

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

Syntax

.alter-mergetableTablename(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 mapované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. Viz podporované vlastnosti.

Poznámka

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

Tip

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

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 uživatelských nastaveních vedle názvů entit.
folder string Název složky, která se má přidat do tabulky.

Jak příkaz ovlivňuje data

  • Stávající data se nebudou upravovat ani odstraňovat.
  • Na konec schématu se přidají nové sloupce.
  • Předpokládá se, že data v nových sloupcích 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")

.alter Příkaz table použijte, pokud chcete nastavení tabulky dále předefinovat. Další informace najdete v tabulce .alter.