sys.dm_db_stats_histogram (Transact-SQL)

[アーティクル]
09/03/2023

適用対象: SQL Server 2016 (13.x) 以降 Azure SQL Database Azure SQL Managed Instance

現在の SQL Server データベース内の指定されたデータベースオブジェクト (テーブルまたはインデックス付きビュー) の統計ヒストグラムを返します。 DBCC SHOW_STATISTICS WITH HISTOGRAM と似ています。

Note

この DMF は、SQL Server 2016 (13.x) SP1 CU2 以降で使用できます。

構文

sys.dm_db_stats_histogram (object_id, stats_id)

引数

object_id
統計のプロパティが要求された、現在のデータベース内にあるオブジェクトの ID です。 object_ID は intです。

stats_id
指定された object_idの統計情報の ID です。統計 ID は、 sys.stats 動的管理ビューから取得できます。 stats_id は intです。

返されるテーブル

列名	データ型	説明
object_id	int	統計オブジェクトのプロパティを返す対象であるオブジェクト (テーブルまたはインデックス付きビュー) の ID。
stats_id	int	統計オブジェクトの ID。テーブルまたはインデックス付きビュー内で一意です。詳細については、「sys.stats (Transact-SQL)」を参照してください。
step_number	int	ヒストグラムの区間の数。
range_high_key	sql_variant	ヒストグラム区間の上限の列値。この列値はキー値とも呼ばれます。
range_rows	real	ヒストグラム区間内 (上限は除く) に列値がある行の予測数。
equal_rows	real	ヒストグラム区間の上限と列値が等しい行の予測数。
distinct_range_rows	bigint	ヒストグラム区間内 (上限は除く) にある個別の列値を持つ行の予測数。
average_range_rows	real	上限を除く、ヒストグラムのステップ内で重複する列の値を持つ行の数の平均値（`RANGE_ROWS / DISTINCT_RANGE_ROWS`の`DISTINCT_RANGE_ROWS > 0`）。

解説

sys.dm_db_stats_histogram の結果セットは、同様の情報を DBCC SHOW_STATISTICS WITH HISTOGRAM に返し、さらに object_id、stats_id、および step_number も含まれます。

列 range_high_key は sql_variant データ型であるため、CAST や CONVERT を使用する必要がある場合、述語が文字列以外の定数と比較する必要がある場合があります。

ヒストグラム

ヒストグラムでは、データセットの個別の値ごとに出現頻度を測定します。クエリオプティマイザーでは、統計オブジェクトの最初のキー列の列値に基づいてヒストグラムを計算し、行を統計的にサンプリングするかテーブルまたはビュー内のすべての行でフルスキャンを実行することによって列値を選択します。サンプリングされた行のセットからヒストグラムを作成する場合、格納される行の総数および個別の値の数は推定値であり、必ずしも整数にはなりません。

ヒストグラムを作成するには、クエリオプティマイザーで列値を並べ替え、個別の列値ごとに一致する値の数を計算し、列値を最大 200 の連続したヒストグラム区間に集計します。各区間には、上限の列値までの列値の範囲が含まれます。この範囲には、境界値の間 (境界値自体は除く) のすべての有効な列値が含まれます。格納される最小の列値は、最初のヒストグラム区間の上限境界値になります。

次の図は、6 つの区間があるヒストグラムを示しています。最初の上限境界値の左側にある領域が最初の区間です。

サンプリングした列の値からヒストグラムを計算する方法を示す図。

ヒストグラムの各区間は、以下のように表されます。

太線は、上限境界値 (range_high_key) およびその出現回数 (equal_rows) を表します。
range_high_key の左にある領域は、列値の範囲、およびそれぞれの列値の平均出現回数 (average_range_rows) を表します。最初のヒストグラム区間の average_range_rows は常に 0 です。
点線は、範囲内にある個別の値の総数 (distinct_range_rows) および範囲内の値の総数 (range_rows) を推定するために使用されるサンプリングされた値を表します。クエリオプティマイザーでは、range_rows および distinct_range_rows を使用して average_range_rows を計算します。サンプリングされた値は格納されません。

クエリオプティマイザーでは、統計的有意性に応じてヒストグラム区間を定義します。区間幅を最大にするアルゴリズムを使用して境界値の差を最大にし、ヒストグラムの区間の数を最小限に抑えます。区間の最大数は 200 です。ヒストグラムの区間の数は、境界点が 200 より少ない列でも、個別の値の数より少なくなることがあります。たとえば、個別の値が 100 個ある列のヒストグラムの境界点が 100 より少なくなる場合もあります。

アクセス許可

ユーザーは、統計情報列に対する SELECT 権限を持っているか、テーブルを所有しているか、固定サーバーロール sysadmin、db_owner 固定データベースロール db_owner 、または db_ddladmin 固定データベースロール db_ddladmin のメンバーである必要があります。

例

A. 簡単な例

次の例では、簡単なテーブルを作成して入力します。次に、Country_Name 列に統計を作成します。

CREATE TABLE Country
(Country_ID int IDENTITY PRIMARY KEY,
Country_Name varchar(120) NOT NULL);
INSERT Country (Country_Name) VALUES ('Canada'), ('Denmark'), ('Iceland'), ('Peru');

CREATE STATISTICS Country_Stats  
    ON Country (Country_Name) ;

主キーは stat_id 数値 1 を占めているため、sys.dm_db_stats_histogram 数値 2 の stat_id を呼び出して、Country テーブルの統計ヒストグラムを返します。

SELECT * FROM sys.dm_db_stats_histogram(OBJECT_ID('Country'), 2);

B. 便利なクエリ:

SELECT hist.step_number, hist.range_high_key, hist.range_rows, 
    hist.equal_rows, hist.distinct_range_rows, hist.average_range_rows
FROM sys.stats AS s
CROSS APPLY sys.dm_db_stats_histogram(s.[object_id], s.stats_id) AS hist
WHERE s.[name] = N'<statistic_name>';

C: 便利なクエリ:

次の例では、列 Country_Name に述語があるテーブル Country から選択します。

SELECT * FROM Country 
WHERE Country_Name = 'Canada';

次の例では、上記のクエリの述語と一致するヒストグラムステップについて、テーブル Country と列 Country_Name に対して以前に作成した統計情報を確認します。

SELECT ss.name, ss.stats_id, shr.steps, shr.rows, shr.rows_sampled, 
    shr.modification_counter, shr.last_updated, sh.range_rows, sh.equal_rows
FROM sys.stats ss
INNER JOIN sys.stats_columns sc 
    ON ss.stats_id = sc.stats_id AND ss.object_id = sc.object_id
INNER JOIN sys.all_columns ac 
    ON ac.column_id = sc.column_id AND ac.object_id = sc.object_id
CROSS APPLY sys.dm_db_stats_properties(ss.object_id, ss.stats_id) shr
CROSS APPLY sys.dm_db_stats_histogram(ss.object_id, ss.stats_id) sh
WHERE ss.[object_id] = OBJECT_ID('Country') 
    AND ac.name = 'Country_Name'
    AND sh.range_high_key = CAST('Canada' AS CHAR(8));

次のステップ

DBCC SHOW_STATISTICS (Transact-SQL)
オブジェクト関連の動的管理ビューおよび関数 (Transact-SQL)
sys.dm_db_stats_properties (Transact-SQL)

次の方法で共有