.alter 查询加速策略命令

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

更改特定外部 delta 表的查询加速策略

有关限制,请参阅限制

Permissions

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

Syntax

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

Parameters

Name 类型 Required Description
ExternalTableName string ✔️ 外部 delta 表的名称。
JSON-serialized policy string ✔️ 包含 JSON 属性包的字符串文本。

JSON 属性包

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

Note

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

Example

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

Returns

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

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

Example

.alter external table MyExternalTable policy query_acceleration '{"IsEnabled": true, "Hot": "1.00:00:00", "HotWindows":[{"MinValue":"2025-07-06 07:53:55.0192810","MaxValue":"2025-07-06 07:53:55.0192814"}], "MaxAge" : "00:05:00"}'