sp_helpstats (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

Gibt statistische Informationen zu Spalten und Indizes der angegebenen Tabelle zurück.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Um Informationen zu Statistiken zu erhalten, fragen Sie sys.stats und sys.stats_columns Katalogansichten ab.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @objname = ] 'object_name' Gibt die Tabelle an, in der Statistiken bereitgestellt werden sollen. object_name ist nvarchar(520) und darf nicht null sein. Es kann ein ein- oder zweiteiliger Name angegeben werden.

[ @results = ] 'value' Gibt den Umfang der bereitzustellenden Informationen an. Gültige Einträge sind ALLE und STATS. ALLE listen Statistiken für alle Indizes und auch Spalten auf, für die Statistiken erstellt wurden; STATS listet nur Statistiken auf, die keinem Index zugeordnet sind. value is nvarchar(5) with a default of STATS.

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Resultsets

In der folgenden Tabelle werden die Spalten des Resultsets beschrieben:

Spaltenname Beschreibung
statistics_name Der Name der Statistik. Gibt sysname zurück und darf nicht null sein.
statistics_keys Die Schlüssel, auf denen die Statistik basiert. Gibt nvarchar(2078) zurück und darf nicht null sein.

Hinweise

Verwenden Sie DBCC SHOW_STATISTICS, um detaillierte statistische Informationen zu einem bestimmten Index oder einer bestimmten Statistik anzuzeigen. Weitere Informationen finden Sie unter DBCC SHOW_STATISTICS (Transact-SQL) und sp_helpindex (Transact-SQL).

Berechtigungen

Erfordert die Mitgliedschaft in der public -Rolle.

Beispiele

Durch Ausführen von sp_createstats werden einspaltige Statistiken für alle in Frage kommenden Spalten aller Benutzertabellen in der AdventureWorks2022-Datenbank erstellt. Anschließend wird sp_helpstats ausgeführt, um die für die Customer-Tabelle erstellten Statistiken zu ermitteln.

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

Hier ist das Resultset.

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

Weitere Informationen

Gespeicherte Systemprozeduren (Transact-SQL)
Datenbank-Engine Gespeicherte Prozeduren (Transact-SQL)