From 393794a731a34a52fb0513cc9dcf3214a85c0c0b Mon Sep 17 00:00:00 2001 From: Nati Nimni Date: Mon, 9 Feb 2026 12:22:23 -0800 Subject: [PATCH 1/5] Correct partitions formatting section in documentation Added detailed formatting guidelines for partitions in the alter-merge-mirroring-policy-command documentation. --- .../management/alter-merge-mirroring-policy-command.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-merge-mirroring-policy-command.md b/data-explorer/kusto/management/alter-merge-mirroring-policy-command.md index ee0ef18c41..206782e4b6 100644 --- a/data-explorer/kusto/management/alter-merge-mirroring-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-mirroring-policy-command.md @@ -30,7 +30,15 @@ Changes the tables's [mirroring policy](mirroring-policy.md). The mirroring poli |*Partitions*| string| | A comma-separated list of columns used to divide the data into smaller partitions. See [Partitions formatting](#partitions-formatting). | | *propertyName*, *propertyValue* | `string` | | A comma-separated list of key-value property pairs. See [supported properties](#supported-properties).| -[!INCLUDE [partitions-formatting](../includes/partitions-formatting.md)] +## Partitions formatting + +The partitions list is any combination of partition columns, specified using one of the forms shown in the following table. + +|Partition Type|Syntax|Notes| +|--|--|--| +|String column value|*PartitionName* `:` `string` `=` *ColumnName*|| +|Truncated datetime column (value)|*PartitionName* `:` `datetime` `=` (`startofyear` \| `startofmonth` \| `startofweek` \| `startofday`) `(` *ColumnName* `)`|See documentation on [startofyear](../query/startofyear-function.md), [startofmonth](../query/startofmonth-function.md), [startofweek](../query/startofweek-function.md), or [startofday](../query/startofday-function.md) functions.| +|Truncated Datetime Column Value `=` `bin` `(` *ColumnName* `,` *TimeSpan* `)`|Read more about the [bin](../query/bin-function.md) function.|| > [!NOTE] > Each partition is represented as a separate column using the *PartitionName* listed in the *Partitions* list. *PartitionName* must be a case insensitive unique string, both among other partition names and the column names of the mirrored table. From bdbe451d1aadf3043c4f467f1a1c5fc6bed16915 Mon Sep 17 00:00:00 2001 From: Nati Nimni Date: Mon, 9 Feb 2026 15:38:10 -0800 Subject: [PATCH 2/5] Create mirroring-partitions-formatting.md Add documentation for partitions formatting in Kusto. --- .../includes/mirroring-partitions-formatting.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 data-explorer/kusto/includes/mirroring-partitions-formatting.md diff --git a/data-explorer/kusto/includes/mirroring-partitions-formatting.md b/data-explorer/kusto/includes/mirroring-partitions-formatting.md new file mode 100644 index 0000000000..3a3e084cfe --- /dev/null +++ b/data-explorer/kusto/includes/mirroring-partitions-formatting.md @@ -0,0 +1,14 @@ +--- +ms.topic: include +ms.date: 02/09/2026 +--- + +## Partitions formatting + +The partitions list is any combination of partition columns, specified using one of the forms shown in the following table. + +|Partition Type|Syntax|Notes| +|--|--|--| +|String column value|*PartitionName* `:` `string` `=` *ColumnName*|| +|Truncated datetime column (value)|*PartitionName* `:` `datetime` `=` (`startofyear` \| `startofmonth` \| `startofweek` \| `startofday`) `(` *ColumnName* `)`|See documentation on [startofyear](../query/startofyear-function.md), [startofmonth](../query/startofmonth-function.md), [startofweek](../query/startofweek-function.md), or [startofday](../query/startofday-function.md) functions.| +|Truncated Datetime Column Value `=` `bin` `(` *ColumnName* `,` *TimeSpan* `)`|Read more about the [bin](../query/bin-function.md) function.|| From cf627c7307b680249cc9a56a5e888865c227714c Mon Sep 17 00:00:00 2001 From: Nati Nimni Date: Mon, 9 Feb 2026 15:52:57 -0800 Subject: [PATCH 3/5] Refactor partitions formatting in documentation Updated partitions formatting section with include directive and removed old formatting details. --- .../management/alter-merge-mirroring-policy-command.md | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/data-explorer/kusto/management/alter-merge-mirroring-policy-command.md b/data-explorer/kusto/management/alter-merge-mirroring-policy-command.md index 206782e4b6..089a35004c 100644 --- a/data-explorer/kusto/management/alter-merge-mirroring-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-mirroring-policy-command.md @@ -30,15 +30,7 @@ Changes the tables's [mirroring policy](mirroring-policy.md). The mirroring poli |*Partitions*| string| | A comma-separated list of columns used to divide the data into smaller partitions. See [Partitions formatting](#partitions-formatting). | | *propertyName*, *propertyValue* | `string` | | A comma-separated list of key-value property pairs. See [supported properties](#supported-properties).| -## Partitions formatting - -The partitions list is any combination of partition columns, specified using one of the forms shown in the following table. - -|Partition Type|Syntax|Notes| -|--|--|--| -|String column value|*PartitionName* `:` `string` `=` *ColumnName*|| -|Truncated datetime column (value)|*PartitionName* `:` `datetime` `=` (`startofyear` \| `startofmonth` \| `startofweek` \| `startofday`) `(` *ColumnName* `)`|See documentation on [startofyear](../query/startofyear-function.md), [startofmonth](../query/startofmonth-function.md), [startofweek](../query/startofweek-function.md), or [startofday](../query/startofday-function.md) functions.| -|Truncated Datetime Column Value `=` `bin` `(` *ColumnName* `,` *TimeSpan* `)`|Read more about the [bin](../query/bin-function.md) function.|| +[!INCLUDE [mirroring-partitions-formatting](../includes/mirroring-partitions-formatting.md)] > [!NOTE] > Each partition is represented as a separate column using the *PartitionName* listed in the *Partitions* list. *PartitionName* must be a case insensitive unique string, both among other partition names and the column names of the mirrored table. From 393b88ee726dc8ed5c3337b20d4aa747bb96cc04 Mon Sep 17 00:00:00 2001 From: Nati Nimni Date: Mon, 9 Feb 2026 15:55:20 -0800 Subject: [PATCH 4/5] Update include reference for partitions formatting --- data-explorer/kusto/management/mirroring-policy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/mirroring-policy.md b/data-explorer/kusto/management/mirroring-policy.md index e549d9cfe9..a4eb3970ac 100644 --- a/data-explorer/kusto/management/mirroring-policy.md +++ b/data-explorer/kusto/management/mirroring-policy.md @@ -39,7 +39,7 @@ The mirroring policy includes the following properties: [!INCLUDE [mirroring-note](../includes/mirroring-note.md)] -[!INCLUDE [partitions-formatting](../includes/partitions-formatting.md)] +[!INCLUDE [mirroring-partitions-formatting](../includes/mirroring-partitions-formatting.md)] > [!NOTE] > Each partition is represented as a separate column using the *PartitionName* listed in the *Partitions* list. *PartitionName* must be a case insensitive unique string, both among other partition names and the column names of the mirrored table. From 97066410e3bcb9b1b1d7a70cb597287cded3f7c5 Mon Sep 17 00:00:00 2001 From: Nati Nimni Date: Tue, 10 Feb 2026 15:28:24 -0800 Subject: [PATCH 5/5] Add author metadata to mirroring partitions formatting --- .../kusto/includes/mirroring-partitions-formatting.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/data-explorer/kusto/includes/mirroring-partitions-formatting.md b/data-explorer/kusto/includes/mirroring-partitions-formatting.md index 3a3e084cfe..07c2e842fc 100644 --- a/data-explorer/kusto/includes/mirroring-partitions-formatting.md +++ b/data-explorer/kusto/includes/mirroring-partitions-formatting.md @@ -1,6 +1,9 @@ --- +author: natinimni +ms.author: natinimn ms.topic: include ms.date: 02/09/2026 +ms.service: azure-data-explorer --- ## Partitions formatting