sp_helpstats (Transact-SQL)sp_helpstats (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Retourne les informations statistiques sur les colonnes et les index de la table spécifiée.Returns statistics information about columns and indexes on the specified table.

Important

Cette fonctionnalité sera supprimée dans la prochaine version de Microsoft SQL Server.This feature will be removed in the next version of 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é.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Pour obtenir des informations sur les statistiques, interrogez la sys.stats et sys.stats_columns affichages catalogue. To obtain information about statistics, query the sys.stats and sys.stats_columns catalog views.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


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

ArgumentsArguments

[ @objname=] 'nom_objet'[ @objname=] 'object_name'
Spécifie la table au sujet de laquelle les informations statistiques doivent être fournies.Specifies the table on which to provide statistics information. nom_objet est nvarchar(520) et ne peut pas être null.object_name is nvarchar(520) and cannot be null. Vous pouvez spécifier un nom en une ou deux parties.A one- or two-part name can be specified.

[ @results=] 'valeur'[ @results=] 'value'
Désigne l'étendue des informations à fournir.Specifies the extent of information to provide. Les entrées valides sont tous les et statistiques.Valid entries are ALL and STATS. Tous les répertorie les statistiques de tous les index et également les colonnes ayant des statistiques créées sur ces derniers ; Statistiques répertorie uniquement les statistiques non associées à un index.ALL lists statistics for all indexes and also columns that have statistics created on them; STATS only lists statistics not associated with an index. valeur est nvarchar (5) avec STATS comme valeur par défaut.value is nvarchar(5) with a default of STATS.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

Jeux de résultatsResult Sets

Le tableau suivant décrit les colonnes du jeu de résultats.The following table describes the columns in the result set.

Nom de colonneColumn name DescriptionDescription
statistics_namestatistics_name Nom des statistiques.The name of the statistics. Retourne sysname et ne peut pas être null.Returns sysname and cannot be null.
statistics_keysstatistics_keys Clés sur lesquelles sont basées les statistiques.The keys on which statistics are based. Retourne nvarchar (2078) et ne peut pas être null.Returns nvarchar(2078) and cannot be null.

NotesRemarks

Utilisez DBCC SHOW_STATISTICS pour afficher des informations statistiques détaillées sur l'index ou les statistiques de votre choix.Use DBCC SHOW_STATISTICS to display detailed statistics information about any particular index or statistics. Pour plus d’informations, consultez DBCC SHOW_STATISTICS (Transact-SQL) et sp_helpindex (Transact-SQL).For more information, see DBCC SHOW_STATISTICS (Transact-SQL) and sp_helpindex (Transact-SQL).

AutorisationsPermissions

Nécessite l'appartenance au rôle public .Requires membership in the public role.

ExemplesExamples

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 AdventureWorks2012AdventureWorks2012 en exécutant sp_createstats.The following example creates single-column statistics for all eligible columns for all user tables in the AdventureWorks2012AdventureWorks2012 database by executing sp_createstats. Ensuite, sp_helpstats est exécutée pour rechercher les statistiques résultantes créées sur la table Customer.Then, sp_helpstats is run to find the resultant statistics created on the Customer table.

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

Voici le jeu des résultats.Here is the result set.

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 aussiSee Also

Procédures stockées système (Transact-SQL) System Stored Procedures (Transact-SQL)
Procédures stockées du moteur de base de données (Transact-SQL)Database Engine Stored Procedures (Transact-SQL)