Opdracht .alter-merge workload_group
Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer-
Een workloadgroep wijzigen.
Machtigingen
U moet beschikken over Cluster AllDatabasesAdmin--machtigingen om deze opdracht uit te voeren.
Notitie
De admin
rol neemt Cluster AllDatabasesAdmin
machtigingen over.
Syntaxis
.alter-merge
workload_group
WorkloadGroupNameSerializedPolicyObject
Meer informatie over syntaxisconventies.
Parameters
Naam | Type | Vereist | Beschrijving |
---|---|---|---|
WorkloadGroupName- | string |
✔️ | Naam van de workloadgroep. Kan worden opgegeven met vierkante haak notatie ['WorkLoadGroupName']. |
SerializedPolicyObject | string |
✔️ | JSON-weergave van het beleid. * |
*
De volgende beleidsregels zijn van toepassing op workloadgroepen:
- aanvraagclassificatie
- aanvraaglimieten
- aanvraagsnelheidslimiet
- afdwingen van frequentielimieten
- queryconsistentiemodus opgeven
Retourneert
De opdracht retourneert één rij met de details van de workloadgroep.
Hier volgt het schema van de geretourneerde uitvoer:
Naam | Type | Beschrijving |
---|---|---|
WorkloadGroupName | string |
Naam van de workloadgroep. |
WorkloadGroup | string |
JSON-weergave van het beleid. |
Voorbeelden
Specifieke limieten wijzigen in het beleid voor aanvraaglimieten
Wijzig specifieke limieten in het beleid voor aanvraaglimieten van de default
workloadgroep, terwijl eerder gedefinieerde limieten ongewijzigd blijven.
.alter-merge workload_group default ```
{
"RequestLimitsPolicy": {
"DataScope": {
"IsRelaxable": false,
"Value": "HotCache"
},
"MaxExecutionTime": {
"IsRelaxable": false,
"Value": "00:01:00"
}
}
} ```
uitvoer
WorkloadGroupName | WorkloadGroup |
---|---|
verstek | {"RequestLimitsPolicy":{"DataScope":{"IsRelaxable":false,"Value":"HotCache"},"MaxMemoryPerQueryPerNode":{"IsRelaxable"::true,"Value":8589699072},"MaxMemoryPerIterator":{"IsRelaxable":true,"Value":5368709120},"MaxFanoutThreadsPercentage":{"IsRelaxable":true,"Value":100},"MaxFanoutNodesPercentage":{"IsRelaxable":true,"Value":100},"MaxResultRecords":{"IsRelaxable":true,"Value":5000000},"MaxResultBytes":{"IsRelaxable":true,"Value":67108864}," MaxExecutionTime":{"IsRelaxable":false,"Value":"00:01:00"}},"RequestRateLimitPolicies":[{"IsEnabled":true,"Scope":"WorkloadGroup","LimitKind":""ConcurrentRequests","Properties":{"MaxConcurrentRequests":100}}],"RequestRateLimitsEnforcementPolicy":{"QuerysEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Database"}} |
Het beleid voor aanvraagfrequentielimieten wijzigen
Wijzig het beleid voor aanvraagsnelheidslimieten van de default
workloadgroep, terwijl alle andere beleidsregels ongewijzigd blijven.
.alter-merge workload_group default ```
{
"RequestRateLimitPolicies": [
{
"IsEnabled": true,
"Scope": "WorkloadGroup",
"LimitKind": "ConcurrentRequests",
"Properties": {
"MaxConcurrentRequests": 100
}
}
]
} ```
uitvoer
WorkloadGroupName | WorkloadGroup |
---|---|
verstek | {"RequestLimitsPolicy":{"DataScope":{"IsRelaxable":false,"Value":"HotCache"},"MaxMemoryPerQueryPerNode":{"IsRelaxable"::true,"Value":8589699072},"MaxMemoryPerIterator":{"IsRelaxable":true,"Value":5368709120},"MaxFanoutThreadsPercentage":{"IsRelaxable":true,"Value":100},"MaxFanoutNodesPercentage":{"IsRelaxable":true,"Value":100},"MaxResultRecords":{"IsRelaxable":true,"Value":5000000},"MaxResultBytes":{"IsRelaxable":true,"Value":67108864}," MaxExecutionTime":{"IsRelaxable":false,"Value":"00:01:00"}},"RequestRateLimitPolicies":[{"IsEnabled":true,"Scope":"WorkloadGroup","LimitKind":""ConcurrentRequests","Properties":{"MaxConcurrentRequests":100}}],"RequestRateLimitsEnforcementPolicy":{"QuerysEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Database"}} |
Het wachtrijbeleid voor aanvragen wijzigen
Schakel wachtrijen voor aanvragen in voor de default
workloadgroep, terwijl het beleid voor aanvraaglimieten en het beleid voor aanvraagsnelheidslimiet ongewijzigd blijft.
.alter-merge workload_group default ```
{
"RequestQueuingPolicy": {
"IsEnabled": true
}
} ```
uitvoer
WorkloadGroupName | WorkloadGroup |
---|---|
verstek | {"RequestLimitsPolicy":{"DataScope":{"IsRelaxable":false,"Value":"HotCache"},"MaxMemoryPerQueryPerNode":{"IsRelaxable"::true,"Value":8589699072},"MaxMemoryPerIterator":{"IsRelaxable":true,"Value":5368709120},"MaxFanoutThreadsPercentage":{"IsRelaxable":true,"Value":100},"MaxFanoutNodesPercentage":{"IsRelaxable":true,"Value":100},"MaxResultRecords":{"IsRelaxable":true,"Value":5000000},"MaxResultBytes":{"IsRelaxable":true,"Value":67108864}," MaxExecutionTime":{"IsRelaxable":false,"Value":"00:01:00"}},"RequestRateLimitPolicies":[{"IsEnabled":true,"Scope":"WorkloadGroup","LimitKind":"ConcurrentRequests","Properties":{"" MaxConcurrentRequests":100}}],"RequestQueuingPolicy":{"IsEnabled":true},"RequestRateLimitsEnforcementPolicy":{"QuerysEnforcementLevel":\n"QueryHead","CommandsEnforcementLevel":"Database"}} |
Het afdwingingsbeleid voor aanvraagfrequentielimieten wijzigen
Schakel het afdwingingsbeleid voor aanvraagfrequentielimieten in voor de default
workloadgroep, terwijl alle andere beleidsregels ongewijzigd blijven.
.alter-merge workload_group default ```
{
"RequestRateLimitsEnforcementpolicy": {
"QueriesEnforcementLevel": "QueryHead",
"CommandsEnforcementLevel": "Cluster"
}
} ```
uitvoer
WorkloadGroupName | WorkloadGroup |
---|---|
verstek | {"RequestLimitsPolicy":{"DataScope":{"IsRelaxable":false,"Value":"HotCache"},"MaxMemoryPerQueryPerNode":{"IsRelaxable"::true,"Value":8589699072},"MaxMemoryPerIterator":{"IsRelaxable":true,"Value":5368709120},"MaxFanoutThreadsPercentage":{"IsRelaxable":true,"Value":100},"MaxFanoutNodesPercentage":{"IsRelaxable":true,"Value":100},"MaxResultRecords":{"IsRelaxable":true,"Value":5000000},"MaxResultBytes":{"IsRelaxable":true,"Value":67108864}," MaxExecutionTime":{"IsRelaxable":false,"Value":"00:01:00"}},"RequestRateLimitPolicies":[{"IsEnabled":true,"Scope":"WorkloadGroup","LimitKind":"ConcurrentRequests","Properties"::{"MaxConcurrentRequests":100}}],"RequestQueuingPolicy":{"IsEnabled":true},"RequestRateLimitsEnforcementPolicy":{"QuerysEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Cluster"}} |
Het consistentiebeleid voor query's wijzigen
Geef de toepasselijke optie op voor het queryconsistentiemodel.
.alter-merge workload_group default ```
{
"QueryConsistencyPolicy": {
"QueryConsistency": {
"IsRelaxable": true,
"Value": "Weak"
}
}
} ```
uitvoer
WorkloadGroupName | WorkloadGroup |
---|---|
verstek | {"RequestLimitsPolicy":{"DataScope":{"IsRelaxable":false,"Value":"HotCache"},"MaxMemoryPerQueryPerNode":{"IsRelaxable"::true,"Value":8589699072},"MaxMemoryPerIterator":{"IsRelaxable":true,"Value":5368709120},"MaxFanoutThreadsPercentage":{"IsRelaxable":true,"Value":100},"MaxFanoutNodesPercentage":{"IsRelaxable":true,"Value":100},"MaxResultRecords":{"IsRelaxable":true,"Value":5000000},"MaxResultBytes":{"IsRelaxable":true,"Value":67108864}," MaxExecutionTime":{"IsRelaxable":false,"Value":"00:01:00"}},"RequestRateLimitPolicies":[{"IsEnabled":true,"Scope":"WorkloadGroup","LimitKind":"ConcurrentRequests","Properties":{"MaxConcurrentRequests"::100}}],,"RequestQueuingPolicy":{"IsEnabled":true},"RequestRateLimitsEnforcementPolicy":{"QuerysEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Cluster"},"QueryConsistencyPolicy":{"QueryConsistency":{"IsRelaxable":true,"Value":"Weak"}} |