.alter materialized-view

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Une modification de la vue matérialisée peut être utilisée pour modifier la requête d’une vue matérialisée, tout en conservant les données existantes dans la vue.

autorisations

Vous devez disposer au moins des autorisations d’administrateur de vue matérialisée pour exécuter cette commande.

Syntaxe

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

En savoir plus sur les conventions de syntaxe.

Paramètres

Propriétés prises en charge

Les propriétés suivantes sont prises en charge dans la with (clause PropertyName = PropertyValue.) Toutes les propriétés sont facultatives.

Retours

Schéma de sortie :

Exemples

Modifier la définition de requête d’une vue matérialisée

La commande suivante modifie la définition de requête de la vue matérialisée MyView :

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

Sortie

Cas d’utilisation

• Ajoutez des agrégations à la vue , par exemple, ajoutez avg l’agrégation à T | summarize count(), min(Value) by Id, en modifiant la requête d’affichage en T | summarize count(), min(Value), avg(Value) by Id.
• Modifiez les opérateurs autres que l’opérateur de synthèse. Par exemple, filtrez certains enregistrements en modifiant T | summarize arg_max(Timestamp, *) by User la valeur T | where User != 'someone' | summarize arg_max(Timestamp, *) by User.
• Modifiez sans modification de la requête en raison d’une modification de la table source. Par exemple, supposons qu’une vue de T | summarize arg_max(Timestamp, *) by Id, qui n’est pas définie autoUpdateSchema sur (voir .create materialized-view la commande). Si une colonne est ajoutée ou supprimée de la table source de la vue, la vue est automatiquement désactivée. Exécutez la commande alter, avec la même requête, pour modifier le schéma de la vue matérialisée pour s’aligner sur le nouveau schéma de table. La vue doit toujours être activée explicitement après la modification, à l’aide de la commande Activer la vue matérialisée.

Limites

• Modifications non prises en charge :

  • Modifications apportées au groupe d’affichage matérialisé par expressions.
  • Modification du type de colonne.
  • Changement de nom des colonnes. Par exemple, la modification d’une vue de suppression T | summarize Count=count() by Id de T | summarize count() by Id colonne count_ et la création d’une nouvelle colonneCount, qui contient initialement des valeurs Null uniquement.

• Impact sur les données existantes :

  • La modification de la vue matérialisée n’a aucun impact sur les données existantes.
  • L’ajout de filtres à la requête s’applique uniquement aux enregistrements nouvellement ingérés et ne modifie pas les enregistrements qui ont déjà été matérialisés.
    • Les nouvelles colonnes reçoivent des valeurs Null pour tous les enregistrements existants jusqu’à ce que les enregistrements ingérés après la commande alter modifient les valeurs Null.
    • Par exemple : une vue d’une T | summarize count() by bin(Timestamp, 1d) vue est modifiée en T | summarize count(), sum(Value) by bin(Timestamp, 1d). Pour un enregistrement particulier Timestamp=T pour lequel les enregistrements ont déjà été traités avant de modifier la vue, la sum colonne contient des données partielles. Cette vue inclut uniquement les enregistrements traités après l’exécution de modification.