DBCC SHOW_STATISTICS (Transact-SQL)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウス

テーブルまたはインデックス付きビューについての、現在のクエリの最適化に関する統計を表示します。 クエリ オプティマイザーでは、統計を使用してクエリ結果のカーディナリティまたは行数を推定して、Query Optimizer で高品質のクエリ プランを作成できるようにします。 たとえば、Query Optimizer では、カーディナリティの推定に基づいて、クエリ プランで Index Scan 操作ではなく Index Seek 操作が使用される場合があります。この場合、リソースを大量に消費する Index Scan 操作を使用しないようにすることでパフォーマンスが向上します。

Query Optimizer では、テーブルまたはインデックス付きビューの統計を統計オブジェクトに格納します。 テーブルの場合、インデックスまたはテーブル列のリストに関する統計オブジェクトが作成されます。 統計オブジェクトには、統計に関するメタデータが含まれるヘッダー、統計オブジェクトの最初のキー列の値の分布が含まれるヒストグラム、および列間の相関関係を測定する密度ベクトルが格納されています。 データベース エンジンでは、統計オブジェクトの任意のデータを使用してカーディナリティ推定値を計算できます。 詳細については、「統計」および「カーディナリティ推定 (SQL Server)」を参照してください。

DBCC SHOW_STATISTICS では、統計オブジェクトに格納されたデータに基づくヘッダー、ヒストグラム、および密度ベクトルを表示します。 この構文では、テーブルまたはインデックス付きビューを指定するときに、対象のインデックス名、統計名、または列名も指定することができます。

SQL Server の過去のバージョンでの重要な更新プログラム:

• SQL Server 2012 (11.x) Service Pack 1 以降では、非増分統計の統計オブジェクトに含まれるヘッダー情報をプログラムで取得するために、sys.dm_db_stats_properties 動的管理ビューが使用可能です。

• SQL Server 2014 (12.x) Service Pack 2 および SQL Server 2012 (11.x) Service Pack 1 以降では、増分統計の統計オブジェクトに含まれるヘッダー情報をプログラムで取得するために、sys.dm_db_incremental_stats_properties 動的管理ビューが使用可能です。

• SQL Server 2016 (13.x) Service Pack 1 CU2 以降では、統計オブジェクトに含まれるヒストグラム情報をプログラムで取得するために、sys.dm_db_stats_histogram 動的管理ビューが使用可能です。

• この構文は、Azure Synapse Analytics のサーバーレス SQL プールでサポートされていません。

• Microsoft Fabric での統計について詳しくは、統計に関する記事をご覧ください。

Transact-SQL 構文表記規則

構文

SQL Server と Azure SQL Database の構文:

DBCC SHOW_STATISTICS ( table_or_indexed_view_name , target )
[ WITH [ NO_INFOMSGS ] < option > [ , ...n ] ]
< option > ::=
    STAT_HEADER | DENSITY_VECTOR | HISTOGRAM | STATS_STREAM
[ ; ]

Azure Synapse Analytics、Analytics Platform System (PDW)、Microsoft Fabric の場合の構文:

DBCC SHOW_STATISTICS ( table_name , target )
    [ WITH { STAT_HEADER | DENSITY_VECTOR | HISTOGRAM } [ , ...n ] ]
[ ; ]

引数

table_or_indexed_view_name

統計情報を表示するテーブルまたはインデックス付きビューの名前。

table_name

表示する統計情報を含むテーブルの名前。 テーブルに外部テーブルを指定することはできません。

ターゲット

統計情報を表示するインデックス、統計、または列の名前。 target は、角かっこ、一重引用符、二重引用符で囲まれるか、または引用符を使用しません。

• target がテーブルまたはインデックス付きビューの既存のインデックスまたは統計の名前である場合は、その target に関する統計情報が返されます。
• target が既存の列の名前であり、自動的に作成された統計オブジェクトがその列にある場合は、その自動作成された統計に関する情報が返されます。

target 列に自動的に作成された統計が存在しない場合は、エラー メッセージ 2767 が返されます。

Azure Synapse Analytics および Analytics Platform System (PDW) では、target を列名にすることはできません。

Microsoft Fabric のウェアハウスでは、target には単一列ヒストグラム統計または列の名前を指定できます。 target に列名が使われている場合、このコマンドは、自動的に生成されるヒストグラム統計に関する分布情報のみを返します。 手動で作成したヒストグラム統計に関する情報を見るには、統計名を target として指定します。

NO_INFOMSGS

重大度レベル 0 から 10 のすべての情報メッセージを表示しないようにします。

STAT_HEADER | DENSITY_VECTOR | HISTOGRAM | STATS_STREAM [ , n ]

これらのオプションを 1 つ以上指定すると、ステートメントによって返される結果セットが、指定のオプションに合わせて制限されます。 オプションを指定しないと、すべての統計情報が返されます。

STATS_STREAM は、単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。

結果セット

