.alterar exibição materializada

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

A alteração da exibição materializada pode ser usada para mudar a consulta de uma exibição materializada preservando os dados existentes na exibição.

Permissões

Você deve ter pelo menos permissões de Administrador de Exibição Materializada para executar esse comando.

Sintaxe

.altermaterialized-view (with[ PropertyName = PropertyValue,...] )Consulta MaterializedViewName on table SourceTableName{ }

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Propriedades aceitas

As propriedades a seguir têm suporte na with(cláusula PropertyName = PropertyValue.) Todas as propriedades são opcionais.

Devoluções

Esquema de saída:

Exemplos

Modificar a definição de consulta de uma exibição materializada

O comando a seguir modifica a definição de consulta da exibição materializada MyView:

.alter materialized-view MyView on table MyTable
{
    MyTable | summarize arg_max(Column3, *) by Column1
}

Saída

Casos de uso

• Adicione agregações à exibição - por exemplo, adicione avg agregação a T | summarize count(), min(Value) by Id, alterando a consulta de exibição para T | summarize count(), min(Value), avg(Value) by Id.
• Altere os operadores diferentes do operador summarize. Por exemplo, filtre T | summarize arg_max(Timestamp, *) by User alguns registros alterando para T | where User != 'someone' | summarize arg_max(Timestamp, *) by User.
• Alterar sem alteração na consulta devido a uma alteração na tabela de origem. Por exemplo, suponha uma exibição de T | summarize arg_max(Timestamp, *) by Id, que não esteja definida como (consulte .create materialized-view o autoUpdateSchema comando). Se uma coluna for adicionada ou removida da tabela de origem da exibição, a exibição será desabilitada automaticamente. Execute o comando alter, com exatamente a mesma consulta, para alterar o esquema da exibição materializada para alinhá-lo ao novo esquema de tabela. A exibição ainda deve ser habilitada explicitamente após a alteração, usando o comando enable materialized view .

Limitações

• Alterações não suportadas:

  • Alterações no grupo de exibição materializado por expressões.
  • Alterando o tipo de coluna.
  • Renomear colunas. Por exemplo, alterar uma exibição de T | summarize count() by Id para descarta a T | summarize Count=count() by Id coluna count_ e cria uma nova coluna Count, que inicialmente contém apenas nulos.

• Impacto nos dados existentes:

  • Alterar a exibição materializada não tem impacto nos dados existentes.
  • A adição de filtros à consulta se aplica somente a registros recém-assimilados e não altera os registros que já foram materializados.
    • Novas colunas recebem nulos para todos os registros existentes até que os registros ingeridos após o comando alter modifiquem os valores nulos.
    • Por exemplo: Uma exibição de T | summarize count() by bin(Timestamp, 1d) é alterada para T | summarize count(), sum(Value) by bin(Timestamp, 1d). Para um específico Timestamp=T para o qual os registros já foram processados antes de alterar a exibição, a sum coluna contém dados parciais. Essa exibição inclui apenas registros processados após a execução da alteração.