Comando .create-merge tables

Artigo
11/23/2024

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

Permite criar e estender os esquemas de tabelas existentes em uma única operação em massa, 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-mergetables nome_da_tabela1( nome_da_:coluna tipo_da_coluna [, ...]) [ , nome_da_(tabela2 nome_da_:coluna tipo_da_coluna [, ...)]) [with (nome_da_propriedade = ,

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

Tabelas especificadas que não existem serão criadas.
As tabelas especificadas que já existem terão seus esquemas estendidos.
- Colunas inexistentes são adicionadas no final do esquema da tabela existente.
- As colunas existentes que não são especificadas no comando não serão removidas do esquema da tabela existente.
- As colunas existentes especificadas com um tipo de dados no comando diferente daquele nos esquemas da tabela existente levam a uma falha. Nenhuma tabela é criada.

Exemplo

.create-merge tables 
  MyLogs (Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32),
  MyUsers (UserId:string, Name:string)

Saída

tableName	DatabaseName	Pasta	DocString
Meus Logs	Comparação superior
Meus Usuários	Comparação superior

Compartilhar via