Partager via


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-mergeworkload_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 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"}}