适用于:✅Azure 数据资源管理器
更改特定外部 delta 表的查询加速策略。
有关限制,请参阅限制。
Permissions
你必须至少具有数据库管理员权限才能运行此命令。
Syntax
.alter
external
table
ExternalTableNamepolicy
query_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 分钟。 |
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"}'