Editar um esquema de tabela

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

Atenção

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

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 seguinte indica as implicações das edições de esquema.

Edição de esquema Dependência
Renomeando tabelas Vistas materializadas:
* Por defeito, todas as vistas materializadas que fazem referência direta ao nome da tabela antiga são atualizadas para apontar para o novo nome, de forma transacional.
* Se o nome da tabela for referenciado a partir de uma função armazenada invocada pela consulta de visualização, é necessário atualizar manualmente a referência de visualização materializada 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.
Adicionar colunas * Adicionar uma nova coluna não atualiza automaticamente os mapeamentos de ingestão. Se desejar que a nova coluna seja incluída, atualize manualmente os mapeamentos.
* A edição do esquema não atualiza o mapeamento de dados recebidos 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 .alter ingestion mapping
Tipo de coluna Editar um tipo de coluna não é suportado usando a opção Editar esquema da tabela, pois alterar o tipo de coluna levaria à perda de dados.
Remoção de colunas * A exclusão de uma coluna remove a coluna de todos os mapeamentos de ingestão.
* Excluir uma coluna é irreversível e causa perda de dados. Não é possível consultar dados na coluna removida.
* Atenção 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. Tens de atualizar manualmente os mapeamentos de ingestão.

Pré-requisitos

Renomear uma tabela

Quando renomeias uma tabela, todas as referências a essa tabela nos teus mapeamentos de ingestão atualizam-se automaticamente. Em alguns casos, é necessário atualizar manualmente os mapeamentos e referências das tabelas. Antes de renomear uma tabela, reveja Dependências.

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

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

    Captura de ecrã do menu mais da tabela com Editar esquema realçado.

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

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

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

    • Por padrão, as visualizações Materializadas de atualização automática estão habilitadas . Você pode exibir as atualizações para o comando no visualizador de comandos.

    • Se necessário, desative a atualização automática das visualizações Materializadas. Certifique-se de revisar as implicações em Dependências e actualize manualmente o mapeamento de ingestão de tabela, se necessário.

    Captura de ecrã do visualizador de comandos e da secção de dependências com a opção Atualização automática Vistas materializadas realçada.

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

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

Editar colunas da tabela

Quando renomeias ou adicionas colunas a uma tabela, todas as referências a essa tabela nos teus mapeamentos de ingestão atualizam-se automaticamente. Em alguns casos, é necessário atualizar manualmente os mapeamentos e referências das tabelas. Antes de editar as colunas da tabela, reveja as Dependências.

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

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

    Captura de ecrã do menu mais da 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, pontos, hífenes ou sublinhados.

  4. Selecione um tipo de dados para sua coluna. O tipo de coluna predefinido é string, mas pode alterá-lo no menu pendente do campo Tipo de coluna.

  5. Selecione Adicionar coluna para adicionar mais colunas.

  6. Na seção Dependências , revise 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, desative Mapeamentos de atualização automática. Certifique-se de revisar as implicações em Dependências e actualize manualmente o mapeamento de ingestão de 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