Příkaz .create table

Vytvoří novou prázdnou tabulku.

Příkaz se musí spustit 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 .

Syntax

.createtableTablename(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á 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 Seznam párů vlastností klíč-hodnota oddělený čárkami. Projděte si podporované vlastnosti.

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 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í se malá a velká písmena) již v kontextu databáze existuje, příkaz vrátí úspěch beze změny stávají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 se zadají s hodnotami, které se liší 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 , který zlepší výkon a sníží zatížení clusteru.