sys.dm_exec_query_stats (Transact-SQL)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

SQL Server でキャッシュされたクエリ プランの集計パフォーマンス統計を返します。 このビューには、キャッシュされたプラン内のクエリ ステートメントごとに 1 行が含まれており、その行の有効期間はプラン自体に関連付けられています。 つまり、プランがキャッシュから削除されると、対応する行もこのビューから削除されます。

sys.dm_exec_query_stats の結果は、実行中のクエリではなく、完了したクエリのみがデータに反映されるため、実行ごとに異なる場合があります。

Azure Synapse Analytics または Analytics Platform System (PDW) の専用 SQL プールからこの DMV を呼び出すには、sys.dm_pdw_nodes_exec_query_statsという名前を使用します。 サーバーレス SQL プールの場合は、sys.dm_exec_query_statsを使用します。

アクセス許可

SQL Server 2019 (15.x) 以前のバージョンと Azure SQL Managed Instance には、VIEW SERVER STATE アクセス許可が必要です。

SQL Server 2022 (16.x) 以降のバージョンでは、サーバーに対する VIEW SERVER PERFORMANCE STATE アクセス許可が必要です。

Azure SQL Database Basic、S0、S1 サービス目標、および エラスティック プール内のデータベースの場合は、サーバー管理者 アカウント、Microsoft Entra 管理者 アカウント、または ##MS_ServerStateReader##サーバー ロール のメンバーシップが必要です。 他のすべての SQL Database サービス目標では、データベースに対する VIEW DATABASE STATE アクセス許可または ##MS_ServerStateReader## サーバー ロールのメンバーシップのいずれかが必要です。

解説

ビュー内の統計は、クエリが完了したときに更新されます。

例

A. TOP N クエリを検索する

次の例では、平均 CPU 時間の上位 5 個のクエリに関する情報を返します。 この例では、クエリ ハッシュに従ってクエリを集計して、論理的に等価のクエリを累積リソース使用量別にグループ化しています。 Sample_Statement_Text列には、クエリ ハッシュに一致するクエリ構造の例が示されていますが、ステートメント内の特定の値に関係なく読み取る必要があります。 たとえば、ステートメントに WHERE Id = 5が含まれている場合は、より汎用的な形式 (WHERE Id = @some_value) で読み取る場合があります。

SELECT TOP 5
    query_stats.query_hash AS Query_Hash,
    SUM(query_stats.total_worker_time) / SUM(query_stats.execution_count) AS Avg_CPU_Time,
    MIN(query_stats.statement_text) AS Sample_Statement_Text
FROM (
    SELECT QS.*,
        SUBSTRING(ST.text, (QS.statement_start_offset / 2) + 1, (
                (
                    CASE statement_end_offset
                        WHEN - 1
                            THEN DATALENGTH(ST.text)
                        ELSE QS.statement_end_offset
                        END - QS.statement_start_offset
                    ) / 2
                ) + 1) AS statement_text
    FROM sys.dm_exec_query_stats AS QS
    CROSS APPLY sys.dm_exec_sql_text(QS.sql_handle) AS ST
    ) AS query_stats
GROUP BY query_stats.query_hash
ORDER BY 2 DESC;

B. クエリの行数集計を返す

次の例では、クエリの行数集計情報 (合計行数、最小行数、最大行数、および最後の行) を返します。

SELECT qs.execution_count,
    SUBSTRING(qt.text, qs.statement_start_offset / 2 + 1, (
            CASE 
                WHEN qs.statement_end_offset = - 1
                    THEN LEN(CONVERT(NVARCHAR(max), qt.text)) * 2
                ELSE qs.statement_end_offset
                END - qs.statement_start_offset
            ) / 2) AS query_text,
    qt.dbid,
    dbname = DB_NAME(qt.dbid),
    qt.objectid,
    qs.total_rows,
    qs.last_rows,
    qs.min_rows,
    qs.max_rows
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_sql_text(qs.sql_handle) AS qt
WHERE qt.text LIKE '%SELECT%'
ORDER BY qs.execution_count DESC;

関連コンテンツ

• 実行関連の動的管理ビューと関数 (Transact-SQL)
• sys.dm_exec_sql_text (Transact-SQL)
• sys.dm_exec_query_plan (Transact-SQL)
• sys.dm_exec_procedure_stats (Transact-SQL)
• sys.dm_exec_trigger_stats (Transact-SQL)
• sys.dm_exec_cached_plans (Transact-SQL)