.create-or-alter workload_group コマンド
新しいワークロード グループを作成するか、既存のワークロード グループを変更します。
アクセス許可
このコマンドを実行するには、 Cluster AllDatabasesAdmin アクセス許可が必要です。
Note
admin
ロールは、Cluster AllDatabasesAdmin
アクセス許可を継承します。
構文
.create-or-alter
workload_group
WorkloadGroupName SerializedPolicyObject
構文規則について詳しく知る。
パラメーター
件名 | タイプ | Required | 説明 |
---|---|---|---|
WorkloadGroupName | string |
✔️ | ワークロード グループの名前。 角かっこ表記 ['WorkLoadGroupName'] で指定できます。 |
SerializedPolicyObject | string |
✔️ | ポリシーの JSON 表現。 * |
*
ワークロード グループには、次のポリシーが適用されます。
返品
このコマンドは、ワークロード グループの詳細を示す 1 行を返します。
返される出力のスキーマを次に示します。
名前 | 種類 | 説明 |
---|---|---|
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}}]} |