.alter materialized-view folder

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

更改现有具体化视图的 folder 值。

权限

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

语法

.alter materialized-viewMaterializedViewNamefolder Folder

详细了解语法约定

参数

客户 类型​​ 必需 说明
MaterializedViewName string ✔️ 具体化视图的名称。
文件夹 string ✔️ 用于在 UI 中组织具体化视图的文件夹路径。 此参数的值不会更改视图在查询中的工作方式或引用方式。

返回

输出架构:

名称 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 时间跨度,用于限制需要重复项的时间段。

示例

将具体化视图的文件夹设置为根下的文件夹

以下命令将具体化视图必须显示在其中的文件夹设置为 Materialized Views 文件夹下名为 Updated folder 的文件夹:

.alter materialized-view MyView folder "Updated folder"

输出

名称 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 "Updated folder" 2023-02-23T14:01:42.5172342Z

将具体化视图的文件夹设置为根下的二级文件夹

以下命令将具体化视图必须显示在其中的文件夹设置为 Materialized Views 文件夹下的二级文件夹:

.alter materialized-view MyView folder @"First Level\Second Level"

输出

名称 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 "First Level\Second Level" 2023-02-23T14:01:42.5172342Z 6:00:00:00