Partager via

  • Article

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 rubriqueConventions de la syntaxe de 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. L'argument 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. Le paramètre value est de type nvarchar(5), avec STATS comme valeur par défaut.

Valeurs des codes retournés

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

Jeux de résultats

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

Nom de 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.

Exemple

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 AdventureWorks 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 AdventureWorks;
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