Share via


sp_helpstats (Transact-SQL)

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

Important

Cette fonctionnalité sera supprimée dans la prochaine version de Microsoft 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 affichages catalogue sys.stats et sys.stats_columns.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

  • [ @objname=] 'object_name'
    Spécifie la table au sujet de laquelle les informations statistiques doivent être fournies. object_name est de type nvarchar(520) et ne peut pas être NULL. Vous pouvez spécifier un nom en une ou deux parties.

  • [ @results=] 'value'
    Désigne l'étendue des informations à fournir. Les entrées correctes sont ALL et STATS. ALL affiche la liste des statistiques de tous les index et également des colonnes qui ont fait l'objet de statistiques ; STATS affiche uniquement la liste des statistiques qui ne sont pas associées à un index. value est de type nvarchar(5) avec STATS comme valeur par défaut.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

La table suivante décrit les colonnes du jeu de résultats.

Nom de la colonne

Description

statistics_name

Nom des statistiques. Retourne sysname et ne peut être NULL.

statistics_keys

Clés sur lesquelles sont basées les statistiques. Retourne nvarchar(2078) et ne peut ê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 AdventureWorks2012 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 AdventureWorks2012;
GO
EXEC sp_createstats;
GO
EXEC sp_helpstats 
@objname = 'Sales.Customer',
@results = 'ALL'

Voici l'ensemble des résultats.

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

Référence

Procédures stockées système (Transact-SQL)

Procédures stockées du moteur de base de données (Transact-SQL)