Comando .create-merge table
Aplica-se a: ✅Microsoft Fabric✅Azure 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-merge
table
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.