Commande .alter-merge workload_group
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Modifiez un groupe de charge de travail.
autorisations
Vous devez disposer des autorisations Cluster AllDatabasesAdmin pour exécuter cette commande.
Remarque
Le admin
rôle hérite des Cluster AllDatabasesAdmin
autorisations.
Syntaxe
.alter-merge
workload_group
WorkloadGroupName SerializedPolicyObject
En savoir plus sur les conventions de syntaxe.
Paramètres
Nom | Type | Requise | Description |
---|---|---|---|
WorkloadGroupName | string |
✔️ | Nom du groupe de charges de travail. Peut être spécifié avec la notation entre crochets ['WorkLoadGroupName']. |
SerializedPolicyObject | string |
✔️ | Représentation JSON de la stratégie. * |
*
Les stratégies suivantes s’appliquent aux groupes de charge de travail :
- classification des demandes
- limites de requête
- limite de taux de requête
- la mise en œuvre du taux de demandes limite.
Retours
La commande retourne une ligne affichant les détails du groupe de charge de travail.
Voici le schéma de la sortie retournée :
Nom | Type | Description |
---|---|---|
WorkloadGroupName | string |
Nom du groupe de charges de travail. |
WorkloadGroup | string |
Représentation JSON de la stratégie. |
Exemples
Modifier des limites spécifiques dans la stratégie de limites de requête
Modifiez des limites spécifiques dans la stratégie de limites de requête du default
groupe de charge de travail, tout en conservant les limites définies précédemment inchangées.
.alter-merge workload_group default ```
{
"RequestLimitsPolicy": {
"DataScope": {
"IsRelaxable": false,
"Value": "HotCache"
},
"MaxExecutionTime": {
"IsRelaxable": false,
"Value": "00:01:00"
}
}
} ```
Sortie
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 » :{"QueryEnforcementLevel » :"QueryHead »,"CommandsEnforcementLevel » :"Database"}} |
Modifier les stratégies de limite de taux de requête
Modifiez les stratégies de limite de débit de requête du groupe de default
charge de travail, tout en conservant toutes ses autres stratégies inchangées.
.alter-merge workload_group default ```
{
"RequestRateLimitPolicies": [
{
"IsEnabled": true,
"Scope": "WorkloadGroup",
"LimitKind": "ConcurrentRequests",
"Properties": {
"MaxConcurrentRequests": 100
}
}
]
} ```
Sortie
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 » :{"QueryEnforcementLevel » :"QueryHead »,"CommandsEnforcementLevel » :"Database"}} |
Modifier la stratégie de mise en file d’attente de requête
Activez la mise en file d’attente de requête pour le default
groupe de charge de travail, tout en conservant sa stratégie de limites de requête et ses stratégies de limite de débit de requête inchangées.
.alter-merge workload_group default ```
{
"RequestQueuingPolicy": {
"IsEnabled": true
}
} ```
Sortie
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 » :{"QueryEnforcementLevel » :\n"QueryHead »,"CommandsEnforcementLevel » :"Database"}} |
Modifier la stratégie d’application des limites de taux de requête
Activez la stratégie de mise en œuvre du taux de requête pour le default
groupe de charge de travail, tout en conservant toutes ses autres stratégies inchangées.
.alter-merge workload_group default ```
{
"RequestRateLimitsEnforcementpolicy": {
"QueriesEnforcementLevel": "QueryHead",
"CommandsEnforcementLevel": "Cluster"
}
} ```
Sortie
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 » :{"QueryEnforcementLevel » :"QueryHead »,"CommandsEnforcementLevel » :"Cluster"}} |
Modifier la stratégie de cohérence des requêtes
Spécifiez l’option applicable pour le modèle de cohérence des requêtes.
.alter-merge workload_group default ```
{
"QueryConsistencyPolicy": {
"QueryConsistency": {
"IsRelaxable": true,
"Value": "Weak"
}
}
} ```
Sortie
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 » :{"QueryEnforcementLevel » :"QueryHead »,"CommandsEnforcementLevel » :"Cluster"},"QueryConsistencyPolicy » :{"QueryConsistency » :{"IsRelaxable » :true,"Value » :"Weak"}} |