Skip to content

Commit 5f1f0da

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
Learn Build Service GitHub App
authored and
Learn Build Service GitHub App
committed
Merging changes synced from https://github.com/MicrosoftDocs/dataexplorer-docs-pr (branch live)
2 parents 2c31f5c + 8c37e2d commit 5f1f0da

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)