Skip to content

Commit 6cf4b1f

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
Learn Build Service GitHub App
authored and
Learn Build Service GitHub App
committed
Merging changes synced from https://github.com/MicrosoftDocs/dataexplorer-docs-pr (branch live)
2 parents 3ca0fa1 + 6900a81 commit 6cf4b1f

File tree

39 files changed

+604
-287
lines changed

39 files changed

+604
-287
lines changed

‎data-explorer/kusto/management/alter-callout-policy-command.md‎

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter cluster policy callout command
33
description: Learn how to use the `.alter cluster policy callout` command to change the cluster's callout policy.
44
ms.reviewer: yonil
55
ms.topic: reference
6-
ms.date: 08/11/2024
6+
ms.date: 12/18/2024
77
monikerRange: "azure-data-explorer"
88
---
99
# .alter cluster policy callout command
@@ -24,19 +24,19 @@ You must have [Cluster AllDatabasesAdmin](../access-control/role-based-access-co
2424

2525
## Parameters
2626

27-
| Name | Type | Required | Description |
28-
|----------------------------------|--------|----------|----------------------------------------------------------------------------------------------------------|
29-
| *SerializedArrayOfPolicyObjects* | `string` | :heavy_check_mark: | A serialized array of JSON policy objects. See [callout policy](callout-policy.md) for policy properties. |
27+
| Name | Type | Required | Description |
28+
|--|--|--|--|
29+
| *SerializedArrayOfPolicyObjects* | `string` | :heavy_check_mark: | A serialized array of JSON policy objects. See [callout policy](callout-policy.md) for policy properties. |
3030

3131
## Returns
3232

33-
| Name | Type | Description |
34-
|---------------|--------|-----------------------------------------------------------------------------------------------------------|
35-
| PolicyName | `string` | Name of the policy. For cluster callout policy, this value is **CalloutPolicy**. |
36-
| EntityName | `string` | Name of the entity for which the policy is set. For cluster callout policy, this value is an empty string. |
37-
| Policy | `string` | JSON representation of the policy object. |
38-
| ChildEntities | `string` | Child entities for which this policy is set. For cluster callout policy, this value is an empty string. |
39-
| EntityType | `string` | Type of entity for which this policy is set. For cluster callout policy, this value is an empty string. |
33+
| Name | Type | Description |
34+
|--|--|--|
35+
| PolicyName | `string` | Name of the policy. For cluster callout policy, this value is **CalloutPolicy**. |
36+
| EntityName | `string` | Name of the entity for which the policy is set. For cluster callout policy, this value is an empty string. |
37+
| Policy | `string` | JSON representation of the policy object. |
38+
| ChildEntities | `string` | Child entities for which this policy is set. For cluster callout policy, this value is an empty string. |
39+
| EntityType | `string` | Type of entity for which this policy is set. For cluster callout policy, this value is an empty string. |
4040

4141
## Examples
4242

@@ -59,6 +59,13 @@ Define permitted callouts for the cluster callout policy.
5959

6060
**Output**
6161

62-
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
63-
|---------------|------------|-------------------------------------------------------------------------------------------------------|---------------|------------|
64-
| CalloutPolicy | | [{"CalloutType":"sql","CalloutUriRegex":"sqlname\\\\.database\\\\.azure\\\\.com/?$","CanCall": true}] | | |
62+
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
63+
|--|--|--|--|--|
64+
| CalloutPolicy | | [{"CalloutType":"sql","CalloutUriRegex":"sqlname\\\\.database\\\\.azure\\\\.com/?$","CanCall": true}] | | |
65+
66+
## Related content
67+
68+
* [Callout policy](callout-policy.md)
69+
* [.show cluster policy callout command](show-cluster-callout-policy-command.md)
70+
* [.alter-merge cluster policy callout command](alter-merge-callout-policy-command.md)
71+
* [.delete cluster policy callout command](delete-callout-policy-command.md)

‎data-explorer/kusto/management/alter-cluster-policy-request-classification-command.md‎

Lines changed: 35 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter cluster policy request_classification command
33
description: Learn how to use the `.alter cluster policy request_classification` command to alter the request classification policy.
44
ms.reviewer: yonil
55
ms.topic: reference
6-
ms.date: 08/11/2024
6+
ms.date: 01/01/2025
77
---
88
# .alter cluster policy request_classification command
99

@@ -13,7 +13,7 @@ ms.date: 08/11/2024
1313
Alters the cluster's request classification policy.
1414
::: moniker-end
1515
:::moniker range="microsoft-fabric"
16-
Alters the eventhouse's request classification policy.
16+
Alters the Eventhouse's request classification policy.
1717
::: moniker-end
1818

1919
## Permissions
@@ -33,39 +33,39 @@ You must have [Cluster AllDatabasesAdmin](../access-control/role-based-access-co
3333

3434
## Parameters
3535

36-
| Name | Type | Required | Description |
37-
|------------------------------|--------|----------|--------------------------------------------------------------------------------------------------------------------------------|
38-
| *SerializedPartialPolicy* | `string` | :heavy_check_mark: | Define a serialized JSON policy. For policy properties, see [request classification policy](request-classification-policy.md). |
39-
| *ClassificationFunctionBody* | `string` | :heavy_check_mark: | The body of the function to use for classifying requests. |
36+
| Name | Type | Required | Description |
37+
|--|--|--|--|
38+
| *SerializedPartialPolicy* | `string` | :heavy_check_mark: | Define a serialized JSON policy. For policy properties, see [request classification policy](request-classification-policy.md). |
39+
| *ClassificationFunctionBody* | `string` | :heavy_check_mark: | The body of the function to use for classifying requests. |
4040

4141
## Returns
4242

4343
:::moniker range="azure-data-explorer"
4444
The command returns one row showing the details of the cluster request classification policy.
4545
::: moniker-end
4646
:::moniker range="microsoft-fabric"
47-
The command returns one row showing the details of the eventhouse request classification policy.
47+
The command returns one row showing the details of the Eventhouse request classification policy.
4848
::: moniker-end
4949

5050
Following is the schema of the output returned:
5151

5252
:::moniker range="azure-data-explorer"
53-
| Name | Type | Description |
54-
|---------------|--------|--------------------------------------------------------------------------------------------------------------------------|
55-
| PolicyName | `string` | Name of the policy. For cluster request classification policy this value is **ClusterRequestClassificationPolicy**. |
56-
| EntityName | `string` | Name of the entity for which the policy is set. For cluster request classification policy this value is an empty string. |
57-
| Policy | `string` | JSON representation of the policy object. |
58-
| ChildEntities | `string` | Child entities for which this policy is set. For cluster request classification policy this value is an empty string. |
59-
| EntityType | `string` | Type of entity for which this policy is set. For cluster request classification policy this value is an empty string. |
53+
| Name | Type | Description |
54+
|--|--|--|
55+
| PolicyName | `string` | Name of the policy. For cluster request classification policy, this value is **ClusterRequestClassificationPolicy**. |
56+
| EntityName | `string` | Name of the entity for which the policy is set. For cluster request classification policy, this value is an empty string. |
57+
| Policy | `string` | JSON representation of the policy object. |
58+
| ChildEntities | `string` | Child entities for which this policy is set. For cluster request classification policy, this value is an empty string. |
59+
| EntityType | `string` | Type of entity for which this policy is set. For cluster request classification policy, this value is an empty string. |
6060
::: moniker-end
6161
:::moniker range="microsoft-fabric"
62-
| Name | Type | Description |
63-
|---------------|--------|--------------------------------------------------------------------------------------------------------------------------|
64-
| PolicyName | `string` | Name of the policy. For eventhouse request classification policy this value is **ClusterRequestClassificationPolicy**. |
65-
| EntityName | `string` | Name of the entity for which the policy is set. For eventhouse request classification policy this value is an empty string. |
66-
| Policy | `string` | JSON representation of the policy object. |
67-
| ChildEntities | `string` | Child entities for which this policy is set. For eventhouse request classification policy this value is an empty string. |
68-
| EntityType | `string` | Type of entity for which this policy is set. For eventhouse request classification policy this value is an empty string. |
62+
| Name | Type | Description |
63+
|--|--|--|
64+
| PolicyName | `string` | Name of the policy. For Eventhouse request classification policy, this value is **ClusterRequestClassificationPolicy**. |
65+
| EntityName | `string` | Name of the entity for which the policy is set. For Eventhouse request classification policy, this value is an empty string. |
66+
| Policy | `string` | JSON representation of the policy object. |
67+
| ChildEntities | `string` | Child entities for which this policy is set. For Eventhouse request classification policy, this value is an empty string. |
68+
| EntityType | `string` | Type of entity for which this policy is set. For Eventhouse request classification policy, this value is an empty string. |
6969
::: moniker-end
7070

7171
## Examples
@@ -87,9 +87,9 @@ Set a policy which, based on the evaluation of multiple conditions, assigns the
8787

8888
**Output**
8989

90-
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
91-
|------------------------------------|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|------------|
92-
| ClusterRequestClassificationPolicy | | {"ClassificationProperties": ["current_database", "request_description", "current_application", "current_principal", "request_type"], "IsEnabled": true, "ClassificationFunction": "case(current_principal_is_member_of('aadgroup=somesecuritygroup@contoso.com'), \"First workload group\", request_properties.current_database == \"MyDatabase\" and request_properties.current_principal has 'aadapp=', \"Second workload group\", request_properties.current_application == \"Kusto.Explorer\" and request_properties.request_type == \"Query\", \"Third workload group\", request_properties.current_application == \"KustoQueryRunner\", \"Fourth workload group\", request_properties.request_description == \"this is a test\", \"Fifth workload group\", hourofday(now()) between (17 .. 23), \"Sixth workload group\", \"default\")"} | | |
90+
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
91+
|--|--|--|--|--|
92+
| ClusterRequestClassificationPolicy | | {"ClassificationProperties": ["current_database", "request_description", "current_application", "current_principal", "request_type"], "IsEnabled": true, "ClassificationFunction": "case(current_principal_is_member_of('aadgroup=somesecuritygroup@contoso.com'), \"First workload group\", request_properties.current_database == \"MyDatabase\" and request_properties.current_principal has 'aadapp=', \"Second workload group\", request_properties.current_application == \"Kusto.Explorer\" and request_properties.request_type == \"Query\", \"Third workload group\", request_properties.current_application == \"KustoQueryRunner\", \"Fourth workload group\", request_properties.request_description == \"this is a test\", \"Fifth workload group\", hourofday(now()) between (17 .. 23), \"Sixth workload group\", \"default\")"} | | |
9393

9494
### Set a policy with a single workload group
9595

@@ -104,6 +104,14 @@ Set a policy which, based on the evaluation of a composed condition, assigns the
104104

105105
**Output**
106106

107-
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
108-
|------------------------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|------------|
109-
| ClusterRequestClassificationPolicy | | {"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": true, "ClassificationFunction": "iff(request_properties.current_application == \"Kusto.Explorer\" and request_properties.request_type == \"Query\",\"Ad-hoc queries\",\"default\")"} | | |
107+
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
108+
|--|--|--|--|--|
109+
| ClusterRequestClassificationPolicy | | {"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": true, "ClassificationFunction": "iff(request_properties.current_application == \"Kusto.Explorer\" and request_properties.request_type == \"Query\",\"Ad-hoc queries\",\"default\")"} | | |
110+
111+
## Related content
112+
113+
* [Workload groups](workload-groups.md)
114+
* [Request classification policy](request-classification-policy.md)
115+
* [`.alter-merge cluster request classification policy`](alter-merge-cluster-policy-request-classification-command.md)
116+
* [`.delete cluster request classification policy`](delete-cluster-policy-request-classification-command.md)
117+
* [`.show cluster request classification policy`](show-cluster-policy-request-classification-command.md)

‎data-explorer/kusto/management/alter-database-sharding-policy-command.md‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter database policy sharding command
33
description: Learn how to use the `.alter database policy sharding` command to change the database's sharding policy.
44
ms.reviewer: yonil
55
ms.topic: reference
6-
ms.date: 08/11/2024
6+
ms.date: 12/22/2024
77
monikerRange: "azure-data-explorer"
88
---
99
# .alter database policy sharding command
@@ -49,3 +49,12 @@ The following command returns the updated extents sharding policy for the databa
4949
}
5050
```
5151
````
52+
53+
## Related content
54+
55+
* [Data sharding policy](sharding-policy.md)
56+
* [.alter table policy sharding command](alter-table-sharding-policy-command.md)
57+
* [.show database policy sharding command](show-database-sharding-policy-command.md)
58+
* [.alter-merge database policy sharding command](alter-merge-database-sharding-policy-command.md)
59+
* [.delete database policy sharding command](delete-database-sharding-policy-command.md)
60+
* [Extents (data shards)](extents-overview.md)

‎data-explorer/kusto/management/alter-database-streaming-ingestion-policy-command.md‎

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter database policy streamingingestion command
33
description: Learn how to use the `.alter database policy streamingingestion` command to change the database streaming ingestion policy.
44
ms.reviewer: yonil
55
ms.topic: reference
6-
ms.date: 08/11/2024
6+
ms.date: 12/22/2024
77
monikerRange: "azure-data-explorer"
88
---
99
# .alter database policy streamingingestion command
@@ -14,7 +14,7 @@ Changes the database streaming ingestion policy. The [streaming policy](../manag
1414

1515
Streaming ingestion is best suited for low latency scenarios where the ingestion time is under 10 seconds for varying data volume. It can optimize processing for multiple tables across one or more databases, especially when the tables receive only a few records per second but the ingestion volume is thousands of records per second.
1616

17-
However, when the amount of data grows beyond 4 Gb per hour per table, it's recommended to switch to classic bulk ingestion instead of streaming ingestion.
17+
However, when the amount of data grows beyond 4 GB per hour per table, we recommend switching to classic bulk ingestion instead of streaming ingestion.
1818

1919
To learn how to implement streaming ingestion, see [streaming ingestion](/azure/data-explorer/ingest-data-streaming).
2020
Streaming ingestion must be enabled at the cluster level before it can be used at the database level.
@@ -48,3 +48,12 @@ The following command enables streaming ingestion and determines the suggestion
4848
.alter database MyDatabase policy streamingingestion
4949
'{"IsEnabled": true, "HintAllocatedRate": 2.1}'
5050
```
51+
52+
## Related content
53+
54+
* [Streaming ingestion policy](streaming-ingestion-policy.md)
55+
* [.alter table policy streamingingestion command](alter-table-streaming-ingestion-policy-command.md)
56+
* [.show database policy streamingingestion command](show-database-streaming-ingestion-policy-command.md)
57+
* [.alter-merge database policy streamingingestion command](alter-merge-database-streaming-ingestion-policy-command.md)
58+
* [.delete database policy streamingingestion command](delete-database-streaming-ingestion-policy-command.md)
59+
* [Streaming ingestion and schema changes](data-ingestion/streaming-ingestion-schema-changes.md)

0 commit comments

Comments
 (0)