DBCC SHOW_STATISTICS (Transact-SQL)

Article
12/15/2008

Mis à jour : 5 décembre 2005

Affiche les statistiques de distribution courantes pour la cible indiquée de la table spécifiée.

Important :
Cette fonction est différente de celle des précédentes versions de SQL Server. Pour plus d'informations, consultez Changements de comportement des fonctionnalités du moteur de base de données de SQL Server 2005.

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

Syntaxe

DBCC SHOW_STATISTICS ( table_name | view_name , target ) 
[ WITH [ NO_INFOMSGS ] < option > [ , n ] ]
< option > :: =
    STAT_HEADER | DENSITY_VECTOR | HISTOGRAM

Arguments

table_name | view_name**
Nom de la table ou de la vue indexée dont les informations statistiques doivent être affichées. Les noms de tables ou de vues doivent respecter les règles applicables aux identificateurs.

target
Nom de l’objet (nom d’index, nom de statistique ou nom de colonne) pour lequel les informations statistiques doivent être affichées. Les noms de cibles doivent respecter les règles relatives aux identificateurs. Si target est le nom d'une statistique ou d'un index existant dans une table, les informations statistiques sur cette cible sont retournées. Si target est le nom d'une colonne existante et qu'il existe une statistique créée automatiquement dans cette colonne, les informations sur ces statistiques créées automatiquement sont retournées.

NO_INFOMSGS
Supprime tous les messages d'information dont les niveaux de gravité sont compris entre 0 et 10.

STAT_HEADER | DENSITY_VECTOR | HISTOGRAM [ **,**n ]
La spécification d'une ou plusieurs de ces options limite les jeux de résultats retournés par l'instruction à l'option spécifiée. Si aucune option n'est spécifiée, toutes les informations statistiques sont retournées.

Jeux de résultats

Le tableau suivant décrit les colonnes retournées dans le jeu de résultats lorsque STAT_HEADER est spécifié.

Nom de la colonne	Description
Name	Nom de la statistique
Updated	Date et heure de la dernière mise à jour des statistiques
Rows	Nombre de lignes dans la table
Rows Sampled	Nombre de lignes échantillonnées pour les informations statistiques
Steps	Nombre d'étapes de distribution
Density	Sélectivité du premier préfixe de colonne d'index, à l'exception de EQ_ROWS, figurant dans la section concernant le jeu de résultats de l'option HISTOGRAM.
Average key length	Longueur moyenne de toutes les colonnes d'index
String Index	Yes indique que les statistiques contiennent un index résumé de chaîne pour permettre l'estimation des tailles des jeux de résultats pour les conditions LIKE. S'applique uniquement aux premières colonnes de char, varchar, nchar et de nvarchar, varchar(max), nvarchar(max), text, ainsi qu'aux types de données ntext.

Le tableau suivant décrit les colonnes retournées dans le jeu de résultats lorsque DENSITY_VECTOR est spécifié.

Nom de la colonne	Description
All density	Sélectivité d'un ensemble de préfixes de colonnes d'index, y compris EQ_ROWS, figurant dans la section concernant le jeu de résultats de l'option HISTOGRAM.
Average length	Longueur moyenne d'un jeu de préfixes de colonnes d'index
Columns	Noms des préfixes de colonnes d'index dont les valeurs All density et Average length sont affichées.

Le tableau suivant décrit les colonnes retournées dans le jeu de résultats lorsque HISTOGRAM est spécifié.

Nom de la colonne	Description
RANGE_HI_KEY	Valeur limite supérieure d'une étape d'histogramme
RANGE_ROWS	Nombre estimé de lignes de la table qui sont comprises dans une étape d'histogramme, excepté la limite supérieure.
EQ_ROWS	Nombre estimé de lignes de la table dont la valeur est égale à la limite supérieure de l'étape d'histogramme.
DISTINCT_RANGE_ROWS	Nombre estimé de valeurs distinctes dans une étape d'histogramme, excepté la limite supérieure.
AVG_RANGE_ROWS	Nombre moyen de valeurs doubles dans une étape d'histogramme, excepté la limite supérieure (RANGE_ROWS / DISTINCT_RANGE_ROWS for DISTINCT_RANGE_ROWS > 0).

Notes

Les résultats retournés indiquent la sélectivité d'un index (plus la densité retournée est faible, plus l'index est sélectif) et permettent de déterminer si un index est utile ou non pour l'optimiseur de requête. Les résultats retournés se basent sur les étapes de distribution de l'index.

Pour afficher la date de dernière mise à jour des statistiques, utilisez la fonction STATS_DATE.

Autorisations

L'utilisateur doit être propriétaire de la table ou appartenir au rôle de serveur fixe sysadmin, au rôle de base de données fixe db_owner ou au rôle de base de données fixe db_ddladmin.

Exemples

A. Renvoi de toutes les informations statistiques

L'exemple suivant affiche toutes les informations statistiques relatives à l'index AK_Product_Name de la table Person.Address .

USE AdventureWorks;
GO
DBCC SHOW_STATISTICS ("Person.Address", AK_Address_rowguid);
GO

B. Utilisation de l'option HISTOGRAM

L'exemple suivant limite les informations statistiques affichées pour l'index AK_Product_Name aux données HISTOGRAM.

USE AdventureWorks;
GO
DBCC SHOW_STATISTICS ("Person.Address", AK_Address_rowguid) WITH HISTOGRAM;
GO

Voir aussi

Historique des modifications

Version	Historique
5 décembre 2005	Contenu modifié : Une correction a été apportée à la description de la colonne Density pour le jeu de résultats produit par l'option STAT_HEADER. Une correction a été apportée à la description de la colonne All density pour le jeu de résultats produit par l'option DENSITY_VECTOR.