Comando .create table

Cria uma nova tabela vazia.

O comando tem de ser executado no contexto de uma base de dados específica.

Permissões

Tem de ter, pelo menos, permissões de Utilizador da Base de Dados para executar este comando.

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Necessário	Descrição
tableName	string	✔️	O nome da tabela a criar.
columnName, columnType	string	✔️	O nome de uma coluna mapeada para o tipo de dados nessa coluna. A lista destes mapeamentos define o esquema da coluna de saída.
propertyName, propertyValue	string		Uma lista separada por vírgulas de pares de propriedades chave-valor. Veja as propriedades suportadas.

Propriedades suportadas

Nome	Tipo	Description
docstring	string	Texto livre que descreve a entidade a adicionar. Esta cadeia é apresentada em várias definições de UX junto aos nomes das entidades.
folder	string	O nome da pasta a adicionar à tabela.

Nota

Se já existir uma tabela com o mesmo nome (sensível às maiúsculas e minúsculas) no contexto da base de dados, o comando devolve êxito sem alterar a tabela existente, mesmo nos seguintes cenários:

• O esquema especificado não corresponde ao esquema da tabela existente
• Os folder parâmetros ou docstring são especificados com valores diferentes dos definidos na tabela

Exemplo

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

Saída

Devolve o esquema da tabela no formato JSON, da mesma forma que:

.show table MyLogs schema as json

Nota

Para criar várias tabelas, utilize o .create tables comando para um melhor desempenho e uma menor carga no cluster.