Comando .alter-merge table
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
O comando .alter-merge table
:
- Protege os dados em colunas existentes
- Adiciona novas colunas
docstring
e 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-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 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")
Conteúdo relacionado
Use o .alter
comando table quando desejar redefinir ainda mais as configurações da tabela. Para obter mais informações, consulte .alter table.