Поделиться через

Команда .create-or-alter workload_group

  • Статья

Область применения: ✅Microsoft Fabric✅Azure Data Explorer

Создает новую группу рабочей нагрузки или изменяет существующую группу рабочей нагрузки.

Разрешения

Для выполнения этой команды необходимо иметь разрешения Cluster AllDatabasesAdmin .

Примечание.

Роль admin наследует Cluster AllDatabasesAdmin разрешения.

Синтаксис

.create-or-alter workload_group WorkloadGroupNameSerializedPolicyObject

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
WorkloadGroupName string ✔️ Имя группы рабочей нагрузки. Можно указать с нотацией скобки ['WorkLoadGroupName'].
SerializedPolicyObject string ✔️ Представление политики в формате JSON. *

* Следующие политики применяются к группам рабочей нагрузки:

Возвраты

Команда возвращает одну строку, показывающую сведения о группе рабочей нагрузки.

Ниже приведена схема возвращаемых выходных данных:

Имя (название) Type Описание
WorkloadGroupName string Имя группы рабочей нагрузки.
WorkloadGroup string Представление JSON группы рабочей нагрузки.

Примеры

Определение политики ограничений запросов

Создайте группу рабочей нагрузки MyWorkloadGroup с полным определением политики ограничений запросов:

.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"
    }
  }
} ```

Выходные данные

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

Определение политик ограничений запросов и политик ограничений скорости запросов

Создайте группу рабочей нагрузки "Моя группа рабочей нагрузки" с полным определением политики ограничений запросов и политик ограничений частоты запросов:

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

Выходные данные

WorkloadGroupName WorkloadGroup
Моя группа рабочей нагрузки {"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","Properties ":{"MaxConcurrentRequests":100}},{"IsEnabled":true,"Scope":"Principal","LimitKind":"ConcurrentRequests","Properties":{"MaxConcurrentRequests":25}}

Связанное содержимое