sys.dm_resource_governor_workload_groups(Transact-SQL)

適用対象:SQL ServerAzure SQL データベースAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

ワークロード グループの統計と、ワークロード グループの現在のメモリ内構成を返します。

Note

これを Azure Synapse Analytics または Analytics Platform System (PDW) から呼び出すには、 sys.dm_pdw_nodes_resource_governor_workload_groupsという名前を使用します。 この構文は、Azure Synapse Analytics のサーバーレス SQL プールでサポートされていません。

列名 データの種類 Description
group_id int ワークロード グループの ID。 NULL 値は許可されません。
name sysname ワークロード グループの名前。 NULL 値は許可されません。
pool_id int リソース プールの ID。 NULL 値は許可されません。
external_pool_id int 適用対象: SQL Server 2016 (13.x) 以降。

外部リソース プールの ID。 NULL 値は許可されません。
statistics_start_time datetime ワークロード グループの統計収集が開始された時刻。 NULL 値は許可されません。
total_request_count bigint ワークロード グループ内の完了した要求の累積数。 NULL 値は許可されません。
total_queued_request_count bigint GROUP_MAX_REQUESTS 制限に達した後にキューに登録された要求の累積数。 NULL 値は許可されません。
active_request_count int 現在の要求数。 NULL 値は許可されません。
queued_request_count int 現在キューに登録されている要求の数。 NULL 値は許可されません。
total_cpu_limit_violation_count bigint CPU 制限を超える要求の累積数。 NULL 値は許可されません。
total_cpu_usage_ms bigint このワークロード グループによる累積 CPU 使用率 (ミリ秒単位)。 NULL 値は許可されません。
max_request_cpu_time_ms bigint 1 つの要求の最大 CPU 使用率 (ミリ秒単位)。 NULL 値は許可されません。

注: これは、構成可能な設定である request_max_cpu_time_secとは異なり、測定値です。 詳細については、REQUEST_MAX_CPU_TIME_SECを参照してください。
blocked_task_count int ブロックされたタスクの現在の数。 NULL 値は許可されません。
total_lock_wait_count bigint 発生したロック待機の累積数。 NULL 値は許可されません。
total_lock_wait_time_ms bigint ロックが保持されている経過時間の累積合計 (ミリ秒単位)。 NULL 値は許可されません。
total_query_optimization_count bigint このワークロード グループ内のクエリ最適化の累積数。 NULL 値は許可されません。
total_suboptimal_plan_generation_count bigint メモリ不足のためにこのワークロード グループで発生した最適でないプラン世代の累積数。 NULL 値は許可されません。
total_reduced_memgrant_count bigint 要求ごとのメモリ許可サイズの上限に達したメモリ許可の累積数。 NULL 値は許可されません。
max_request_grant_memory_kb bigint 統計のリセット以降、1 つの要求に対する最大メモリ許可サイズ (KB 単位)。 NULL 値は許可されません。
active_parallel_thread_count bigint 並列スレッド使用量の現在の数。 NULL 値は許可されません。
importance sysname このワークロード グループ内の要求の相対的な重要度の現在の構成値。 重要度は次のいずれかであり、Medium が既定値です。LowMedium、または High

NULL 値は許可されません。
request_max_memory_grant_percent int 1 つの要求に対する最大メモリ許可の現在の設定 (パーセンテージ)。 NULL 値は許可されません。
request_max_cpu_time_sec int 1 つの要求に対する最大 CPU 使用制限の現在の設定 (秒単位)。 NULL 値は許可されません。
request_memory_grant_timeout_sec int 1 つの要求に対するメモリ許可タイムアウトの現在の設定 (秒単位)。 NULL 値は許可されません。
group_max_requests int ワークロード グループ内の同時要求の最大数の現在の設定。 NULL 値は許可されません。
max_dop int ワークロード グループの並列処理の最大次数を構成しました。 既定値の 0 はグローバル設定を使用します。 NULL 値は許可されません。
effective_max_dop int 適用対象: SQL Server 2012 (11.x) 以降。

ワークロード グループの並列処理の有効な最大レベル。 NULL 値は許可されません。
total_cpu_usage_preemptive_ms bigint 適用対象: SQL Server 2016 (13.x) 以降。

ワークロード グループのプリエンプティブ モードのスケジューリング中に使用された CPU 時間の合計 (ミリ秒単位)。 NULL 値は許可されません。

データベース エンジンの外部にあるコード (拡張ストアド プロシージャや分散クエリなど) を実行するには、スレッドを非優先スケジューラの制御外で実行する必要があります。 このとき、ワーカーはプリエンプティブ モードに切り替えられます。
request_max_memory_grant_percent_numeric float 適用対象: Azure SQL Managed Instance と SQL Server 2019 (15.x) 以降。

1 つの要求に対する最大メモリ許可の現在の設定 (パーセンテージ)。 値は request_max_memory_grant_percentに似ています。 ただし、request_max_memory_grant_percent 値を返す integer とは異なり、request_max_memory_grant_percent_numericfloat 値を返します。 SQL Server 2019 (15.x) 以降では、パラメーター REQUEST_MAX_MEMORY_GRANT_PERCENT 0 から 100 の範囲の値を受け取り、float データ型として格納します。 SQL Server 2019 (15.x) より前の REQUEST_MAX_MEMORY_GRANT_PERCENT は、1 ~ 100 の範囲の integer です。 詳細については、CREATE WORKLOAD GROUPを参照してください。

NULL 値は許可されません。
tempdb_data_space_kb bigint 対象:SQL Server 2025(17.x)から開始

ワークロード グループ内のすべてのセッションによって、 tempdb データ ファイルで使用されている現在のデータ領域 (KB 単位)。 ヌラブル
peak_tempdb_data_space_kb bigint 対象:SQL Server 2025(17.x)から開始

サーバーの起動以降、またはリソース ガバナー統計がリセットされてから、ワークロード グループ内のすべてのセッションによって、 tempdb データ ファイルで使用されたピーク データ領域 (KB 単位)。 ヌラブル
total_tempdb_data_limit_violation_count bigint 対象:SQL Server 2025(17.x)から開始

ワークロード グループの tempdb データ領域の使用量の制限を超えるため、エラー 1138 で要求が中止された回数。 ヌラブル
pdw_node_id int 適用対象: Azure Synapse Analytics、Analytics Platform System (PDW)

このディストリビューションがオンになっているノードの識別子。

注釈

この動的管理ビューには、インメモリ構成が表示されます。 格納されている構成メタデータを表示するには、sys.resource_governor_workload_groups カタログ ビューを使用します。

このビューを sys.dm_resource_governor_resource_pools と結合して、リソース プール名を取得できます。

統計は、データベース エンジンの最後の開始以降に追跡されます。 ALTER RESOURCE GOVERNOR RESET STATISTICSが実行されると、statistics_start_timetotal_request_counttotal_queued_request_counttotal_cpu_limit_violation_counttotal_cpu_usage_msmax_request_cpu_time_mstotal_lock_wait_counttotal_lock_wait_time_mstotal_query_optimization_counttotal_suboptimal_plan_generation_counttotal_reduced_memgrant_countmax_request_grant_memory_kbpeak_tempdb_data_space_kbtotal_tempdb_data_limit_violation_countの各カウンターがリセットされます。 カウンター statistics_start_time は現在のシステム日時に設定され、他のカウンターは 0 (0) に設定されます。

Permissions

VIEW SERVER STATE 権限が必要です。

SQL Server 2022 以降でのアクセス許可

サーバーに対する VIEW SERVER PERFORMANCE STATE 権限が必要です。