Comando .alter table

  • Artigo

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.