Compartilhar via


Comando .alter-merge table

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

O comando .alter-merge table:

  • Protege os dados em colunas existentes
  • Adiciona novas colunas docstringe pastas a uma tabela existente
  • Deve ser executado no contexto de um banco de dados específico que define o escopo do nome da tabela

Permissões

Você deve ter pelo menos permissões de Administrador de Tabela para executar este comando.

Sintaxe

.alter-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 alterada.
columnName, columnType string ✔️ O nome de uma coluna existente ou nova 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.

Observação

Se você tentar alterar um tipo de coluna, o comando falhará. Use o .alter column em vez disso.

Dica

Use .show table [tableName] cslschema para obter o esquema de coluna existente antes de alterá-lo.

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.

Como o comando afeta os dados

  • Os dados existentes não serão modificados ou excluídos
  • Novas colunas serão adicionadas ao final do esquema
  • Os dados em novas colunas são considerados nulos

Exemplos

.alter-merge table MyTable (ColumnX:string, ColumnY:int) 
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")

Use o .alter comando table quando desejar redefinir ainda mais as configurações da tabela. Para obter mais informações, consulte .alter table.