Sdílet prostřednictvím


Příkaz .alter table

Platí pro: ✅Microsoft FabricAzure Data Explorer

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")