Editar um esquema de tabela

Neste artigo, você aprenderá a renomear tabelas e editar o esquema de uma tabela adicionando, renomeando e removendo colunas. Ele descreve as implicações e as dependências das alterações de esquema de tabela em objetos e mapeamentos referenciados.

Cuidado

  • Ingestões existentes, mapeamentos de ingestão, políticas de atualização, funções, exportações, exibições materializadas e outras operações relacionadas podem falhar após a edição do esquema de tabela. Consulte Dependências e certifique-se de editar a implementação dos mapeamentos de ingestão, políticas de atualização, funções, exportação e exibições materializadas adequadamente.

Dependências

A edição do esquema de tabela pode causar falhas de ingestão e consulta devido a dependências que fazem referência ao nome da tabela ou às colunas da tabela. A matriz a seguir indica as implicações das edições de esquema.

Edição de esquema Dependência
Renomeando tabelas Exibições materializadas:
* Por padrão, todas as exibições materializadas que referenciam diretamente o nome da tabela antiga são atualizadas para apontar para o novo nome, de forma transacional.
* Se o nome da tabela for referenciado de uma função armazenada invocada pela consulta de exibição, você precisará atualizar a referência de exibição materializada manualmente usando .alter materialized-view.
Renomeando colunas * Renomear uma coluna atualiza automaticamente todas as referências a ela em mapeamentos de ingestão.
* Renomear uma coluna preserva todas as transformações existentes em seus mapeamentos.
Adicionando colunas * A adição de uma nova coluna não atualiza automaticamente os mapeamentos de ingestão. Se quiser que a nova coluna seja incluída, atualize manualmente os mapeamentos.
* A edição do esquema não atualiza o mapeamento de dados de entrada para colunas de tabela durante a ingestão.
* Depois de adicionar colunas, certifique-se de atualizar o mapeamento para que os dados sejam ingeridos corretamente.
Para obter mais informações sobre como atualizar o mapeamento de ingestão, consulte o comando de mapeamento de ingestão .alter
Tipo de coluna Não há suporte para a edição de um tipo de coluna usando a opção Editar esquema de tabela, pois alterar um tipo de coluna levaria à perda de dados.
Removendo colunas * Excluir uma coluna remove a coluna de todos os mapeamentos de ingestão.
* A exclusão de uma coluna é irreversível e causa perda de dados. Você não pode consultar dados na coluna removida.
* Cuidado Se você excluir uma coluna, salvar e adicioná-la novamente, os dados não serão restaurados. Ele se comporta como uma nova coluna e os mapeamentos de ingestão não são atualizados. Você precisa atualizar manualmente os mapeamentos de ingestão.

Pré-requisitos

Renomear uma tabela

Quando você renomeia uma tabela, todas as referências a essa tabela nos mapeamentos de ingestão são atualizadas automaticamente. Em alguns casos, você precisa atualizar manualmente mapeamentos e referências de tabela. Antes de renomear uma tabela, examine Dependências.

  1. Navegue até o banco de dados KQL desejado e, no painel Do Explorer, expanda Tabelas.

  2. Selecione uma tabela na lista e abra o menu Mais [...].

    Captura de tela do menu Mais tabela com Editar esquema realçado.

  3. Na janela Editar esquema de tabela , edite o nome da tabela. Opcionalmente, edite a descrição da tabela.

    Captura de tela do esquema da edição da tabela com o campo nome da tabela realçado.

  4. Na seção Dependências , examine os objetos referenciados.

    • Por padrão, a atualização automática de exibições materializadas está habilitada. Você pode exibir as atualizações para o comando no visualizador de comandos.

    • Se necessário, desabilite Atualização Automática das Exibições Materializadas. Certifique-se de revisar as implicações nas Dependências e atualizar manualmente o mapeamento de ingestão da tabela, se necessário.

    Captura de tela do visualizador de comandos e da seção de dependências com a alternância para atualizar automaticamente modos de exibição materializados realçada.

  5. Selecione Atualizar e, na janela de confirmação, insira o nome da tabela novamente e selecione Editar esquema de tabela.

    Captura de tela da janela de confirmação com o campo nome da tabela realçado.

Editar colunas de tabela

Quando você renomeia ou adiciona colunas a uma tabela, todas as referências a essa tabela nos mapeamentos de ingestão são atualizadas automaticamente. Em alguns casos, você precisa atualizar manualmente mapeamentos e referências de tabela. Antes de editar as colunas da tabela, examine Dependências.

  1. Navegue até o banco de dados KQL desejado. No painel do Explorador, expanda Tabelas.

  2. Selecione uma tabela na lista e abra o menu Mais [...].

    Captura de tela do menu Mais tabela com Editar esquema realçado.

  3. Para adicionar uma nova coluna, insira um nome de coluna na parte inferior da lista de colunas. O nome da coluna deve começar com uma letra e pode conter números, períodos, hifens ou sublinhados.

  4. Selecione um tipo de dados para sua coluna. O tipo de coluna padrão é string , mas você pode alterá-lo no menu suspenso do campo Tipo de coluna .

  5. Selecione Adicionar coluna para adicionar mais colunas.

  6. Na seção Dependências , examine os objetos referenciados.

    • Por padrão, os Mapeamentos de Atualização Automática estão habilitados. Você pode exibir as atualizações para o comando de mapeamento de ingestão no visualizador de comandos.

    • Se necessário, desabilite Mapeamentos de Atualização Automática. Certifique-se de revisar as implicações nas Dependências e atualizar manualmente o mapeamento de ingestão da tabela, se necessário.

    Captura de tela do visualizador de comandos com mapeamentos de atualização automática habilitados na seção dependências.

  7. Se necessário, atualize o mapeamento de ingestão de dados.

Conteúdo relacionado

  • Last updated on