sp_helpstats (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Retourne les informations statistiques sur les colonnes et les index de la table spécifiée.

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Pour obtenir des informations sur les statistiques, interrogez les vues de catalogue sys.stats et sys.stats_columns .

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @objname = ] 'object_name' Spécifie la table sur laquelle fournir des informations de statistiques. object_name est nvarchar(520) et ne peut pas être null. Vous pouvez spécifier un nom en une ou deux parties.

[ @results = ] 'value' Spécifie l’étendue des informations à fournir. Les entrées valides sont ALL et STATS. ALL répertorie les statistiques pour tous les index et les colonnes qui ont créé des statistiques sur elles ; STATS répertorie uniquement les statistiques non associées à un index. la valeur est nvarchar(5) avec une valeur par défaut de STATS.

Codet de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

Le tableau suivant décrit les colonnes du jeu de résultats.

Nom de la colonne Description
statistics_name Nom des statistiques. Retourne sysname et ne peut pas être null.
statistics_keys Clés sur lesquelles sont basées les statistiques. Retourne nvarchar(2078) et ne peut pas être null.

Notes

Utilisez DBCC SHOW_STATISTICS pour afficher des informations statistiques détaillées sur l'index ou les statistiques de votre choix. Pour plus d’informations, consultez DBCC SHOW_STATISTICS (Transact-SQL) et sp_helpindex (Transact-SQL).

Autorisations

Nécessite l'appartenance au rôle public .

Exemples

L'exemple suivant crée des statistiques, réparties sur une seule colonne, pour toutes les colonnes possibles de toutes les tables utilisateur de la base de données AdventureWorks2022 en exécutant sp_createstats. Ensuite, sp_helpstats est exécutée pour rechercher les statistiques résultantes créées sur la table Customer.

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

Voici le jeu de résultats obtenu.

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

Voir aussi

Procédures stockées système (Transact-SQL)
procédures stockées Moteur de base de données (Transact-SQL)