你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
更改特定外部增量表的 查询加速策略 属性。
小窍门
用于 .alter-merge 添加或更新属性而不替换整个策略。 数组属性合并(添加新元素、保留现有值)。
用于 .alter 完全替换策略,包括覆盖数组。
有关限制,请参阅 “限制”。
Permissions
必须至少具有 数据库管理员 权限才能运行此命令。
Syntax
.alter-merge
external
table
ExternalTableNamepolicyquery_acceleration “JSON 序列化策略”
参数
| 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)进行缓存。 |
注释
查询加速应用于特定时间段内的数据,定义为timespan从modificationTime增量日志中每个文件的声明开始。
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"}'