使用 “版本 ”下拉列表切换服务。 了解有关导航的详细信息。
适用于：✅ Azure Data Explorer
更改特定外部 delta 表的查询加速策略。
有关限制，请参阅限制。
Permissions
必须至少具有 Database Admin 权限才能运行此命令。
Syntax
.alter
external
table ExternalTableNamepolicyquery_acceleration“JSON-序列化策略”
Parameters
| Name | 类型 | Required | Description |
|---|---|---|---|
| ExternalTableName | string |
✔️ | 外部 delta 表的名称。 |
| JSON 序列化策略 | string |
✔️ | 包含 JSON 属性包的字符串文本。 |
JSON 属性包
| Property | 类型 | Required | Description |
|---|---|---|---|
| IsEnabled | Boolean |
✔️ | 指示是否启用了策略。 |
| Hot | Timespan |
✔️ | 查询加速策略中定义的热时段。 最小值 = 1 d。 |
| HotWindows | DateTime |
一个或多个可选时间窗口。 加速在这些时间时段内创建的增量数据文件。 | |
| MaxAge | Timespan |
如果上次索引刷新时间大于 @now - MaxAge，外部表将返回加速数据。 否则，外部表在非加速模式下运行。 默认值为 5 分钟。 最小值为 1 分钟。 也可以使用函数external_table()的参数在查询时重写此属性。 |
|
| ManagedIdentity | string |
执行查询加速后台作的可选托管标识。 此标识必须具有相关的增量表权限，并且必须为群集/数据库托管标识策略中的 AutomatedFlows 启用。 有关详细信息，请参阅托管标识概述。 | |
| HotDateTimeColumn | String |
可选。 Delta 表中的日期/时间列的名称，其值将用于确定热缓存资格。 设置时，会选择其行在配置的热时间段内具有值的数据文件（以及/或 HotWindows）进行缓存。 |
Note
默认情况下，查询加速将应用于特定时间段内的数据，具体取决于 delta log中每个文件的 modificationTime。 可以通过在策略中指定 HotDateTimeColumn 属性来替代默认行为。
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-07 07:00:00","MaxValue":"2025-07-09 07:00:00"}], "MaxAge": "00:05:00", "ManagedIdentity": "12345678-1234-1234-1234-1234567890ab", "HotDateTimeColumn":"dt1"}'