你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
更改 特定外部增量表的查询加速策略 。
有关限制，请参阅 “限制”。
Permissions
必须至少具有 数据库管理员 权限才能运行此命令。
Syntax
.alter
external
table
ExternalTableNamepolicyquery_acceleration “JSON 序列化策略”
Parameters
| Name | 类型 | Required | Description |
|---|---|---|---|
| ExternalTableName | string |
✔️ | 外部增量表的名称。 |
| JSON 序列化策略 | string |
✔️ | 包含 JSON 属性包的字符串文本。 |
JSON 属性包
| Property | 类型 | Required | Description |
|---|---|---|---|
| IsEnabled | Boolean |
✔️ | 指示是否启用策略。 |
| Hot | Timespan |
✔️ | 查询加速策略中定义的热时段。 最小值 = 1 d。 |
| HotWindows | DateTime |
一个或多个可选时间窗口。 加速在这些时间时段内创建的增量数据文件。 | |
| MaxAge | Timespan |
如果上次索引刷新时间大于 @now - MaxAge，外部表将返回加速数据。 否则，外部表在非加速模式下运行。 默认值为 5 分钟。 最小值为 1 分钟。 也可以使用函数external_table()的参数在查询时MaxAgeOverride重写此属性。 |
|
| HotDateTimeColumn | String |
可选。 Delta 表中的日期/时间列的名称，其值将用于确定热缓存资格。 设置时，会选择其行在配置的热时间段内具有值的数据文件（以及/或 HotWindows）进行缓存。 |
| Property | 类型 | Required | Description |
|---|---|---|---|
| IsEnabled | Boolean |
✔️ | 指示是否启用策略。 |
| Hot | Timespan |
✔️ | 查询加速策略中定义的热时段。 最小值 = 1 d。 |
| HotWindows | DateTime |
一个或多个可选时间窗口。 加速在这些时间时段内创建的增量数据文件。 | |
| MaxAge | Timespan |
如果上次索引刷新时间大于 @now - MaxAge，外部表将返回加速数据。 否则，外部表在非加速模式下运行。 默认值为 5 分钟。 最小值为 1 分钟。 也可以使用函数external_table()的参数在查询时MaxAgeOverride重写此属性。 |
|
| ManagedIdentity （托管身份） | string |
执行查询加速后台作的可选托管标识。 此标识必须具有相关的增量表权限，并且必须为群集/数据库托管标识策略中的 AutomatedFlows 启用。 有关详细信息，请参阅托管标识概述。 | |
| HotDateTimeColumn | String |
可选。 Delta 表中的日期/时间列的名称，其值将用于确定热缓存资格。 设置时，会选择其行在配置的热时间段内具有值的数据文件（以及/或 HotWindows）进行缓存。 |
Note
查询加速将应用于特定时间段内的数据，具体取决于 modificationTime 默认情况下增量 日志 中每个文件的状态。 可以通过在策略中指定 HotDateTimeColumn 属性来替代默认行为。
Example
{ "IsEnabled": true, "Hot": "1.00:00:00" }
Returns
该命令返回一个包含已修改策略对象的记录的表。
| Column | 类型 | Description |
|---|---|---|
| PolicyName | string |
策略的名称 - QueryAcceleration |
| EntityName | string |
实体的完全限定名称： [DatabaseName].[ExternalTableName] |
| Policy | string |
在外部增量表上设置的查询加速策略的 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", "HotDateTimeColumn":"dt1"}'
.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"}'