通过

.alter-merge query acceleration policy 命令

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

更改特定外部增量表的 查询加速策略 属性。

小窍门

用于 .alter-merge 添加或更新属性而不替换整个策略。 数组属性合并（添加新元素、保留现有值）。 用于 .alter 完全替换策略，包括覆盖数组。

有关限制，请参阅限制。

Permissions

你必须至少具有数据库管理员权限才能运行此命令。

Syntax

.alter-merge external table ExternalTableNamepolicyquery_acceleration“JSON-序列化策略”

参数

Name 类型 必选 Description
ExternalTableName string ✔️ 外部 delta 表的名称。
JSON 序列化策略 string ✔️ 包含 JSON 属性包的字符串文本。

JSON 属性包

资产 类型 必选 Description
已启用 Boolean 指示是否启用了策略。 如果未在外部表上定义查询加速策略，则需要此属性。
Hot Timespan 查询加速策略中定义的热时段。 最小值 = 1 d。 如果未在外部表上定义查询加速策略，则需要此属性。
HotWindows DateTime 一个或多个可选时间窗口。 加速在这些时间时段内创建的增量数据文件。
MaxAge Timespan 如果上次索引刷新时间大于 @now - MaxAge，外部表将返回加速数据。 否则，外部表在非访问模式下运行。 默认值为 5 分钟。 最小值为 1 分钟。

注释

查询加速应用于特定时间段（定义为 timespan）内的数据，从 modificationTime中每个文件的 开始。

Example

如果外部表定义了查询加速策略：

{ "Hot": "1.00:00:00" }

如果外部表未定义查询加速策略：

{ "IsEnabled": true, "Hot": "1.00:00:00" }

退货

该命令会返回一个表，其中包含已修改策略对象的记录。

列 类型 Description
政策名称 string 策略的名称 - QueryAcceleration
实体名称 string 实体的完全限定名称：[DatabaseName].[ExternalTableName]
Policy string 在外部 delta 表上设置的查询加速策略的 JSON 序列化
ChildEntities string 此策略影响的子实体 - null
实体类型 string 策略应用到的实体的类型 - ExternalTable

Example

如果外部表定义了查询加速策略：

.alter-merge external table MyExternalTable policy query_acceleration '{"Hot": "1.00:00:00", "MaxAge" : "00:05:00"}'

如果外部表未定义查询加速策略：

.alter-merge external table MyExternalTable policy query_acceleration '{"IsEnabled": true, "Hot": "1.00:00:00", "MaxAge" : "00:05:00"}'

相关内容