sp_helpstats (Transact-SQL)

  • [アーティクル]

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

指定したテーブルの列およびインデックスに関する統計を返します。

重要

この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 統計に関する情報を取得するには、sys.stats とカタログ ビュー sys.stats_columnsクエリを実行します。

Transact-SQL 構文表記規則

構文

  
sp_helpstats[ @objname = ] 'object_name'   
     [ , [ @results = ] 'value' ]

引数

[ @objname = ] 'object_name' 統計情報を提供するテーブルを指定します。 object_nameは nvarchar(520) であり、null にすることはできません。 1 つまたは 2 つの部分で構成される名前を指定できます。

[ @results = ] 'value' 提供する情報の範囲を指定します。 有効なエントリは ALL と STATS です。 ALL には、すべてのインデックスの統計と、統計が作成された列が一覧表示されます。 STATS には、インデックスに関連付けられていない統計のみが一覧表示されます。 値 は nvarchar(5) で、既定値は STATS です。

リターン コードの値

0 (成功) または 1 (失敗)

結果セット

次の表では、結果セットの列について説明します。

列名 説明
statistics_name 統計の名前。 sysname を返し、null にすることはできません。
statistics_keys 統計の基になっているキー。 nvarchar(2078) を返し、null にすることはできません。

解説

DBCC SHOW_STATISTICSを使用して、特定のインデックスまたは統計に関する詳細な統計情報を表示します。 詳細については、「 DBCC SHOW_STATISTICS (Transact-SQL) 」および 「sp_helpindex (Transact-SQL)」を参照してください。

アクセス許可

ロール public のメンバーシップが必要です。

例

次の例では、sp_createstats を実行し、AdventureWorks2022 データベース内のすべてのユーザー テーブルを対象にして、条件を満たすすべての列に関する統計を 1 列ずつ作成します。 次に、 sp_helpstats テーブルに作成された結果の統計を検索するために実行されます Customer 。

USE AdventureWorks2022;  
GO  
EXEC sp_createstats;  
GO  
EXEC sp_helpstats   
@objname = 'Sales.Customer',  
@results = 'ALL';

結果セットは次のようになります。

statistics_name statistics_keys

---------------------------- ----------------

_WA_Sys_00000003_22AA2996 AccountNumber

AK_Customer_AccountNumber AccountNumber

AK_Customer_rowguid rowguid

CustomerType CustomerType

IX_Customer_TerritoryID TerritoryID

ModifiedDate ModifiedDate

PK_Customer_CustomerID CustomerID

参照

システム ストアド プロシージャ (Transact-SQL)
データベース エンジン ストアド プロシージャ (Transact-SQL)