Opdracht .create table

Hiermee maakt u een nieuwe lege tabel.

De opdracht moet worden uitgevoerd in de context van een specifieke database.

Machtigingen

U moet ten minste machtigingen voor databasegebruiker hebben om deze opdracht uit te voeren.

Syntax

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

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
tableName	string	✔️	De naam van de tabel die u wilt maken.
columnName, columnType	string	✔️	De naam van een kolom die is toegewezen aan het type gegevens in die kolom. De lijst met deze toewijzingen definieert het uitvoerkolomschema.
propertyName, propertyValue	string		Een door komma's gescheiden lijst met sleutel-waarde-eigenschappenparen. Zie ondersteunde eigenschappen.

Ondersteunde eigenschappen

Naam	Type	Description
docstring	string	Vrije tekst met een beschrijving van de entiteit die moet worden toegevoegd. Deze tekenreeks wordt weergegeven in verschillende UX-instellingen naast de entiteitsnamen.
folder	string	De naam van de map die u aan de tabel wilt toevoegen.

Notitie

Als er al een tabel met dezelfde (hoofdlettergevoelige) naam bestaat in de context van de database, retourneert de opdracht succes zonder de bestaande tabel te wijzigen, zelfs in de volgende scenario's:

• Het opgegeven schema komt niet overeen met het schema van de bestaande tabel
• De folder parameters of docstring worden opgegeven met andere waarden dan de parameters die in de tabel zijn ingesteld

Voorbeeld

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

Uitvoer

Retourneert het schema van de tabel in JSON-indeling, hetzelfde als:

.show table MyLogs schema as json

Notitie

Als u meerdere tabellen wilt maken, gebruikt u de .create tables opdracht voor betere prestaties en een lagere belasting van het cluster.