.create-or-alter materialized-view

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Crea una vista materializada o modifica una ya existente.

Permisos

Debe tener al menos permisos de administrador de vista materializado para ejecutar este comando.

Sintaxis

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

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Propiedades admitidas

Nueva tabla

Si la tabla es nueva, se admiten las siguientes propiedades en PropertyName with(= PropertyValue . ) Todas las propiedades son opcionales.

Tabla existente

Si la tabla ya existe, solo se admite el siguiente subconjunto de propiedades en propertyName with(= PropertyValue . ) Todas las propiedades son opcionales.

Devoluciones

Esquema de salida:

Ejemplos

Crear o modificar una vista materializada

El siguiente comando crea una nueva o modifica una vista materializada existente denominada ArgMax:

.create-or-alter materialized-view ArgMax on table T
{
    T | summarize arg_max(Timestamp, *) by User
}

Salida

Comentarios

Si la vista materializada no existe, este comando se comporta igual que .create materialized-view.

Para obtener más información, consulte las secciones Parámetro de consulta y Propiedades .

Limitaciones

• Cambios no admitidos:

  • Cambios en el grupo de vistas materializado por expresiones.
  • Cambiar el tipo de columna.
  • Cambio de nombre de las columnas. Por ejemplo, modificar una vista de T | summarize count() by Id para quitar columna count_ y crea una nueva columna Count, que inicialmente solo T | summarize Count=count() by Id contiene valores NULL.

• Impacto en los datos existentes:

  • La modificación de la vista materializada no afecta a los datos existentes.
  • Agregar filtros a la consulta solo se aplica a los registros recién ingeridos y no cambia los registros que ya se han materializado.
    • Las nuevas columnas reciben valores NULL para todos los registros existentes hasta que los registros ingeridos después del comando alter modifican los valores NULL.
    • Por ejemplo: se modifica una vista de T | summarize count() by bin(Timestamp, 1d) a T | summarize count(), sum(Value) by bin(Timestamp, 1d). Para un determinado para el Timestamp=T que los registros ya se han procesado antes de modificar la vista, la sum columna contiene datos parciales. Esta vista solo incluye registros procesados después de la modificación de la ejecución.