Partilhar via


Comando .create table based-on

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

Cria uma nova tabela vazia com base em uma tabela existente. Esse comando deve ser executado no contexto de um banco de dados específico.

Observação

Todas as propriedades da tabela de origem são copiadas para a nova tabela, com as seguintes exceções:

Permissões

Você deve ter pelo menos permissões de administrador de banco de dados para executar esse comando.

Sintaxe

.createtable nome_da_based-on tabela otherTable [ifnotexists] [with (nome_da_=propriedade propertyValue [, ...]])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
ifnotexists string Se especificada, a tabela só será criada se ainda não existir.
tableName string ✔️ O nome da tabela a ser criada. O nome case-senestive deve ser exclusivo no banco de dados.
otherTable string ✔️ O nome de uma tabela existente a ser usada como origem para as colunas, docstring e pasta da tabela que está sendo criada.
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. O valor padrão é Created com base em <tableName>.
folder string O nome da pasta onde adicionar a tabela. O padrão é a mesma pasta que tableName.

Devoluções

Esse comando retorna o esquema da nova tabela no formato JSON, semelhante à execução do seguinte comando:

.show table MyLogs schema as json

Observação

  • Se a tabela já existir:
    • Se ifnotexists flag for especificado, o comando será ignorado (nenhuma alteração aplicada).
    • Se ifnotexists o sinalizador NÃO for especificado, um erro será retornado.

Exemplo

.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")