From e7b47f73d3509bda243889c38636ab87dd54719e Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Sun, 30 Nov 2025 15:09:55 +0200 Subject: [PATCH 1/2] KUS: update management command # Thank you for contributing to Kusto documentation Please add a brief comment outlining the purpose of this PR. Add links to any relevant references such as DevOps work items. ## Make sure you've done the following: 1. **Acrolinx**: Make sure your Acrolinx score is **at least 80** (higher is better) and with **0** spelling issues. 1. **Successful build**: Review the build status to make sure **all files are green** (Succeeded) and there are no errors, warnings, or suggestions. 1. **Preview the pages**: Click each **Preview URL** link, scan the entire page looking for formatting issues, in particular the parts you edited. 1. **Check the Table of Contents**: If you're adding a new markdown file, make sure it is linked from the table of contents. 1. **Sign off**: Once the PR is finalized, add a comment with `#sign-off` . If you need to cancel the sign-off, add a comment with `#hold-off`. **NOTE**: *Signing off means the document can be published at any time.* ## Next steps - All PRs to this repository are reviewed and merged by a human. Automatic merge is disabled on this repository for PRs, even with the qualifies-for-auto-merge label. - Once all feedback on the PR is addressed, the PR will be merged into the main branch. [Learn more about how to contribute](https://review.learn.microsoft.com/en-us/help/platform/?branch=main) --- .../kusto/management/alter-query-acceleration-policy-command.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-query-acceleration-policy-command.md b/data-explorer/kusto/management/alter-query-acceleration-policy-command.md index 909267a5d2..de5338e82c 100644 --- a/data-explorer/kusto/management/alter-query-acceleration-policy-command.md +++ b/data-explorer/kusto/management/alter-query-acceleration-policy-command.md @@ -3,7 +3,7 @@ title: .alter query acceleration policy command description: Learn how to use the .alter query acceleration policy command to accelerate queries over external delta tables. ms.reviewer: sharmaanshul ms.topic: reference -ms.date: 09/16/2025 +ms.date: 11/30/2025 --- # `.alter query acceleration policy` command From a2b76b68e238a3390a5b5b7f3d5e1bef3b6705fa Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Sun, 30 Nov 2025 15:13:10 +0200 Subject: [PATCH 2/2] changes from PR#2785 --- .../alter-query-acceleration-policy-command.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-query-acceleration-policy-command.md b/data-explorer/kusto/management/alter-query-acceleration-policy-command.md index de5338e82c..7549cc4ccc 100644 --- a/data-explorer/kusto/management/alter-query-acceleration-policy-command.md +++ b/data-explorer/kusto/management/alter-query-acceleration-policy-command.md @@ -30,7 +30,9 @@ You must have at least [Database Admin](../access-control/role-based-access-cont | _JSON-serialized policy_ | `string` | :heavy_check_mark: | String literal holding a [JSON property bag](#json-property-bag). | ### JSON property bag + ::: moniker range="microsoft-fabric" + | Property | Type | Required | Description | | ------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. | @@ -38,9 +40,11 @@ You must have at least [Database Admin](../access-control/role-based-access-cont | HotWindows | `DateTime` | | One or more optional time windows. Delta data files created within these time windows are accelerated. | | 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. | | 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. | + ::: moniker-end ::: moniker range="azure-data-explorer" + | Property | Type | Required | Description | | ------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. | @@ -49,9 +53,12 @@ You must have at least [Database Admin](../access-control/role-based-access-cont | 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. | | 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). | | 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. | + ::: moniker-end + > [!NOTE] -> 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). +> +> Query acceleration is applied to data within a specific time period, based on 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) by default. You can override the default behavior, by specifying the _HotDateTimeColumn_ property in the policy. ### Example @@ -72,17 +79,23 @@ The command returns a table with one record that includes the modified policy ob | EntityType | `string` | The type of the entity the policy applies to - `ExternalTable` | ## Example + ::: moniker range="microsoft-fabric" + ```Kusto .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"}' ``` + ::: moniker-end ::: moniker range="azure-data-explorer" + ```Kusto .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"}' ``` + ::: moniker-end + ## Related content - [Query acceleration policy](query-acceleration-policy.md)