Comando .create table

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

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 do Banco de Dados para executar este comando.

Sintaxe

.createtable nome_da_(tabela nome_da_:coluna columnType [, ...]) [with (nome_da_=propriedade propertyValue [, ...]])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	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 de coluna de saída.
propertyName, propertyValue	string		Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte as propriedades suportadas.

Propriedades aceitas

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 experiência do usuário ao lado dos nomes das entidades.
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 or 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, igual a:

.show table MyLogs schema as json

Observação

Para criar várias tabelas, use o .create tables comando para obter melhor desempenho e menor carga de dados.