使用英语阅读

通过

.alter materialized-view autoUpdateSchema

  • 项目
  • 2024/09/29

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

将现有具体化视图的 autoUpdateSchema 值设置为 true 或 false。 有关 autoUpdateSchema 属性的信息，请参阅具体化视图创建命令属性。

权限

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

语法

.alter materialized-view MaterializedViewName autoUpdateSchema 布尔

详细了解语法约定。

参数

客户 类型​​ 必需 说明
MaterializedViewName string ✔️ 具体化视图的名称。
布尔值 bool ✔️ 要更新的 autoUpdateSchema 值。

返回

输出架构：

名称 Type 说明
Name string 具体化视图的名称。
SourceTable string 定义视图的源表的名称。
查询 string 具体化视图的查询定义。
MaterializedTo datetime 源表中的最大具体化 ingestion_time() 时间戳。 有关详细信息，请参阅具体化视图的工作原理。
LastRun datetime 上次运行具体化的时间。
LastRunResult string 上次运行的结果。 如果运行成功，则返回 Completed，否则返回 Failed。
IsHealthy bool 当视图被认为正常时为 true，否则为 false。 如果视图在最后一小时之前被成功地具体化（MaterializedTo 大于 ago(1h)），则认为它是正常的。
IsEnabled bool 如果视图已启用，则为 true（请参阅禁用或启用具体化视图）。
Folder string 在其中创建具体化视图的文件夹。
DocString string 分配给具体化视图的说明。
AutoUpdateSchema bool 视图是否已启用自动更新。
EffectiveDateTime datetime 视图的生效日期时间，在创建期间确定（请参阅 .create materialized-view）。
回溯 timespan 时间跨度，用于限制需要重复项的时间段。

示例

为具体化视图启用自动更新架构

以下命令为具体化视图 MyView 启用 autoUpdateSchema，以便在视图所基于的源表的架构发生更改时，视图的架构会自动更新以反映这些更改。

.alter materialized-view MyView autoUpdateSchema true

输出

名称 SourceTable 查询 MaterializedTo LastRun LastRunResult IsHealthy IsEnabled 文件夹 DocString AutoUpdateSchema EffectiveDateTime 回溯
MyView MyTable summarize take_any(*) by Column1 2023-02-26T16:40:03.3345704Z 2023-02-26T16:44:15.9033667Z 已完成 true true 是 2023-02-23T14:01:42.5172342Z

为具体化视图禁用自动更新架构

以下命令为具体化视图 MyView 禁用 autoUpdateSchema，以便在视图所基于的源表的架构发生更改时，视图的架构不会自动更新来反映这些更改。

.alter materialized-view MyView autoUpdateSchema false

输出

名称 SourceTable 查询 MaterializedTo LastRun LastRunResult IsHealthy IsEnabled 文件夹 DocString AutoUpdateSchema EffectiveDateTime 回溯
MyView MyTable MyTable | summarize take_any(*) by Column1 2023-02-26T16:40:03.3345704Z 2023-02-26T16:44:15.9033667Z 已完成 true true false 2023-02-23T14:01:42.5172342Z