Skip to content

Correct partitions formatting section in mirroring policy documentation #2842

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ttorble merged 5 commits into from
Feb 11, 2026
Merged

Correct partitions formatting section in mirroring policy documentation #2842

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
393794a
Correct partitions formatting section in documentation
natinimni Feb 9, 2026
bdbe451
Create mirroring-partitions-formatting.md
natinimni Feb 9, 2026
cf627c7
Refactor partitions formatting in documentation
natinimni Feb 9, 2026
393b88e
Update include reference for partitions formatting
natinimni Feb 9, 2026
9706641
Add author metadata to mirroring partitions formatting
natinimni Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion data-explorer/kusto/management/alter-merge-mirroring-policy-command.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Copy link

Copilot AI Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section inlines partitions formatting that previously came from a shared include (../includes/partitions-formatting.md), which is still used by other docs (for example, management/mirroring-policy.md). Duplicating the content here increases the chance the formatting guidance drifts between pages. Consider restoring the include (and updating the include itself if the guidance needs correction), or creating a mirroring-specific include and using it consistently across mirroring docs.

Copilot uses AI. Check for mistakes.
|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.|
Copy link

Copilot AI Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The inlined partitions formatting table doesn’t match the previously included shared content: it omits entries like “Virtual column” and “String column value hash()” that are currently shown on other pages via the include. This creates conflicting guidance for the same partition by syntax across the docs set. Either add the missing rows here or adjust the shared include (or introduce a mirroring-specific include) so the supported partition types are documented consistently.

Copilot uses AI. Check for mistakes.
|Truncated Datetime Column Value `=` `bin` `(` *ColumnName* `,` *TimeSpan* `)`|Read more about the [bin](../query/bin-function.md) function.||
Copy link

Copilot AI Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The bin() row in the partitions formatting table is malformed: the first cell currently contains a mix of “Partition Type” and syntax, and the syntax doesn’t include the partition name/type prefix (consistent with the rows above). This will render confusingly and may break the table layout. Please split this into the 3 intended columns (Partition Type / Syntax / Notes) and align the syntax pattern with the other entries (including PartitionName and the datetime = ... form).

Copilot uses AI. Check for mistakes.

> [!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.
Expand Down