.alter-merge workload_group コマンド
ワークロード グループを変更します。
アクセス許可
このコマンドを実行するには、 Cluster AllDatabasesAdmin アクセス許可が必要です。
Note
admin
ロールは、Cluster AllDatabasesAdmin
アクセス許可を継承します。
構文
.alter-merge
workload_group
WorkloadGroupNameSerializedPolicyObject
構文規則について詳しく知る。
パラメーター
件名 | タイプ | Required | 説明 |
---|---|---|---|
WorkloadGroupName | string |
✔️ | ワークロード グループの名前。 角かっこ表記 ['WorkLoadGroupName'] で指定できます。 |
SerializedPolicyObject | string |
✔️ | ポリシーの JSON 表現。 * |
*
ワークロード グループには、次のポリシーが適用されます。
返品
このコマンドは、ワークロード グループの詳細を示す 1 行を返します。
返される出力のスキーマを次に示します。
件名 | タイプ | 説明 |
---|---|---|
WorkloadGroupName | string |
ワークロード グループの名前。 |
WorkloadGroup | string |
ポリシーの JSON 表現。 |
例
要求の制限ポリシーの特定の制限を変更する
default
ワークロード グループの要求制限ポリシーの特定の制限を変更しますが、以前に定義した制限は変更されません。
.alter-merge workload_group default ```
{
"RequestLimitsPolicy": {
"DataScope": {
"IsRelaxable": false,
"Value": "HotCache"
},
"MaxExecutionTime": {
"IsRelaxable": false,
"Value": "00:01:00"
}
}
} ```
出力
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":{"QueriesEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Database"}} |
要求レート制限のポリシーを変更する
他のすべてのポリシーを変更せずに、 default
ワークロード グループの要求レート制限ポリシーを変更します。
.alter-merge workload_group default ```
{
"RequestRateLimitPolicies": [
{
"IsEnabled": true,
"Scope": "WorkloadGroup",
"LimitKind": "ConcurrentRequests",
"Properties": {
"MaxConcurrentRequests": 100
}
}
]
} ```
出力
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":{"QueriesEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Database"}} |
要求キューポリシーを変更する
要求制限ポリシーと要求レート制限ポリシーを変更せずに、 default
ワークロード グループの要求キューを有効にします。
.alter-merge workload_group default ```
{
"RequestQueuingPolicy": {
"IsEnabled": true
}
} ```
出力
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":{"QueriesEnforcementLevel":\n"QueryHead","CommandsEnforcementLevel":"Database"}} |
要求のレート制限の適用ポリシーを変更する
他のすべてのポリシーを変更せずに、 default
ワークロード グループの要求レート制限適用ポリシーを有効にします。
.alter-merge workload_group default ```
{
"RequestRateLimitsEnforcementpolicy": {
"QueriesEnforcementLevel": "QueryHead",
"CommandsEnforcementLevel": "Cluster"
}
} ```
出力
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":{"QueriesEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Cluster"}} |
一貫性ポリシーのクエリを変更する
クエリ整合性モデルに適用可能なオプションを指定します。
.alter-merge workload_group default ```
{
"QueryConsistencyPolicy": {
"QueryConsistency": {
"IsRelaxable": true,
"Value": "Weak"
}
}
} ```
出力
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":{"QueriesEnforcementLevel":"QueryHead","CommandsEnforcementLevel":"Cluster"},"QueryConsistencyPolicy":{"QueryConsistency":{"IsRelaxable":true,"Value":"Weak"}}} |
関連コンテンツ
- ワークロード グループ を
する - .create-or-alter workload_groupを
する - .drop workload_groupを
する - .show workload_group