Comando .create-or-alter workload_group
Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer
Crie um novo grupo de carga de trabalho ou altere um grupo de carga de trabalho existente.
Permissões
Você deve ter permissões Cluster AllDatabasesAdmin para executar esse comando.
Observação
A admin
função herda Cluster AllDatabasesAdmin
permissões.
Sintaxe
.create-or-alter
workload_group
WorkloadGroupName SerializedPolicyObject
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Digitar | Obrigatória | Descrição |
---|---|---|---|
Nome do Grupo de Trabalho | string |
✔️ | Nome do grupo de carga de trabalho. Pode ser especificado com a notação de colchete ['WorkLoadGroupName']. |
Objeto de política serializada | string |
✔️ | Representação JSON da política. * |
*
As seguintes políticas se aplicam a grupos de carga de trabalho:
- Classificação de solicitação
- Limites de solicitação
- Limite de taxa de solicitação
- Solicitar aplicação de limites de taxa.
Devoluções
O comando retorna uma linha mostrando os detalhes do grupo de carga de trabalho.
A seguir está o esquema da saída retornada:
Nome | Tipo | Descrição |
---|---|---|
Nome do Grupo de Trabalho | string |
Nome do grupo de carga de trabalho. |
Grupo de carga de trabalho | string |
Representação JSON do grupo de carga de trabalho. |
Exemplos
Definir política de limites de solicitação
Crie um grupo de carga de trabalho MyWorkloadGroup com uma definição completa de sua política de limites de solicitação:
.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"
}
}
} ```
Saída
Nome do Grupo de Trabalho | Grupo de carga de trabalho |
---|---|
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}}]} |
Definir política de limites de solicitação e políticas de limites de taxa de solicitação
Crie um grupo de carga de trabalho Meu Grupo de Carga de Trabalho com uma definição completa de sua política de limites de solicitação e políticas de limites de taxa de solicitação:
.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
}
}
]
} ```
Saída
Nome do Grupo de Trabalho | Grupo de carga de trabalho |
---|---|
Meu grupo de carga de trabalho | {"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}}]} |