Comando .create table

  • Artigo

Cria uma nova tabela vazia.

O comando deve ser executado no contexto de um banco de dados específico.

Permissões

Você deve ter pelo menos permissões de Usuário de Banco de Dados para executar esse comando.

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
tableName string ✔️ O nome da tabela a ser criada.
columnName, columnType string ✔️ O nome de uma coluna mapeada para o tipo de dados nessa coluna. A lista desses mapeamentos define o esquema da coluna de saída.
propertyName, propertyValue string Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte propriedades com suporte.

Propriedades com suporte

Nome Tipo Descrição
docstring string Texto livre que descreve a entidade a ser adicionada. Essa cadeia de caracteres é apresentada em várias configurações de UX ao lado dos nomes de entidade.
folder string O nome da pasta a ser adicionada à tabela.

Observação

Se uma tabela com o mesmo nome (diferencia maiúsculas de minúsculas) já existir no contexto do banco de dados, o comando retornará ê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

Retorna o esquema da tabela no formato JSON, o mesmo que:

.show table MyLogs schema as json

Observação

Para criar várias tabelas, use o comando para melhorar o .create tables desempenho e reduzir a carga no cluster.