Partager via


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-alterworkload_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 :

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}}]}