Skip to content

Commit 8c37e2d

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #7219 from MicrosoftDocs/main
Auto Publish – main to live - 2025-11-18 12:00 UTC
2 parents fdf1d2f + 3513287 commit 8c37e2d

File tree

3 files changed

+32
-18
lines changed

3 files changed

+32
-18
lines changed

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

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -31,22 +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. |
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. |
4041
::: moniker-end
4142

4243
::: moniker range="azure-data-explorer"
43-
| Property | Type | Required | Description |
44-
| ---------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45-
| IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. |
46-
| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. |
47-
| HotWindows | `DateTime` | | One or more optional time windows. Delta data files created within these time windows are accelerated. |
48-
| 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. |
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. |
4950
| 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. |
5052
::: moniker-end
5153
> [!NOTE]
5254
> 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).
@@ -72,13 +74,13 @@ The command returns a table with one record that includes the modified policy ob
7274
## Example
7375
::: moniker range="microsoft-fabric"
7476
```Kusto
75-
.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"}'
77+
.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"}'
7678
```
7779
::: moniker-end
7880

7981
::: moniker range="azure-data-explorer"
8082
```Kusto
81-
.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"}'
83+
.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"}'
8284
```
8385
::: moniker-end
8486
## Related content

‎data-explorer/kusto/management/show-external-tables-details.md‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,14 +40,26 @@ You must have at least Database User, Database Viewer, Database Monitor to run t
4040
| QueryAccelerationState | `string` | A JSON-serialization of the [query acceleration status](#query-acceleration-state) parameters. |
4141

4242
### Query acceleration policy
43-
43+
::: moniker range="microsoft-fabric"
4444
| Column | Type | Description |
4545
|--|--|--|
4646
| IsEnabled | `bool` | Indicates whether the external table has a query acceleration policy enabled. |
4747
| Hot | `timespan` | The hot period defined in the query acceleration policy. |
4848
| MaxAge | `timespan` | The maximum timespan from the last index refresh time that enables the external table to operate in accelerated mode. |
4949
| HotWindows | `datetime` | One or more optional time windows. Delta data files created within these time windows are accelerated. |
50+
| HotDateTimeColumn | `string` | The hot datetime column defined in the query acceleration policy. |
51+
::: moniker-end
5052

53+
::: moniker range="azure-data-explorer"
54+
| Column | Type | Description |
55+
|--|--|--|
56+
| IsEnabled | `bool` | Indicates whether the external table has a query acceleration policy enabled. |
57+
| Hot | `timespan` | The hot period defined in the query acceleration policy. |
58+
| MaxAge | `timespan` | The maximum timespan from the last index refresh time that enables the external table to operate in accelerated mode. |
59+
| HotWindows | `datetime` | One or more optional time windows. Delta data files created within these time windows are accelerated. |
60+
| ManagedIdentity | `string` | The managed identity defined in the query acceleration policy. |
61+
| HotDateTimeColumn | `string` | The hot datetime column defined in the query acceleration policy. |
62+
::: moniker-end
5163
### Query acceleration state
5264

5365
| Column | Type | Description |

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -48,9 +48,9 @@ The command returns a table with a record per external table with the following
4848

4949
**Output**
5050

51-
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
52-
| ----------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------- |
53-
| QueryAccelerationPolicy | [MyDatabase].[MyExternalTable] | `{<br> "IsEnabled": true,<br> "Hot": "1.00:00:00",<br> "HotWindows": [{"MinValue":"2025-07-06 07:53:55.0192810","MaxValue":"2025-07-06 07:53:55.0192814"}], "MaxAge": "5m"}` | | ExternalTable |
51+
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
52+
| ----------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------- |
53+
| QueryAccelerationPolicy | [MyDatabase].[MyExternalTable] | `{<br> "IsEnabled": true,<br> "Hot": "1.00:00:00",<br> "HotWindows": [{"MinValue":"2025-07-06 07:53:55","MaxValue":"2025-07-07 07:53:55"}], "MaxAge": "5m", "HotDateTimeColumn":"dt1"}` | | ExternalTable |
5454

5555
## Related content
5656

0 commit comments

Comments
 (0)