你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

.alter-merge query acceleration policy 命令

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

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

小窍门

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

有关限制,请参阅 “限制”。

Permissions

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

Syntax

.alter-merge external table ExternalTableNamepolicyquery_accelerationJSON 序列化策略

参数

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

JSON 属性包

资产 类型 必选 Description
已启用 Boolean 指示是否启用策略。 如果未在外部表上定义查询加速策略,则需要此属性。
Hot Timespan 查询加速策略中定义的热时段。 最小值 = 1 d。 如果未在外部表上定义查询加速策略,则需要此属性。
HotWindows DateTime 一个或多个可选时间窗口。 加速在这些时间时段内创建的增量数据文件。
MaxAge Timespan 如果上次索引刷新时间大于 @now - MaxAge,外部表将返回加速数据。 否则,外部表在非访问模式下运行。 默认值为 5 分钟。 最小值为 1 分钟。
HotDateTimeColumn String Delta 表中的日期/时间列的名称,其值将用于确定热缓存资格。 设置时,会选择其行在配置的热时间段内具有值的数据文件(以及/或 HotWindows)进行缓存。

注释

查询加速应用于特定时间段内的数据,定义为timespanmodificationTime增量日志中每个文件的声明开始。

Example

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

{ "HotDateTimeColumn": "Col1" }

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

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

退货

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

类型 Description
政策名称 string 策略的名称 - QueryAcceleration
实体名称 string 实体的完全限定名称: [DatabaseName].[ExternalTableName]
Policy string 在外部增量表上设置的查询加速策略的 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"}'