Příkaz .create table

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Vytvoří novou prázdnou tabulku.

Příkaz musí běžet v kontextu konkrétní databáze.

Oprávnění

Ke spuštění tohoto příkazu musíte mít alespoň oprávnění uživatele databáze.

Syntaxe

.createtable 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á vytvořit.
columnName, columnType	string	✔️	Název 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.

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.

Poznámka:

Pokud tabulka se stejným názvem (rozlišující malá a velká písmena) již v kontextu databáze existuje, příkaz vrátí úspěch beze změny existující tabulky, a to i v následujících scénářích:

• Zadané schéma neodpovídá schématu existující tabulky.
• Parametry folder nebo docstring parametry se zadají s hodnotami odlišnými od hodnot nastavených v tabulce.

Příklad

.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 ) 

Výstup

Vrátí schéma tabulky ve formátu JSON stejné jako:

.show table MyLogs schema as json

Poznámka:

Pokud chcete vytvořit více tabulek, použijte .create tables příkaz pro lepší výkon a nižší zatížení dat.