次の表は、STAT_HEADER を指定した場合に結果セットに返される列を示しています。

次の表は、DENSITY_VECTOR を指定した場合に結果セットに返される列を示しています。

次の表は、HISTOGRAM オプションを指定した場合に結果セットに返される列を示しています。

解説

統計の更新日付は、メタデータではなく統計 BLOB オブジェクトにヒストグラムおよび密度ベクトルと共に格納されます。 統計データを生成するためのデータが読み取られていない場合、統計 BLOB は作成されず、日付は使用できず、updated 列は NULL になります。 これは、述語が行を返さないフィルター選択された統計情報や、新しい空のテーブルの場合です。

ヒストグラム

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

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

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

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

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

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

密度ベクトル

クエリ オプティマイザーでは、同一のテーブルまたはインデックス付きビューから複数の列を返すクエリに対するカーディナリティの推定を向上させるために密度を使用します。 密度ベクトルには、統計オブジェクトの列のプレフィックスごとに 1 つの密度が格納されます。 たとえば、統計オブジェクトに CustomerId、ItemId、Price というキー列がある場合、以下の列プレフィックスごとに密度が計算されます。

制限事項

DBCC SHOW_STATISTICS では、空間インデックスおよびメモリ最適化列ストア インデックスの統計情報は提供されません。

SQL Server および SQL Database のアクセス許可

統計オブジェクトを表示するには、ユーザーがテーブルに対する SELECT 権限を持っている必要があります。

SELECT 権限でコマンドを実行するには、次の要件があります。

• 統計オブジェクトのすべての列に対する権限が必要です。
• フィルター条件がある場合は、そのすべての列に対する権限が必要です。
• テーブルには、行レベルのセキュリティ ポリシーを持つことはできません。
• 統計オブジェクト内のいずれかの列が動的データ マスク ルールでマスクされている場合、ユーザーは SELECT 権限に加えて、UNMASK 権限をもっているか、db_ddladmin ロールのメンバーである必要があります。

SQL Server 2012 (11.x) Service Pack 1 より前のバージョンでは、ユーザーはテーブルを所有しているか、sysadmin 固定サーバー ロール、db_owner 固定データベース ロール、または db_ddladmin 固定データベース ロールのメンバーである必要があります。

Azure Synapse Analytics および Analytics Platform System (PDW) のアクセス許可

DBCC SHOW_STATISTICS には、テーブルに対する SELECT アクセス許可か、sysadmin 固定サーバー ロール、db_owner 固定データベース ロール、または db_ddladmin 固定データベース ロールのメンバーシップが必要です。

Azure Synapse Analytics および Analytics Platform System (PDW) の制限事項と制約事項

DBCC SHOW_STATISTICS を使用すると、コントロール ノード レベルでの Shell データベースに格納されている統計情報が表示されます。 計算ノード上で SQL Server によって自動的に作成される統計情報は表示されません。

外部テーブルで DBCC SHOW_STATISTICS はサポートされていません。

Microsoft Fabric の DBCC SHOW_STATISTICS では、ACE-* 統計ではなく、ヒストグラム統計の結果のみが表示されます。

例: SQL Server と Azure SQL Database

A. すべての統計情報を返す

次の例では、AdventureWorks2022 データベースの Person.Address テーブルの AK_Address_rowguid インデックスに関するすべての統計情報を表示します。

DBCC SHOW_STATISTICS ("Person.Address", AK_Address_rowguid);
GO

B. HISTOGRAM オプションを指定する

これにより、Customer_LastName について表示される統計情報は HISTOGRAM データに制限されます。

DBCC SHOW_STATISTICS ("dbo.DimCustomer", Customer_LastName) WITH HISTOGRAM;
GO

例: Azure Synapse Analytics、Analytics Platform System (PDW)

C. 1 つの統計オブジェクトの内容を表示します。

次の例では、統計オブジェクトを作成し、AdventureWorksPDW2022 サンプル データベースの DimCustomer テーブルに Customer_LastName 統計の内容を表示します。

-- Uses AdventureWorksPDW
--First, create a statistics object
CREATE STATISTICS Customer_LastName
ON AdventureWorksPDW2012.dbo.DimCustomer (LastName);
GO
DBCC SHOW_STATISTICS ("dbo.DimCustomer", Customer_LastName);
GO

結果は、ヘッダー、密度ベクトル、およびヒストグラムの一部を示します。

関連項目

• 統計
• Microsoft Fabric の統計
• sys.dm_db_stats_properties (Transact-SQL)
• sys.dm_db_stats_histogram (Transact-SQL)
• sys.dm_db_incremental_stats_properties (Transact-SQL)

次の手順

• CREATE INDEX (Transact-SQL)
• CREATE STATISTICS (Transact-SQL)
• DROP STATISTICS (Transact-SQL)
• sp_autostats (Transact-SQL)
• sp_createstats (Transact-SQL)
• STATS_DATE (Transact-SQL)
• UPDATE STATISTICS (Transact-SQL)