Compartilhar via


Comando .drop column

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

Remove uma coluna de uma tabela.

Para descartar várias colunas de uma tabela, consulte descartar várias colunas da tabela.

Observação

Esse comando não exclui fisicamente os dados e não reduz o custo de armazenamento dos dados que já foram assimilados.

Aviso

Este comando é irreversível. Todos os dados na coluna removida não poderão mais ser consultados. Comandos futuros para adicionar essa coluna de volta não poderão restaurar os dados.

Permissões

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

Sintaxe

.dropcolumn TableName.ColumnName []ifexists

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
TableName string ✔️ O nome da tabela que contém a coluna a ser descartada.
ColumnName string ✔️ O nome da coluna a ser descartada.
ifexists string Se especificado, o comando não falhará em uma coluna inexistente.

Exemplo

O comando a seguir removerá a Value coluna da Test tabela, se essa coluna existir. Se a coluna não existir, o comando não falhará.

.drop column Test.Value ifexists

Descartar várias colunas da tabela

Remove várias colunas de uma tabela.

Observação

Esse comando não exclui fisicamente os dados e não reduz o custo de armazenamento dos dados que já foram assimilados.

Aviso

Este comando é irreversível. Todos os dados na coluna removida não poderão mais ser consultados. Comandos futuros para adicionar essas colunas de volta não poderão restaurar os dados.

Sintaxe

.droptable TableName columns ( ColumnName [, ...])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
TableName string ✔️ O nome da tabela que contém a coluna a ser descartada.
ColumnName string ✔️ O nome da coluna a ser descartada.

Exemplo

O comando a seguir removerá as Value colunas e Item da Test tabela.

.drop table Test columns ( Value, Item )