Compartilhar via


Comando .create-merge table

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

Cria uma nova tabela ou estende uma tabela existente.

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

Permissões

Esse comando requer permissões de Usuário de Banco de Dados e permissões de Administrador de Tabela para estender as tabelas existentes.

Sintaxe

.create-mergetable 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 ou estendida.
columnName, columnType string ✔️ O nome de uma coluna existente ou nova mapeada para o tipo de dados nessa coluna. A lista de 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 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.

Devoluções

Se a tabela não existir, funciona exatamente como .create table comando.

Se a tabela T existir e você enviar um .create-merge table T (<columns specification>) comando, então:

  • Qualquer coluna na <especificação> de colunas que não existia anteriormente em T será adicionada ao final do esquema de T.
  • Qualquer coluna em T que não esteja na <especificação> de colunas não será removida de T.
  • Qualquer especificação> de coluna em <colunas que exista em T, mas com um tipo de dados diferente, fará com que o comando falhe.