Skip to content

Commit f5580d6

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #7231 from MicrosoftDocs/main
Auto Publish – main to live - 2025-11-26 12:00 UTC
2 parents 650fae4 + 101e611 commit f5580d6

File tree

3 files changed

+24
-23
lines changed

3 files changed

+24
-23
lines changed

‎data-explorer/kusto/management/alter-merge-query-acceleration-policy-command.md‎

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -35,12 +35,13 @@ You must have at least [Database Admin](../access-control/role-based-access-cont
3535

3636
### JSON property bag
3737

38-
| Property | Type | Required | Description |
39-
| ---------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
40-
| IsEnabled | `Boolean` | | Indicates whether the policy is enabled. This property is required if no query acceleration policy is defined on the external table. |
41-
| Hot | `Timespan` | | The hot period defined in the query acceleration policy. Minimum value = 1 d. This property is required if no query acceleration policy is defined on the external table. |
42-
| HotWindows | `DateTime` | | One or more optional time windows. Delta data files created within these time windows are accelerated. |
43-
| MaxAge | `Timespan` | | The external table returns accelerated data if the last index refresh time is greater than @now - MaxAge. Otherwise, external table operates in nonaccelerated mode. Default is 5 minutes. Minimum is 1 minute. |
38+
| Property | Type | Required | Description |
39+
| --------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
40+
| IsEnabled | `Boolean` | | Indicates whether the policy is enabled. This property is required if no query acceleration policy is defined on the external table. |
41+
| Hot | `Timespan` | | The hot period defined in the query acceleration policy. Minimum value = 1 d. This property is required if no query acceleration policy is defined on the external table. |
42+
| HotWindows | `DateTime` | | One or more optional time windows. Delta data files created within these time windows are accelerated. |
43+
| MaxAge | `Timespan` | | The external table returns accelerated data if the last index refresh time is greater than @now - MaxAge. Otherwise, external table operates in nonaccelerated mode. Default is 5 minutes. Minimum is 1 minute. |
44+
| HotDateTimeColumn | `String` | | The name of a datetime column in the Delta table whose values will be used to determine hot-cache eligibility. When set, data files whose rows have values within the configured Hot period (and/or HotWindows) are selected for caching. |
4445

4546
> [!NOTE]
4647
> Query acceleration is applied to data within a specific time period, defined as `timespan`, starting from the `modificationTime` as stated for each file in the [delta log](https://github.com/delta-io/delta/blob/master/PROTOCOL.md#add-file-and-remove-file).
@@ -50,7 +51,7 @@ You must have at least [Database Admin](../access-control/role-based-access-cont
5051
In case the external table has query acceleration policy defined:
5152

5253
```json
53-
{ "Hot": "1.00:00:00" }
54+
{ "HotDateTimeColumn": "Col1" }
5455
```
5556

5657
In case the external table doesn't have query acceleration policy defined:

‎data-explorer/kusto/management/alter-query-acceleration-policy-command.md‎

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -31,24 +31,24 @@ You must have at least [Database Admin](../access-control/role-based-access-cont
3131

3232
### JSON property bag
3333
::: moniker range="microsoft-fabric"
34-
| Property | Type | Required | Description |
35-
| ---------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
36-
| IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. |
37-
| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. |
38-
| HotWindows | `DateTime` | | One or more optional time windows. Delta data files created within these time windows are accelerated. |
39-
| MaxAge | `Timespan` | | The external table returns accelerated data if the last index refresh time is greater than @now - MaxAge. Otherwise, the external table operates in non-accelerated mode. Default is 5 minutes. Minimum is 1 minute. |
40-
| HotDateTimeColumn | `String` | | Optional. The name of a datetime column in the Delta table whose values will be used to determine hot-cache eligibility. When set, data files whose rows have values within the configured Hot period (and/or HotWindows) are selected for caching. |
34+
| Property | Type | Required | Description |
35+
| ------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
36+
| IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. |
37+
| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. |
38+
| HotWindows | `DateTime` | | One or more optional time windows. Delta data files created within these time windows are accelerated. |
39+
| MaxAge | `Timespan` | | The external table returns accelerated data if the last index refresh time is greater than @now - MaxAge. Otherwise, the external table operates in non-accelerated mode. Default is 5 minutes. Minimum is 1 minute. This property can also be overridden at query time by using the [`external_table()` function's](../query/external-table-function.md) `MaxAgeOverride` parameter. |
40+
| HotDateTimeColumn | `String` | | Optional. The name of a datetime column in the Delta table whose values will be used to determine hot-cache eligibility. When set, data files whose rows have values within the configured Hot period (and/or HotWindows) are selected for caching. |
4141
::: moniker-end
4242

4343
::: moniker range="azure-data-explorer"
44-
| Property | Type | Required | Description |
45-
| ---------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
46-
| IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. |
47-
| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. |
48-
| HotWindows | `DateTime` | | One or more optional time windows. Delta data files created within these time windows are accelerated. |
49-
| MaxAge | `Timespan` | | The external table returns accelerated data if the last index refresh time is greater than @now - MaxAge. Otherwise, the external table operates in non-accelerated mode. Default is 5 minutes. Minimum is 1 minute. |
50-
| ManagedIdentity | `string` | | Optional managed identity for which the query acceleration background operations are executed. This identity must have relevant delta table permissions and must be enabled for AutomatedFlows in the cluster / database managed identity policy. For more information, see [Managed identities overview](/azure/data-explorer/managed-identities-overview)|
51-
| HotDateTimeColumn | `String` | | Optional. The name of a datetime column in the Delta table whose values will be used to determine hot-cache eligibility. When set, data files whose rows have values within the configured Hot period (and/or HotWindows) are selected for caching. |
44+
| Property | Type | Required | Description |
45+
| ------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
46+
| IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. |
47+
| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. |
48+
| HotWindows | `DateTime` | | One or more optional time windows. Delta data files created within these time windows are accelerated. |
49+
| MaxAge | `Timespan` | | The external table returns accelerated data if the last index refresh time is greater than @now - MaxAge. Otherwise, the external table operates in non-accelerated mode. Default is 5 minutes. Minimum is 1 minute. This property can also be overridden at query time by using the [`external_table()` function's](../query/external-table-function.md) `MaxAgeOverride` parameter. |
50+
| ManagedIdentity | `string` | | Optional managed identity for which the query acceleration background operations are executed. This identity must have relevant delta table permissions and must be enabled for AutomatedFlows in the cluster / database managed identity policy. For more information, see [Managed identities overview](/azure/data-explorer/managed-identities-overview). |
51+
| HotDateTimeColumn | `String` | | Optional. The name of a datetime column in the Delta table whose values will be used to determine hot-cache eligibility. When set, data files whose rows have values within the configured Hot period (and/or HotWindows) are selected for caching. |
5252
::: moniker-end
5353
> [!NOTE]
5454
> Query acceleration is applied to data within a specific time period, defined as `timespan`, starting from the `modificationTime` as stated for each file in the [delta log](https://github.com/delta-io/delta/blob/master/PROTOCOL.md#add-file-and-remove-file).

‎data-explorer/kusto/query/external-table-function.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ To accelerate queries over external delta tables, see [Query acceleration policy
2020

2121
## Syntax
2222

23-
`external_table(` *TableName* [`,` *MappingName* ] `)`
23+
`external_table(` *TableName* [`,` *MappingName* / *MaxAgeOverride* ] `)`
2424

2525
[!INCLUDE [syntax-conventions-note](../includes/syntax-conventions-note.md)]
2626

0 commit comments

Comments
 (0)