sp_helpstats （Transact-SQL）

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體

傳回指定數據表上數據行和索引的統計數據資訊。

重要

SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。 若要取得統計數據的相關信息，請查詢 sys.stats 和 sys.stats_columns 目錄檢視。

Transact-SQL 語法慣例

語法

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

引數

[ @objname = ] 'object_name' 指定要提供統計數據信息的數據表。 object_name為 nvarchar（520），不能為 null。 可以指定一或兩部分的名稱。

[ @results = ] 'value' 指定要提供的資訊範圍。 有效的專案為 ALL 和 STATS。 ALL 會列出所有索引的統計數據，以及已建立統計資料的數據行; STATS 只會列出與索引無關的統計數據。 value 為 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的所有合格數據行建立單一數據行統計數據。 然後， 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）