Skip to content

Commit 4ba24a7

Browse files
author
Jill Grant
authored
Merge pull request #6480 from mjosephym/336217-kql-related2
related content 2
2 parents fbabe4d + f020ccd commit 4ba24a7

23 files changed

+283
-78
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-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)

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

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter-merge cluster policy callout command
33
description: Learn how to use the `.alter-merge cluster policy callout` command to turn on or turn off a 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-merge 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

@@ -55,12 +55,19 @@ You must have [Cluster AllDatabasesAdmin](../access-control/role-based-access-co
5555

5656
**Output**
5757

58-
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
59-
|---------------|------------|------------------------------------------------------------------------------------------------------|---------------|------------|
60-
| CalloutPolicy | | [{"CalloutType":"sql","CalloutUriRegex":"sqlname\\\\.database\\\\.azure\\\\.com/?$","CanCall":true}] | | |
58+
| PolicyName | EntityName | Policy | ChildEntities | EntityType |
59+
|--|--|--|--|--|
60+
| CalloutPolicy | | [{"CalloutType":"sql","CalloutUriRegex":"sqlname\\\\.database\\\\.azure\\\\.com/?$","CanCall":true}] | | |
6161

6262
## Remarks
6363

6464
If the callout policies currently defined for the cluster already contain one defined for the exact same combination of CalloutType and CalloutUriRegex provided in any of the policies passed to this command, that policy's CanCall property is set to whatever value is specified in this command.
6565

6666
All other objects passed in the array are simply merged/added to the existing cluster policy.
67+
68+
## Related content
69+
70+
* [Callout policy](callout-policy.md)
71+
* [.show cluster policy callout command](show-cluster-callout-policy-command.md)
72+
* [.alter cluster policy callout command](alter-callout-policy-command.md)
73+
* [.delete cluster policy callout command](delete-callout-policy-command.md)

‎data-explorer/kusto/management/alter-merge-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-merge database policy sharding command
33
description: Learn how to use the `.alter-merge database policy sharding` command to change the database 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-merge database policy sharding command
@@ -43,3 +43,12 @@ The following command changes a single property for the sharding policy for a da
4343
.alter-merge database MyDatabase policy sharding
4444
@'{ "MaxExtentSizeInMb": 1024}'
4545
```
46+
47+
## Related content
48+
49+
* [Data sharding policy](sharding-policy.md)
50+
* [.alter-merge table policy sharding command](alter-merge-table-sharding-policy-command.md)
51+
* [.show database policy sharding command](show-database-sharding-policy-command.md)
52+
* [.alter database policy sharding command](alter-database-sharding-policy-command.md)
53+
* [.delete database policy sharding command](delete-database-sharding-policy-command.md)
54+
* [Extents (data shards)](extents-overview.md)

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

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter-merge database policy streamingingestion command
33
description: Learn how to use the `.alter-merge database policy streamingingestion` command to change the database streaming 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-merge database policy streamingingestion command
@@ -54,3 +54,10 @@ The following command disables the streaming ingestion policy:
5454
.alter-merge database MyDatabase policy streamingingestion
5555
'{"IsEnabled": false}'
5656
```
57+
58+
* [Streaming ingestion policy](streaming-ingestion-policy.md)
59+
* [.alter-merge table policy streamingingestion command](alter-merge-table-streaming-ingestion-policy-command.md)
60+
* [.show database policy streamingingestion command](show-database-streaming-ingestion-policy-command.md)
61+
* [.alter database policy streamingingestion command](alter-database-streaming-ingestion-policy-command.md)
62+
* [.delete database policy streamingingestion command](delete-database-streaming-ingestion-policy-command.md)
63+
* [Streaming ingestion and schema changes](data-ingestion/streaming-ingestion-schema-changes.md)

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

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter-merge table policy sharding command
33
description: Learn how to use the `.alter-merge table policy sharding` command to change the table'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-merge table policy sharding command
@@ -43,3 +43,12 @@ The following command changes a single property for the sharding policy for a ta
4343
.alter-merge table MyTable policy sharding
4444
@'{ "MaxExtentSizeInMb": 1024}'
4545
```
46+
47+
## Related content
48+
49+
* [Data sharding policy](sharding-policy.md)
50+
* [.alter-merge database policy sharding command](alter-merge-database-sharding-policy-command.md)
51+
* [.show table policy sharding command](show-table-sharding-policy-command.md)
52+
* [.alter table policy sharding command](alter-table-sharding-policy-command.md)
53+
* [.delete table policy sharding command](delete-table-sharding-policy-command.md)
54+
* [Extents (data shards)](extents-overview.md)

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

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter-merge table policy streamingingestion command
33
description: Learn how to use the `.alter-merge table policy streamingingestion` command to change the table's 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-merge table policy streamingingestion command
@@ -14,7 +14,7 @@ Changes the table's streaming ingestion policy. Use the [streaming policy](../ma
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, it's recommended to switch 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

@@ -54,3 +54,13 @@ The following command disables the streaming ingestion policy:
5454
.alter-merge table MyTable policy streamingingestion
5555
'{"IsEnabled": false}'
5656
```
57+
58+
## Related content
59+
60+
* [Streaming ingestion policy](streaming-ingestion-policy.md)
61+
* [.alter database policy streamingingestion command](alter-database-streaming-ingestion-policy-command.md)
62+
* [.show database policy streamingingestion command](show-database-streaming-ingestion-policy-command.md)
63+
* [.show table policy streamingingestion command](show-table-streaming-ingestion-policy-command.md)
64+
* [.alter table policy streamingingestion command](alter-table-streaming-ingestion-policy-command.md)
65+
* [.delete database policy streamingingestion command](delete-database-streaming-ingestion-policy-command.md)
66+
* [.delete table policy streamingingestion command](delete-table-streaming-ingestion-policy-command.md)

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

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter table policy sharding command
33
description: Learn how to use the `.alter table policy sharding` command to change the table 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 table policy sharding command
@@ -49,3 +49,12 @@ The following command returns the updated extents sharding policy for the table.
4949
}
5050
```
5151
````
52+
53+
## Related content
54+
55+
* [Data sharding policy](sharding-policy.md)
56+
* [.alter database policy sharding command](alter-database-sharding-policy-command.md)
57+
* [.show table policy sharding command](show-table-sharding-policy-command.md)
58+
* [.alter-merge table policy sharding command](alter-merge-table-sharding-policy-command.md)
59+
* [.delete table policy sharding command](delete-table-sharding-policy-command.md)
60+
* [Extents (data shards)](extents-overview.md)

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

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: .alter table policy streamingingestion command
33
description: Learn how to use the `.alter table policy streamingingestion` command to change the table streaming policy ingestion.
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 table policy streamingingestion command
@@ -46,3 +46,13 @@ The following command turns on streaming ingestion and determines the suggested
4646
```kusto
4747
.alter table Table1 policy streamingingestion '{"IsEnabled": true, "HintAllocatedRate": 2.1}'
4848
```
49+
50+
## Related content
51+
52+
* [Streaming ingestion policy](streaming-ingestion-policy.md)
53+
* [.show table policy streamingingestion command](show-table-streaming-ingestion-policy-command.md)
54+
* [.alter table policy streamingingestion command](alter-table-streaming-ingestion-policy-command.md)
55+
* [.alter-merge table policy streamingingestion command](alter-merge-table-streaming-ingestion-policy-command.md)
56+
* [.delete table policy streamingingestion command](delete-table-streaming-ingestion-policy-command.md)
57+
* [.alter database policy streamingingestion command](alter-database-streaming-ingestion-policy-command.md)
58+
* [Streaming ingestion and schema changes](data-ingestion/streaming-ingestion-schema-changes.md)

0 commit comments

Comments
 (0)