Comando .alter table

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

O comando .alter table:

• Protege os dados em colunas "preservadas"
• Reordena as colunas da tabela
• Define um novo esquema de coluna, docstring, e pasta para uma tabela existente, substituindo o esquema de coluna, docstring, e pasta existentes
• Deve ser executado no contexto de um banco de dados específico que define o escopo do nome da tabela

Aviso

Usar o .alter comando incorretamente pode levar à perda de dados.

Permissões

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

Sintaxe

.altertable 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.

Aviso

As colunas existentes que não são especificadas no comando serão descartadas. Isso pode levar à perda inesperada de dados.

Dica

Use .show table [tableName] cslschema para obter o esquema de tabela 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 nas colunas listadas no comando não serão modificados
• Os dados existentes em colunas não listadas no comando serão excluídos
• Novas colunas serão adicionadas ao final do esquema
• Os dados em novas colunas são considerados nulos
• A tabela terá as mesmas colunas, na mesma ordem, conforme especificado

Observação

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

Aviso

• A ingestão de dados que desconsidera a ordem das colunas e ocorre em paralelo com .alter table os riscos de ingestão de dados nas colunas erradas. Para evitar isso, certifique-se de que a assimilação use um objeto de mapeamento ou interrompa a assimilação durante a execução do .alter table comando.
• A assimilação de dados pode modificar o esquema de coluna de uma tabela. Tenha cuidado para não remover acidentalmente as colunas desejadas que foram adicionadas durante a ingestão.

Exemplos

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

Conteúdo relacionado

• Use .alter-merge quando quiser manter as configurações da tabela e substituir ou expandir apenas determinadas colunas. Para obter mais informações, consulte .alter-merge table.
• Para alterar a política de retenção de tabela, consulte .alter retenção de política de tabela.
• Para alterar a política de cache de tabela, consulte .alter cache de política de tabela.
• Para alterar a política de atualização de tabela, consulte .alter table policy update.
• Para alterar a política de mesclagem de tabelas, consulte .alter mesclagem de políticas de tabelas.