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.

Permitir valores grandes para uma coluna

Se você espera ingerir valores grandes em uma coluna, pode habilitar suporte de grande valor para essa coluna. O sistema permite automaticamente suporte de grandes valores para string e dynamic colunas quando o processo de inferência de esquema identifica valores maiores que 1 MB.

Se o processo de inferência de esquema não identificar um valor grande, você poderá ativar manualmente o suporte a valores grandes para uma coluna string ou dynamic existente. Para mais informações, veja Suporte para mensagens grandes (prévia).

Note

Essa configuração se aplica apenas a novos dados ingeridos daqui para frente. Os valores string previamente ingeridos são truncados no limite (a propriedade MaxValueSize da política padrão é de 1 MB), e os valores dynamic são substituídos por null. O suporte para mensagens grandes não está disponível para atalhos (tabelas externas) nem para tabelas com aceleração de consulta em atalhos do OneLake. A disponibilidade de dados do OneLake para tabelas com colunas de grande valor depende dos limites de tamanho alvo.

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

  2. Selecione uma tabela da lista e, no menu Mais [...], selecione Editar esquema.

  3. Na janela de esquema da tabela de Editar , selecione a coluna que contém valores grandes e ative Habilitar valores grandes.

Captura de tela da janela do esquema da tabela de edição com a opção de ativar valores grandes destacada.

Conteúdo relacionado

  • Última atualização em