DBCC SHOW_STATISTICS (Transact-SQL)
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. |
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
Référence
CREATE INDEX (Transact-SQL)
CREATE STATISTICS (Transact-SQL)
DBCC (Transact-SQL)
DROP STATISTICS (Transact-SQL)
sp_autostats (Transact-SQL)
sp_createstats (Transact-SQL)
STATS_DATE (Transact-SQL)
UPDATE STATISTICS (Transact-SQL)
USE (Transact-SQL)
Autres ressources
Aide et Informations
Assistance sur SQL Server 2005
Historique des modifications
Version | Historique |
---|---|
5 décembre 2005 |
|