.alter materialized-view

适用于：✅Azure 数据资源管理器

更改具体化视图可用于更改具体化视图的查询，同时保留视图中的现有数据。

权限

你必须至少具有具体化视图管理员权限才能运行此命令。

语法

.alter materialized-view [ with (PropertyName = PropertyValue,...)] MaterializedViewName on table SourceTableName { Query }

详细了解语法约定。

参数

支持的属性

with (PropertyName = PropertyValue) 子句支持以下属性。 所有属性都是可选的。

返回

输出架构：

示例

修改具体化视图的查询定义

以下命令修改具体化视图 MyView 的查询定义：

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

输出

用例

• 向视图添加聚合 - 例如，通过将视图查询更改为 T | summarize count(), min(Value), avg(Value) by Id，将 avg 聚合添加到 T | summarize count(), min(Value) by Id 中。
• 更改除 summarize 运算符之外的运算符。 例如，通过将 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 命令，以更改具体化视图的架构，使之与新表架构保持一致。 在更改后，仍必须使用 enable materialized view 命令显式启用该视图。

限制

• 不支持的更改：

  • 通过表达式对具体化视图组进行更改。
  • 更改列类型。
  • 重命名列。 例如，将 T | summarize count() by Id 的视图更改为 T | summarize Count=count() by Id 会删除 count_ 列并创建新列 Count（该列最初仅包含 null）。

• 对现有数据的影响：

  • 更改具体化视图不会影响现有数据。
  • 向查询添加筛选器仅适用于新引入的记录，不会更改已具体化的记录。
    • 对于所有现有记录，新列都会收到 null，直到在 alter 命令后引入的记录修改 null 值。
    • 例如：T | summarize count() by bin(Timestamp, 1d) 的视图更改为 T | summarize count(), sum(Value) by bin(Timestamp, 1d)。 对于已在更改视图之前处理的记录的特定 Timestamp=T，sum 列将包含部分数据。 此视图仅包含在 alter 执行后处理的记录。