Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion data-explorer/kusto/includes/cached-group-membership.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@ ms.topic: include
ms.date: 10/27/2024
---

Checking group memberships can be resource-intensive. Since group memberships don't change frequently, the results of membership checks are cached. The caching duration varies and is influenced by factors such as the membership result (whether the principal is a member or not), the type of principal (user or application), among others. The maximum caching duration can extend up to three hours, while the minimum duration is 30 minutes.
Checking group memberships can be resource-intensive. Since group memberships dont change frequently, the membership check results are cached. The caching duration varies and determines how quickly changes to group memberships are updated. Adding a user to a group can take up to 30 minutes to propagate. Removing a user from a group can take up to three hours.
Original file line number Diff line number Diff line change
Expand Up @@ -37,12 +37,12 @@ The following properties are supported as part of the export to external table c
| Property | Type | Description | Default |
|--|--|--|--|
| `sizeLimit` | `long` | The size limit in bytes of a single storage artifact written before compression. A full row group of size `parquetRowGroupSize` is written before checking whether this row group reaches the size limit and should start a new artifact. Valid range: 100 MB (default) to 1 GB. | |
| `distributed` | `bool` | Disable or enable distributed export. Setting to false is equivalent to `single` distribution hint. | Default is `true`. |
| `distribution` | `string` | Distribution hint (`single`, `per_node`, `per_shard`). See more details in [Distribution settings](#distribution-settings) | Default is `per_node`. |
| `distributed` | `bool` | Disable or enable distributed export. Setting to false is equivalent to `single` distribution hint. | `true` |
| `distribution` | `string` | Distribution hint (`single`, `per_node`, `per_shard`). See more details in [Distribution settings](#distribution-settings) | `per_node` |
| `distributionKind` | `string` | Optionally switches to uniform distribution when the external table is partitioned by string partition. Valid values are `uniform` or `default`. See more details in [Distribution settings](#distribution-settings) | |
| `concurrency` | *Number* | Hints the system how many partitions to run in parallel. See more details in [Distribution settings](#distribution-settings) | The default value is 16. |
| `spread` | *Number* | Hints the system how to distribute the partitions among nodes. See more details in [Distribution settings](#distribution-settings) | The default value is `Min(64, number-of-nodes)`. |
| `parquetRowGroupSize` | `int` | Relevant only when data format is Parquet. Controls the row group size in the exported files. This value takes precedence over `sizeLimit`, meaning a full row group will be exported before checking whether this row group reaches the size limit and should start a new artifact. | Default row group size is 100,000 records. |
| `concurrency` | *Number* | Hints the system how many partitions to run in parallel. See more details in [Distribution settings](#distribution-settings) | 16 |
| `spread` | *Number* | Hints the system how to distribute the partitions among nodes. See more details in [Distribution settings](#distribution-settings) | `Min(64, number-of-nodes)` |
| `parquetRowGroupSize` | `int` | Relevant only when data format is Parquet. Controls the row group size in the exported files. This value takes precedence over `sizeLimit`, meaning a full row group will be exported before checking whether this row group reaches the size limit and should start a new artifact. | 100,000 |

### Distribution settings

Expand Down
2 changes: 1 addition & 1 deletion data-explorer/kusto/management/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -848,7 +848,7 @@ items:
items:
- name: .export to storage
href: data-export/export-data-to-storage.md
- name: .export totable
- name: .export to table
href: data-export/export-data-to-an-external-table.md
- name: .export to SQL
href: data-export/export-data-to-sql.md
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ Checks group membership or principal identity of the current principal running t
>
> - To avoid throttling from Microsoft Entra ID, the `current_principal_is_member_of()` function only works with string literals. Using values that aren't string literals will result in an error in order to avoid a potentially large number of queries to Microsoft Entra ID.
> - [!INCLUDE [Cached Group Membership](../includes/cached-group-membership.md)]
> - For more information on Group Membership cache behavior, see [Access control overview](../access-control/index.md).

## Returns

Expand Down
Loading