Befehl „.alter-merge“ für „workload_group“
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer
Ändern einer Workloadgruppe.
Berechtigungen
Sie müssen über Die Berechtigungen "Cluster AllDatabasesAdmin " verfügen, um diesen Befehl auszuführen.
Hinweis
Die admin
Rolle erbt Cluster AllDatabasesAdmin
Berechtigungen.
Syntax
.alter-merge
workload_group
WorkloadGroupName SerializedPolicyObject
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
Name | Type | Erforderlich | Beschreibung |
---|---|---|---|
WorkloadGroupName | string |
✔️ | Name der Arbeitsauslastungsgruppe. Kann mit Klammernotation ['WorkLoadGroupName'] angegeben werden. |
SerializedPolicyObject | string |
✔️ | JSON-Darstellung der Richtlinie. * |
*
Die folgenden Richtlinien gelten für Workloadgruppen:
- Anforderungsklassifizierung
- Anforderungsgrenzwerte
- Anforderungsratenlimit
- Die Erzwingung von Anforderungsraten wird begrenzt.
Gibt zurück
Der Befehl gibt eine Zeile mit den Details der Workloadgruppe zurück.
Es folgt das Schema der zurückgegebenen Ausgabe:
Name | Typ | Beschreibung |
---|---|---|
WorkloadGroupName | string |
Name der Arbeitsauslastungsgruppe. |
WorkloadGroup | string |
JSON-Darstellung der Richtlinie. |
Beispiele
Ändern bestimmter Grenzwerte in der Anforderungsbeschränkungsrichtlinie
Ändern Sie bestimmte Grenzwerte in der Anforderungsbeschränkungsrichtlinie der default
Workloadgruppe, während zuvor definierte Grenzwerte unverändert bleiben.
.alter-merge workload_group default ```
{
"RequestLimitsPolicy": {
"DataScope": {
"IsRelaxable": false,
"Value": "HotCache"
},
"MaxExecutionTime": {
"IsRelaxable": false,
"Value": "00:01:00"
}
}
} ```
Output
WorkloadGroupName | WorkloadGroup |
---|---|
default | {"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":500000},"MaxResultBytes":{"IsRelaxable":true,"Value":67108864}," MaxExecutionTime":{"IsRelaxable":false,"Value":"00:01:00"}},"RequestRateLimitPolicies":[{"IsEnabled":true,"Scope":"WorkloadGroup","LimitKind"".:"ConcurrentRequests","Properties":{"MaxConcurrentRequests":100}}],"RequestRateLimitsEnforcementPolicy":{"QueriesEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Database"}} |
Ändern der Richtlinien für die Anforderungsratenbegrenzung
Ändern Sie die Richtlinien für die Anforderungsratenbeschränkung der default
Workloadgruppe, während alle anderen Richtlinien unverändert bleiben.
.alter-merge workload_group default ```
{
"RequestRateLimitPolicies": [
{
"IsEnabled": true,
"Scope": "WorkloadGroup",
"LimitKind": "ConcurrentRequests",
"Properties": {
"MaxConcurrentRequests": 100
}
}
]
} ```
Output
WorkloadGroupName | WorkloadGroup |
---|---|
default | {"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":500000},"MaxResultBytes":{"IsRelaxable":true,"Value":67108864}," MaxExecutionTime":{"IsRelaxable":false,"Value":"00:01:00"}},"RequestRateLimitPolicies":[{"IsEnabled":true,"Scope":"WorkloadGroup","LimitKind"".:"ConcurrentRequests","Properties":{"MaxConcurrentRequests":100}}],"RequestRateLimitsEnforcementPolicy":{"QueriesEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Database"}} |
Ändern der Anforderungswarteschlangenrichtlinie
Aktivieren Sie die Anforderungswarteschlange für die default
Workloadgruppe, während ihre Anforderungsbeschränkungsrichtlinien und Anforderungsratengrenzrichtlinien unverändert bleiben.
.alter-merge workload_group default ```
{
"RequestQueuingPolicy": {
"IsEnabled": true
}
} ```
Output
WorkloadGroupName | WorkloadGroup |
---|---|
default | {"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":500000},"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":{"QueriesEnforcementLevel":\n"QueryHead","CommandsEnforcementLevel":"Database"}} |
Ändern der Erzwingungsrichtlinie für die Anforderungsrate
Aktivieren sie die Erzwingungsrichtlinie für die default
Workloadgruppe, während alle anderen Richtlinien unverändert bleiben.
.alter-merge workload_group default ```
{
"RequestRateLimitsEnforcementpolicy": {
"QueriesEnforcementLevel": "QueryHead",
"CommandsEnforcementLevel": "Cluster"
}
} ```
Output
WorkloadGroupName | WorkloadGroup |
---|---|
default | {"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":500000},"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":{"QueriesEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Cluster"}} |
Ändern der Abfragekonsistenzrichtlinie
Geben Sie die entsprechende Option für das Abfragekonsistenzmodell an.
.alter-merge workload_group default ```
{
"QueryConsistencyPolicy": {
"QueryConsistency": {
"IsRelaxable": true,
"Value": "Weak"
}
}
} ```
Output
WorkloadGroupName | WorkloadGroup |
---|---|
default | {"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":500000},"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":{"QueriesEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Cluster"},"QueryConsistencyPolicy":{"QueryConsistency":{"IsRelaxable":true,"Value":"Weak"}}} |