Comando .create-or-alter workload_group
Si applica a: ✅Microsoft Fabric✅Azure Esplora dati
Crea un nuovo gruppo di carico di lavoro o modifica un gruppo di carico di lavoro esistente.
Autorizzazioni
Per eseguire questo comando, è necessario disporre delle autorizzazioni Cluster AllDatabasesAdmin .
Nota
Il admin
ruolo eredita le Cluster AllDatabasesAdmin
autorizzazioni.
Sintassi
.create-or-alter
workload_group
WorkloadGroupNameSerializedPolicyObject
Altre informazioni sulle convenzioni di sintassi.
Parametri
Nome | Digita | Obbligatorio | Descrizione |
---|---|---|---|
WorkloadGroupName | string |
✔️ | Nome del gruppo del carico di lavoro. Può essere specificato con notazione tra parentesi quadre ['WorkLoadGroupName']. |
SerializedPolicyObject | string |
✔️ | Rappresentazione JSON dei criteri. * |
*
I criteri seguenti si applicano ai gruppi di carico di lavoro:
- classificazione delle richieste
- limiti delle richieste
- limite di frequenza delle richieste
- 'imposizione dei limiti di frequenza delle richieste
- specificare la modalità di coerenza delle query
Valori restituiti
Il comando restituisce una riga che mostra i dettagli del gruppo di carico di lavoro.
Di seguito è riportato lo schema dell'output restituito:
Nome | Digita | Descrizione |
---|---|---|
WorkloadGroupName | string |
Nome del gruppo del carico di lavoro. |
WorkloadGroup | string |
Rappresentazione JSON del gruppo di carico di lavoro. |
Esempi
Definire i criteri relativi ai limiti delle richieste
Creare un gruppo di carico di lavoro MyWorkloadGroup con una definizione completa dei criteri relativi ai limiti delle richieste:
.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"
}
}
} ```
Output
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}}]} |
Definire i criteri relativi ai limiti delle richieste e ai limiti della frequenza delle richieste
Creare un gruppo di carico di lavoro Gruppo di carico di lavoro personale con una definizione completa dei criteri relativi ai limiti delle richieste e ai criteri relativi ai limiti della frequenza delle richieste:
.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
}
}
]
} ```
Output
WorkloadGroupName | WorkloadGroup |
---|---|
Gruppo carico di lavoro personale | {"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","","Proprietà":{"MaxConcurrentRequests":100}},{"IsEnabled":true,"Scope":"Principal","LimitKind":"ConcurrentRequests","Properties":{"MaxConcurrentRequests":25}}]} |
Contenuto correlato
- gruppi di carico di lavoro
- workload_group alter-merge
- .drop workload_group
- .show workload_group