.create table command

  • Cikk

Létrehoz egy új üres táblát.

A parancsnak egy adott adatbázis környezetében kell futnia.

Engedélyek

A parancs futtatásához legalább adatbázis-felhasználó engedélyekkel kell rendelkeznie.

Syntax

.createtabletableName(columnName:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

További információ a szintaxis konvenciókról.

Paraméterek

Név Típus Kötelező Leírás
tableName string ✔️ A létrehozandó tábla neve.
columnName, columnType string ✔️ Egy oszlop neve, amely az oszlopban lévő adattípusra van leképezve. A leképezések listája határozza meg a kimeneti oszlop sémáját.
propertyName, propertyValue string Kulcs-érték tulajdonságpárok vesszővel tagolt listája. Lásd a támogatott tulajdonságokat.

Támogatott tulajdonságok

Név Típus Description
docstring string A hozzáadandó entitást leíró szabad szöveg. Ez a sztring az entitásnevek mellett található különböző felhasználói felületi beállításokban jelenik meg.
folder string A táblához hozzáadni kívánt mappa neve.

Megjegyzés

Ha már létezik azonos (kis- és nagybetűket megkülönböztető) nevű tábla az adatbázis környezetében, a parancs a meglévő tábla módosítása nélkül is sikert ad vissza, még a következő esetekben is:

  • A megadott séma nem felel meg a meglévő tábla sémájának
  • A folder vagy docstring paraméterek a táblázatban beállított értékektől eltérő értékekkel vannak megadva

Példa

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

Kimenet

A tábla sémáját JSON formátumban adja vissza, az alábbival megegyező módon:

.show table MyLogs schema as json

Megjegyzés

Több tábla létrehozásához használja a parancsot a .create tables jobb teljesítmény és a fürt terhelésének csökkentése érdekében.