Commande .create-or-alter workload_group
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Créez un groupe de charge de travail ou modifiez un groupe de charge de travail existant.
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
.create-or-alter
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 du groupe de charge de travail. |
Exemples
Définir une stratégie de limites de requête
Créez un groupe de charge de travail MyWorkloadGroup avec une définition complète de sa stratégie de limites de requête :
.create-or-alter workload_group MyWorkloadGroup ```
{
"RequestLimitsPolicy": {
"DataScope": {
"IsRelaxable": true,
"Value": "HotCache"
},
"MaxMemoryPerQueryPerNode": {
"IsRelaxable": false,
"Value": 6442450944
},
"MaxMemoryPerIterator": {
"IsRelaxable": false,
"Value": 5368709120
},
"MaxFanoutThreadsPercentage": {
"IsRelaxable": true,
"Value": 100
},
"MaxFanoutNodesPercentage": {
"IsRelaxable": true,
"Value": 100
},
"MaxResultRecords": {
"IsRelaxable": true,
"Value": 500000
},
"MaxResultBytes": {
"IsRelaxable": true,
"Value": 67108864
},
"MaxExecutionTime": {
"IsRelaxable": true,
"Value": "00:04:00"
},
"QueryResultsCacheMaxAge": {
"IsRelaxable": true,
"Value": "00:05:00"
}
}
} ```
Sortie
WorkloadGroupName | WorkloadGroup |
---|---|
MyWorkloadGroup | {"RequestLimitsPolicy » :{"DataScope » :{"IsRelaxable » :true,"Value » :"HotCache"},"MaxMemoryPerQueryPerNode » :{"IsRelaxable » :false,"Value » :6442450944},"MaxMemoryPerIterator » :{"IsRelaxable » :false,"Value » :5368709120},"MaxFanoutThreadsPercentage » :{"IsRelaxable » :true,"Value » :100},"MaxFanoutNodesPercentage » :{"IsRelaxable » :true,"Value » :100},"MaxResultRecords » :{"IsRelaxable » :true,"Value » :500000},"MaxResultBytes » :{"IsRelaxable » :true,"Value » :67108864} » MaxExecutionTime » :{"IsRelaxable » :true,"Value » :"00:04:00"}},"RequestRateLimitPolicies » :[{"IsEnabled » :true,"Scope » :"WorkloadGroup »,"LimitKind » :"ConcurrentRequests »,"Properties » :{"MaxConcurrentRequests » :20}}]} |
Définir des stratégies de limites de requête et des stratégies de taux de requête
Créez un groupe de charge de travail Mon groupe de charges de travail avec une définition complète de sa stratégie de limites de requête et des stratégies de limites de taux de requête :
.create-or-alter workload_group ['My Workload Group'] ```
{
"RequestLimitsPolicy": {
"DataScope": {
"IsRelaxable": true,
"Value": "All"
},
"MaxMemoryPerQueryPerNode": {
"IsRelaxable": true,
"Value": 6442450944
},
"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": true,
"Value": "00:04:00"
},
"QueryResultsCacheMaxAge": {
"IsRelaxable": true,
"Value": "00:05:00"
}
},
"RequestRateLimitPolicies": [
{
"IsEnabled": true,
"Scope": "WorkloadGroup",
"LimitKind": "ConcurrentRequests",
"Properties": {
"MaxConcurrentRequests": 100
}
},
{
"IsEnabled": true,
"Scope": "Principal",
"LimitKind": "ConcurrentRequests",
"Properties": {
"MaxConcurrentRequests": 25
}
}
]
} ```
Sortie
WorkloadGroupName | WorkloadGroup |
---|---|
Mon groupe de charge de travail | {"RequestLimitsPolicy » :{"DataScope » :{"IsRelaxable » :true,"Value » :"All"},"MaxMemoryPerQueryPerNode » :{"IsRelaxable » :true,"Value « :6442450944},"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 » :true,"Value » :"00:04:00"}},"RequestRateLimitPolicies » :[{"IsEnabled » :true,"Scope » :"WorkloadGroup »,"LimitKind » :"ConcurrentRequests »,""ConcurrentRequests »," » Properties » :{"MaxConcurrentRequests » :100}},{"IsEnabled » :true,"Scope » :"Principal »,"LimitKind » :"ConcurrentRequests »,"Properties » :{"MaxConcurrentRequests » :25}}]} |