Partager via

sp_helpstats (Transact-SQL)

  • Article

S’applique à : SQL Server Azure SQL Database Azure 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 = ] N'objname'
    [ , [ @results = ] N'results' ]
[ ; ]

Arguments

[ @objname = ] N’objname'

Spécifie la table au sujet de laquelle les informations statistiques doivent être fournies. @objname est nvarchar(776), sans valeur par défaut. Un nom en une ou deux parties peut être spécifié.

[ @results = ] N’results'

Désigne l'étendue des informations à fournir. @results est nvarchar(5), avec la valeur par défaut STATS.

  • ALL répertorie les statistiques pour tous les index et les colonnes qui ont des statistiques créées sur elles.
  • STATS répertorie uniquement les statistiques non associées à un index.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu 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

Permet DBCC SHOW_STATISTICS d’afficher des informations détaillées sur les statistiques relatives à un index ou à des statistiques spécifiques. Pour plus d’informations, consultez DBCC SHOW_STATISTICS et sp_helpindex.

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.

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

Contenu connexe