CREATE WORKLOAD GROUP

指定したクォータ設定でワークロードグループを作成します。ワークロードグループはユーザーにバインドすることで、リソース割り当てとクエリ同時実行数を制御します。ユーザーがクエリを送信すると、そのユーザーに割り当てられたグループに基づいてワークロードグループの制限が適用されます。

構文

CREATE WORKLOAD GROUP [IF NOT EXISTS] <group_name>
[WITH cpu_quota = '<percentage>', query_timeout = '<duration>']

パラメータ

例

基本例

-- Create workload groups
CREATE WORKLOAD GROUP IF NOT EXISTS interactive_queries
WITH cpu_quota = '30%', memory_quota = '20%', max_concurrency = 2;

CREATE WORKLOAD GROUP IF NOT EXISTS batch_processing
WITH cpu_quota = '70%', memory_quota = '80%', max_concurrency = 10;

ユーザー割り当て

リソース制限を有効にするには、ユーザーをワークロードグループに割り当てる必要があります。ユーザーがクエリを実行すると、システムはワークロードグループの制限を自動的に適用します。

-- Create role and grant permissions
CREATE ROLE analytics_role;
GRANT ALL ON *.* TO ROLE analytics_role;
CREATE USER analytics_user IDENTIFIED BY 'password123' WITH DEFAULT_ROLE = 'analytics_role';
GRANT ROLE analytics_role TO analytics_user;

-- Assign user to workload group
ALTER USER analytics_user WITH SET WORKLOAD GROUP = 'interactive_queries';

-- Reassign to different workload group
ALTER USER analytics_user WITH SET WORKLOAD GROUP = 'batch_processing';

-- Remove from workload group (user will use default unlimited resources)
ALTER USER analytics_user WITH UNSET WORKLOAD GROUP;

-- Check user's workload group
DESC USER analytics_user;

リソースクォータの正規化

クォータ制限

• 各ワークロードグループの cpu_quota と memory_quota は最大 100%（1.0）まで設定できます
• ワークロードグループ全体にわたるすべてのクォータの合計は 100% を超えることができます
• 実際のリソース割り当ては、相対的な比率に基づいて正規化されます

クォータ正規化の仕組み

リソースは、全体に対する各グループのクォータの比率に基づいて比例配分されます。

Actual Allocation = (Group Quota) / (Sum of All Group Quotas) × 100%

例 1: クォータ合計 = 100%

• グループ A: クォータ 30% → リソースの 30% を取得（30/100）
• グループ B: クォータ 70% → リソースの 70% を取得（70/100）

例 2: クォータ合計 > 100%

• グループ A: クォータ 60% → リソースの 40% を取得（60/150）
• グループ B: クォータ 90% → リソースの 60% を取得（90/150）
• クォータ合計: 150%

例 3: クォータ合計 < 100%

• グループ A: クォータ 20% → リソースの 67% を取得（20/30）
• グループ B: クォータ 10% → リソースの 33% を取得（10/30）
• クォータ合計: 30%

特別なケース: ワークロードグループが 1 つしか存在しない場合、設定されたクォータに関係なく、そのグループは Warehouse リソースの 100% を取得します。