.изменить материализованное-представление

Переключение служб с помощью раскрывающегося списка версий . Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer

Модифицирование материализованного представления можно использовать для изменения запроса материализованного представления, сохраняя при этом существующие данные в представлении.

Разрешения

Для выполнения этой команды необходимо иметь по крайней мере разрешения администратора материализованного представления.

Синтаксис

.alter materialized-view [ with(PropertyName= PropertyValue,...)] Запрос SourceTableName MaterializedViewNameon table{}

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Поддерживаемые свойства

Следующие свойства поддерживаются в предложении with(PropertyName=PropertyValue). Все свойства являются необязательными.

Возвраты

Схема вывода:

Примеры

В примерах этого раздела показано, как использовать синтаксис для начала работы.

Изменение определения запроса материализованного представления

Следующая команда изменяет определение запроса материализованного представления MyView:

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

Выходные данные

Случаи использования

• Добавьте агрегаты в представление , например, добавьте avg агрегирование T | summarize count(), min(Value) by Idв , изменив запрос T | summarize count(), min(Value), avg(Value) by Idпредставления на .
• Изменение операторов, отличных от оператора суммирование. Например, отфильтруйте некоторые записи, изменив T | summarize arg_max(Timestamp, *) by User их T | where User != 'someone' | summarize arg_max(Timestamp, *) by Userв .
• Изменение без изменений в запросе из-за изменения исходной таблицы. Например, предположим, что представление T | summarize arg_max(Timestamp, *) by Idне задано autoUpdateSchema (см .create materialized-view . команду). Если столбец добавляется или удаляется из исходной таблицы представления, представление автоматически отключается. Выполните команду alter с тем же запросом, чтобы изменить схему материализованного представления, чтобы выровнять новую схему таблицы. Представление по-прежнему должно быть явно включено после изменения с помощью команды включения материализованного представления .

Ограничения

• Изменения не поддерживаются:

  • Изменения в материализованной группе представлений по выражениям.
  • Изменение типа столбца.
  • Переименование столбцов. Например, изменение представления для удаления столбца и создание нового столбца T | summarize count() by IdT | summarize Count=count() by Idcount_Count, который изначально содержит только значения NULL.

• Влияние на существующие данные:

  • Изменение материализованного представления не влияет на существующие данные.
  • Добавление фильтров в запрос применяется только к недавно принятым записям и не изменяет записи, которые уже были материализованы.
    • Новые столбцы получают значения NULL для всех существующих записей, пока записи не будут приниматься после изменения значений NULL.
    • Например: представление T | summarize count() by bin(Timestamp, 1d) изменено T | summarize count(), sum(Value) by bin(Timestamp, 1d)на . Для конкретного объекта Timestamp=T , для которого записи уже были обработаны перед изменением представления, sum столбец содержит частичные данные. Это представление включает только записи, обработанные после изменения.

Связанный контент

• материализованные представления
• варианты использования материализованных представлений
• .create materialized-view
• .create-or-alter materialized-view