Kommandot .create table

  • Artikel

Skapar en ny tom tabell.

Kommandot måste köras i kontexten för en specifik databas.

Behörigheter

Du måste minst ha behörighet som databasanvändare för att kunna köra det här kommandot.

Syntax

.createtableTablename(Columnname:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
Tablename string ✔️ Namnet på den tabell som ska skapas.
columnName, columnType string ✔️ Namnet på en kolumn som är mappad till datatypen i den kolumnen. Listan över dessa mappningar definierar utdatakolumnschemat.
propertyName, propertyValue string En kommaavgränsad lista över nyckel/värde-egenskapspar. Se egenskaper som stöds.

Egenskaper som stöds

Namn Typ Description
docstring string Fritext som beskriver entiteten som ska läggas till. Den här strängen visas i olika UX-inställningar bredvid entitetsnamnen.
folder string Namnet på mappen som ska läggas till i tabellen.

Anteckning

Om det redan finns en tabell med samma (skiftlägeskänsliga) namn i databasens kontext returnerar kommandot framgång utan att ändra den befintliga tabellen, även i följande scenarier:

  • Det angivna schemat matchar inte schemat för den befintliga tabellen
  • Parametrarna folder eller docstring anges med värden som skiljer sig från de som anges i tabellen

Exempel

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

Resultat

Returnerar tabellens schema i JSON-format, samma som:

.show table MyLogs schema as json

Anteckning

Om du vill skapa flera tabeller använder du .create tables kommandot för bättre prestanda och lägre belastning på klustret.