From b3f1afff284872aa020c790b0d671020c2ca3ca2 Mon Sep 17 00:00:00 2001 From: "urishapira@microsoft.com" Date: Thu, 20 Nov 2025 13:52:43 +0200 Subject: [PATCH] improvements --- ...merge-query-acceleration-policy-command.md | 15 +++++----- ...alter-query-acceleration-policy-command.md | 30 +++++++++---------- .../kusto/query/external-table-function.md | 2 +- 3 files changed, 24 insertions(+), 23 deletions(-) diff --git a/data-explorer/kusto/management/alter-merge-query-acceleration-policy-command.md b/data-explorer/kusto/management/alter-merge-query-acceleration-policy-command.md index 5e1d3c37bb..910c43ffa5 100644 --- a/data-explorer/kusto/management/alter-merge-query-acceleration-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-query-acceleration-policy-command.md @@ -35,12 +35,13 @@ You must have at least [Database Admin](../access-control/role-based-access-cont ### JSON property bag -| Property | Type | Required | Description | -| ---------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| IsEnabled | `Boolean` | | Indicates whether the policy is enabled. This property is required if no query acceleration policy is defined on the external table. | -| 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. | -| 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, external table operates in nonaccelerated mode. Default is 5 minutes. Minimum is 1 minute. | +| Property | Type | Required | Description | +| --------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| IsEnabled | `Boolean` | | Indicates whether the policy is enabled. This property is required if no query acceleration policy is defined on the external table. | +| 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. | +| 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, external table operates in nonaccelerated mode. Default is 5 minutes. Minimum is 1 minute. | +| 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. | > [!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). @@ -50,7 +51,7 @@ You must have at least [Database Admin](../access-control/role-based-access-cont In case the external table has query acceleration policy defined: ```json -{ "Hot": "1.00:00:00" } +{ "HotDateTimeColumn": "Col1" } ``` In case the external table doesn't have query acceleration policy defined: 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 4b5ad4f818..909267a5d2 100644 --- a/data-explorer/kusto/management/alter-query-acceleration-policy-command.md +++ b/data-explorer/kusto/management/alter-query-acceleration-policy-command.md @@ -31,24 +31,24 @@ You must have at least [Database Admin](../access-control/role-based-access-cont ### JSON property bag ::: moniker range="microsoft-fabric" -| Property | Type | Required | Description | -| ---------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. | -| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. | -| 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. | -| 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. | +| Property | Type | Required | Description | +| ------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. | +| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. | +| 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. | -| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. | -| 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. | -| 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. | +| Property | Type | Required | Description | +| ------------------- | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| IsEnabled | `Boolean` | :heavy_check_mark: | Indicates whether the policy is enabled. | +| Hot | `Timespan` | :heavy_check_mark: | The hot period defined in the query acceleration policy. Minimum value = 1 d. | +| 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. | +| 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). diff --git a/data-explorer/kusto/query/external-table-function.md b/data-explorer/kusto/query/external-table-function.md index 0d4ef8f71d..17888c7ab8 100644 --- a/data-explorer/kusto/query/external-table-function.md +++ b/data-explorer/kusto/query/external-table-function.md @@ -20,7 +20,7 @@ To accelerate queries over external delta tables, see [Query acceleration policy ## Syntax -`external_table(` *TableName* [`,` *MappingName* ] `)` +`external_table(` *TableName* [`,` *MappingName* / *MaxAgeOverride* ] `)` [!INCLUDE [syntax-conventions-note](../includes/syntax-conventions-note.md)]