sys.dm_db_index_physical_stats

Mis à jour : 15 septembre 2007

Renvoie les informations de taille et de fragmentation pour les données et les index de la table ou de la vue spécifiée. Pour un index, une ligne est renvoyée pour chaque niveau de l'arbre B (B-tree) dans chaque partition. Pour un segment de mémoire, une ligne est renvoyée pour l'unité d'allocation IN_ROW_DATA de chaque partition. Pour les données LOB, une ligne est renvoyée pour l'unité d'allocation LOB_DATA de chaque partition. S'il existe des données en dépassement de capacité des lignes dans la table, une ligne est renvoyée pour l'unité d'allocation ROW_OVERFLOW_DATA dans chaque partition. Pour plus d'informations sur les unités d'allocation et les partitions, consultez Architecture des tables et des index.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sys.dm_db_index_physical_stats ( 
    { database_id | NULL | 0 | DEFAULT }
    , { object_id | NULL | 0 | DEFAULT }
    , { index_id | NULL | 0 | -1 | DEFAULT }
    , { partition_number | NULL | 0 | DEFAULT }
    , { mode | NULL | DEFAULT }
)

Arguments

• database_id | NULL | 0 | DEFAULT
  Identificateur de la base de données. database_id est de type smallint. Les entrées autorisées sont l'ID d'une base de données ou la valeur NULL, 0 ou DEFAULT. La valeur par défaut est 0. Les valeurs NULL, 0 et DEFAULT sont des valeurs équivalentes dans ce contexte.

  Spécifiez NULL pour retourner des informations concernant toutes les bases de données de l'instance de SQL Server. Si vous spécifiez la valeur NULL pour database_id, vous devez également spécifier NULL pour object_id, index_id et partition_number.

  Vous pouvez spécifier la fonction intégrée DB_ID. Si vous utilisez DB_ID sans spécifier de nom de base de données, le niveau de compatibilité de la base de données active doit être égal à 90.

• object_id | NULL | 0 | DEFAULT
  ID d'objet de la table ou de la vue vers laquelle pointe l'index. object_id est de type int.

  Les entrées autorisées sont l'ID d'une table et d'une vue ou la valeur NULL, 0 ou DEFAULT. La valeur par défaut est 0. Les valeurs NULL, 0 et DEFAULT sont des valeurs équivalentes dans ce contexte.

  Spécifiez la valeur NULL pour renvoyer des informations sur toutes les tables et les vues de la base de données spécifiée. Si vous spécifiez la valeur NULL pour object_id, vous devez également spécifier NULL pour index_id et partition_number.

• index_id | 0 | NULL | -1 | DEFAULT
  Identificateur de l'index. index_id est de type int. Les entrées autorisées sont l'ID d'un index, 0 si object_id est un segment de mémoire, ou la valeur NULL, -1 ou DEFAULT. La valeur par défaut est -1. Les valeurs NULL, -1 et DEFAULT sont des valeurs équivalentes dans ce contexte.

  Spécifiez la valeur NULL pour renvoyer des informations sur tous les index d'une table de base ou d'une vue. Si vous spécifiez la valeur NULL pour index_id, vous devez également spécifier NULL pour partition_number.

• partition_number | NULL | 0 | DEFAULT
  Numéro de partition dans l'objet. partition_number est de type int. Les entrées autorisées sont le numéro de partition (partion_number) d'un index ou d'un segment de mémoire, ou la valeur NULL, 0 ou DEFAULT. La valeur par défaut est 0. Les valeurs NULL, 0 et DEFAULT sont des valeurs équivalentes dans ce contexte.

  Spécifiez NULL pour renvoyer des informations sur toutes les partitions de l'objet propriétaire.

  partition_number est de base 1. Pour un index ou un segment de mémoire non partitionné, partition_number est égal à 1.

• mode | NULL | DEFAULT
  Nom du mode. mode spécifie le niveau d'analyse utilisé pour obtenir les statistiques. mode est de type sysname. Les entrées autorisées sont DEFAULT, NULL, LIMITED, SAMPLED ou DETAILED. La valeur par défaut (NULL) est LIMITED.

Notes

La fonction de gestion dynamique sys.dm_db_index_physical_stats remplace l'instruction DBCC SHOWCONTIG. Cette fonction de gestion dynamique n'accepte pas les paramètres corrélés provenant de CROSS APPLY et de OUTER APPLY.

Modes d'analyse

Le mode d'exécution de la fonction détermine le niveau de l'analyse effectuée pour obtenir les données statistiques utilisées par la fonction. mode est spécifié avec LIMITED, SAMPLED ou DETAILED. La fonction traverse les chaînes de pages des unités d'allocation qui composent les partitions spécifiées de la table ou de l'index. sys.dm_db_index_physical_stats ne nécessite qu'un verrou de table de partage intentionnel IS (Intent-Shared), quel que soit son mode d'exécution. Pour plus d'informations sur les verrous, consultez Modes de verrouillage.

Le mode LIMITED est le plus rapide : il analyse le plus petit nombre de pages. Il analyse toutes les pages d'un segment de mémoire, mais seulement les pages de niveau parent d'un index, c'est-à-dire les pages au-dessus du niveau feuille.

Le mode SAMPLED renvoie des statistiques prélevées sur un échantillon de 1 % de toutes les pages de l'index ou du segment de mémoire. Si l'index ou le segment de mémoire comporte moins de 10 000 pages, le mode DETAILED est utilisé à la place du mode SAMPLED.

Le mode DETAILED analyse toutes les pages et renvoie toutes les statistiques.

Les modes sont graduellement plus lents de LIMITED à DETAILED, du fait qu'ils exécutent plus de travail. Pour évaluer rapidement la taille ou le niveau de fragmentation d'une table ou d'un index, utilisez le mode LIMITED. Il s'agit du mode le plus rapide qui ne renvoie pas une ligne pour chaque niveau non-feuille dans l'unité d'allocation IN_ROW_DATA de l'index.

Utilisation de fonctions système pour spécifier des valeurs de paramètres

Vous pouvez utiliser les fonctions Transact-SQL DB_ID et OBJECT_ID pour spécifier une valeur pour les paramètres database_id et object_id. Toutefois, la transmission de valeurs non valides à ces fonctions peut entraîner des résultats imprévisibles. Par exemple, si le nom de la base de données ou de l'objet est introuvable car il n'existe pas ou il est mal orthographié, les deux fonctions retournent la valeur NULL. La fonction sys.dm_db_index_physical_stats interprète NULL comme une valeur générique qui spécifie toutes les bases de données ou tous les objets.

Qui plus est, la fonction OBJECT_ID est traitée avant l'appel de la fonction sys.dm_db_index_physical_stats, et par conséquent, elle est évaluée dans le contexte de la base de données actuelle, et non celui de la base de données spécifiée dans database_id. Il est possible que la fonction OBJECT_ID retourne une valeur NULL ; ou, si le nom d'objet existe dans le contexte de la base de données active et la base de données spécifiée, un message d'erreur peut être retourné. Les exemples suivants présentent ces résultats inattendus.

USE master;
GO
-- In this example, OBJECT_ID is evaluated in the context of the master database. 
-- Because Person.Address does not exist in master, the function returns NULL.
-- When NULL is specified as an object_id, all objects in the database are returned.
-- The same results are returned when an object that is not valid is specified.
SELECT * FROM sys.dm_db_index_physical_stats
    (DB_ID(N'AdventureWorks'), OBJECT_ID(N'Person.Address'), NULL, NULL , 'DETAILED');
GO
-- This example demonstrates the results of specifying a valid object name
-- that exists in both the current database context and
-- in the database specified in the database_id parameter of the 
-- sys.dm_db_index_physical_stats function.
-- An error is returned because the ID value returned by OBJECT_ID does not
-- match the ID value of the object in the specified database.
CREATE DATABASE Test;
GO
USE Test;
GO
CREATE SCHEMA Person;
GO
CREATE Table Person.Address(c1 int);
GO
USE AdventureWorks;
GO
SELECT * FROM sys.dm_db_index_physical_stats
    (DB_ID(N'Test'), OBJECT_ID(N'Person.Address'), NULL, NULL , 'DETAILED');
GO
-- Clean up temporary database.
DROP DATABASE Test;
GO

Méthode recommandée

Assurez-vous systématiquement qu'un ID valide est retourné lorsque vous utilisez DB_ID ou OBJECT_ID. Par exemple, lorsque vous utilisez OBJECT_ID, spécifiez un nom en trois parties tel que OBJECT_ID(N'AdventureWorks.Person.Address'), ou testez la valeur retournée par les fonctions avant de les utiliser dans la fonction sys.dm_db_index_physical_stats. Les exemples A et B qui suivent illustrent une méthode sûre pour déterminer des ID de bases de données et d'objets.

Détection de la fragmentation

La fragmentation a lieu lors de la modification des données (instructions INSERT, UPDATE et DELETE) effectuées sur la table, et donc dans les index définis sur la table. Comme ces modifications ne sont généralement pas distribuées équitablement entre les lignes de la table et des index, le remplissage de chaque page peut varier dans le temps. Pour les requêtes qui analysent tout ou partie des index d'une table, ce type de fragmentation peut entraîner des lectures de pages supplémentaires. Cela perturbe l'analyse parallèle des données.

L'algorithme de calcul de la fragmentation est plus précis dans SQL Server 2005 que dans SQL Server 2000. Par conséquent, les valeurs de fragmentation semblent plus élevées. Par exemple, dans SQL Server 2000, une table n'est pas considérée comme fragmentée si sa page 11 et sa page 13 ne se trouvent pas dans la même étendue que sa page 12. Pourtant, étant donné que 2 opérations d'E/S physiques seraient nécessaires pour accéder à ces 2 pages, SQL Server 2005 en tient compte dans ses calculs de fragmentation.

Le niveau de fragmentation d'un index ou d'un segment de mémoire est affiché dans la colonne avg_fragmentation_in_percent. Pour les segments de mémoire, cette valeur représente la fragmentation de l'étendue du segment. Pour les index, cette valeur représente la fragmentation logique de l'index. À la différence de DBCC SHOWCONTIG, les algorithmes de calcul de la fragmentation considèrent dans les deux cas l'espace de stockage qui englobe plusieurs fichiers : ils sont donc précis.

Fragmentation logique

Pourcentage de pages hors service dans les pages de feuilles d'un index. Une page non ordonnée est une page pour laquelle la page physique suivante allouée à l'index n'est pas la page désignée par le pointeur de page suivante dans la page feuille actuelle.

Fragmentation de l'étendue

Pourcentage d'étendues hors service dans les pages de feuilles d'un segment de mémoire. Une étendue est hors service lorsque l'étendue qui contient la page active d'un segment de mémoire n'est pas physiquement l'étendue suivant l'étendue contenant la page précédente.

La valeur de avg_fragmentation_in_percent doit être aussi proche que possible de zéro pour obtenir des performances maximales. Cependant, des valeurs comprises entre 0 et 10 % sont acceptables. Toutes les méthodes de réduction de la fragmentation (par exemple, la reconstruction, la réorganisation ou la recréation) peuvent s'utiliser pour diminuer ces valeurs. Pour plus d'informations sur l'analyse du degré de fragmentation d'un index, consultez Réorganisation et reconstruction d'index.

Réduction de la fragmentation d'un index

Lorsqu'un index est fragmenté de telle façon que la fragmentation nuit aux performances des requêtes, il existe trois possibilités de réduction de la fragmentation :

• Supprimer l'index cluster, puis le recréer.
  Le fait de recréer un index cluster redistribue les données et produit des pages de données complètes. Vous pouvez configurer le niveau de remplissage à l'aide de l'option FILLFACTOR de l'instruction CREATE INDEX. Cette méthode présente deux inconvénients : l'index est en mode hors connexion pendant la suppression et la recréation, et l'opération est atomique. Si la création de l'index est interrompue, l'index n'est pas recréé. Pour plus d'informations, consultez CREATE INDEX (Transact-SQL).
• Utilisez l'instruction ALTER INDEX REORGANIZE, qui remplace DBCC INDEXDEFRAG, pour réorganiser dans un ordre logique les pages de feuilles de l'index. Du fait qu'il s'agit d'une opération en ligne, l'index est disponible lorsque l'instruction est en cours d'exécution. Il est également possible d'interrompre l'opération sans perdre le travail déjà effectué. L'inconvénient de cette méthode est que la réorganisation des données est moins efficace que la reconstruction d'un index et qu'elle ne met pas à jour les statistiques.
• Utilisez l'instruction ALTER INDEX REBUILD, qui remplace DBCC DBREINDEX, pour reconstruire l'index en ligne ou hors ligne. Pour plus d'informations, consultez ALTER INDEX (Transact-SQL).

La fragmentation seule n'est pas une raison suffisante pour réorganiser ou reconstruire un index. Le principal effet de la fragmentation est le ralentissement de la lecture anticipée lors de l'analyse d'un index. Les temps de réponse sont donc plus longs. Si la charge de travail d'une requête sur une table ou un index fragmenté n'implique pas d'analyses car elle concerne essentiellement des recherches de singletons, la suppression de la fragmentation peut n'avoir aucun effet. Pour plus d'informations, consultez ce site Web de Microsoft.

Remarque :
L'exécution de DBCC SHRINKFILE ou de DBCC SHRINKDATABASE peut fragmenter un index si celui-ci est partiellement ou totalement déplacé pendant le compactage. Par conséquent, si une opération de compactage doit être effectuée, vous ne devez pas l'exécuter après la suppression de la fragmentation.

Réduction de la fragmentation d'un segment de mémoire

Pour réduire la fragmentation de l'étendue d'un segment de mémoire, créez un index cluster sur la table puis supprimez l'index. Cela redistribue les données pendant la création de l'index cluster. Si l'on considère l'espace disponible dans la base de données, l'organisation des données est également optimale. Lorsque l'index cluster est par la suite supprimé pour recréer le segment de mémoire, les données ne sont pas déplacées et restent en position optimale. Pour plus d'informations sur l'exécution de ces opérations, consultez CREATE INDEX et DROP INDEX.

Compactage des données objets de grande taille

Par défaut, l'instruction ALTER INDEX REORGANIZE compacte les pages qui contiennent des données objets de grande taille (LOB). Du fait que les pages LOB ne sont pas désallouées lorsqu'elles sont vides, le compactage de ces données peut améliorer l'utilisation de l'espace disque si un grand nombre de données LOB ont été supprimées ou si une colonne LOB est supprimée.

La réorganisation d'un index cluster spécifié compacte toutes les colonnes LOB contenues dans l'index cluster. La réorganisation d'un index non-cluster compacte toutes les colonnes LOB qui sont des colonnes non-clé (incluses) dans l'index. Lorsque l'argument ALL est spécifié dans l'instruction, tous les index associés à la table ou à la vue spécifiée sont réorganisés. De plus, toutes les colonnes LOB associées à l'index cluster, la table sous-jacente ou l'index non-cluster avec des colonnes incluses sont compactés.

Évaluation de l'utilisation de l'espace disque

La colonne avg_page_space_used_in_percent indique le remplissage des pages. Pour une utilisation optimale de l'espace disque, cette valeur doit être aussi proche que possible de 100 % pour un index qui n'aura pas beaucoup d'insertions aléatoires. Cependant, un index qui a beaucoup d'insertions aléatoires et des pages très remplies comportera un nombre plus élevé de fractionnements de pages. Cela implique une fragmentation plus importante. Par conséquent, pour réduire les fractionnements, la valeur doit être inférieure à 100 %. La reconstruction d'un index en spécifiant l'option FILLFACTOR permet de modifier le remplissage des pages pour adapter le modèle de requête à l'index. Pour plus d'informations sur le coefficient de remplissage, consultez Taux de remplissage. L'instruction ALTER INDEX REORGANIZE compacte également un index en essayant de remplir les pages en fonction de la dernière valeur FILLFACTOR spécifiée. Cela augmente la valeur de avg_space_used_in_percent. Notez que ALTER INDEX REORGANIZE ne peut pas réduire le remplissage des pages. Au lieu de cela, une reconstruction de l'index doit avoir lieu.

Évaluation des fragments des index

Un fragment se compose de pages de feuilles physiquement contiguës dans le même fichier d'une unité d'allocation. Un index comporte au moins un fragment. Le nombre maximal de fragments d'un index est égal au nombre de pages du niveau feuille de l'index. Des fragments plus importants signifient que moins d'opérations d'entrées/sorties sur le disque sont nécessaires pour lire le même nombre de pages. Par conséquent, plus la valeur avg_fragment_size_in_pages est élevée, meilleures sont les performances d'analyse. Les valeurs avg_fragment_size_in_pages et avg_fragmentation_in_percent sont inversement proportionnelles. La reconstruction ou la réorganisation d'un index doit donc réduire la quantité de fragmentation et augmenter la taille des fragments.

Autorisations

Les autorisations suivantes sont nécessaires :

• autorisation CONTROL sur l'objet spécifié dans la base de données ;
• autorisation VIEW DATABASE STATE pour renvoyer des informations sur tous les objets dans la base de données spécifiée en utilisant l'objet générique @object_id=NULL ;
• autorisation VIEW SERVER STATE pour renvoyer des informations sur toutes les bases de données en utilisant la base de données générique @database_id=NULL.

L'octroi de l'autorisation VIEW DATABASE STATE autorise le renvoi de tous les objets de la base de données, quelles que soient les autorisations CONTROL refusées sur des objets spécifiques.

Le refus de l'autorisation VIEW DATABASE STATE interdit le renvoi de tous les objets de la base de données, quelles que soient les autorisations CONTROL accordées sur des objets spécifiques. De plus, lorsque la base de données générique @database_id=NULL est spécifiée, la base de données est omise.

Pour plus d'informations, consultez Fonctions et vues de gestion dynamique.

Table renvoyée

Nom de la colonne

Type de données

Description

database_id

smallint

ID de base de données de la table ou de la vue.

object_id

int

ID d'objet de la table ou de la vue vers laquelle pointe l'index.

index_id

int

ID d'index d'un index.

0 = Segment de mémoire.

partition_number

int

Numéro de partition de base 1 dans l'objet propriétaire : une table, une vue ou un index.

1 = Index ou segment de mémoire non partitionné.

index_type_desc

nvarchar(60)

Description du type d'index :

HEAP

CLUSTERED INDEX

NONCLUSTERED INDEX

PRIMARY XML INDEX

XML INDEX

alloc_unit_type_desc

nvarchar(60)

Description du type d'unité d'allocation :

IN_ROW_DATA

LOB_DATA

ROW_OVERFLOW_DATA

L'unité d'allocation LOB_DATA contient les données stockées dans des colonnes de type text, ntext, image, varchar(max), nvarchar(max), **varbinary(max)**et xml. Pour plus d'informations, consultez Types de données (Transact-SQL).

L'unité d'allocation ROW_OVERFLOW_DATA contient les données stockées dans des colonnes de type varchar(n), nvarchar(n), varbinary(n) et sql_variant qui ont été déplacées hors des lignes. Pour plus d'informations, consultez Données de dépassement de ligne de plus de 8 Ko.

index_depth

tinyint

Nombre de niveaux des index.

1 = Segment de mémoire ou unité d'allocation LOB_DATA ou ROW_OVERFLOW_DATA.

index_level

tinyint

Niveau actuel de l'index.

0 pour des index de niveau feuille, des segments de mémoire et des unités d'allocation LOB_DATA ou ROW_OVERFLOW_DATA.

Supérieur à 0 pour les index de niveaux non-feuille. index_level a la valeur maximale au niveau racine d'un index.

Les niveaux non-feuille des index sont traités uniquement lorsque mode = DETAILED.

avg_fragmentation_in_percent

float

Fragmentation logique des index ou fragmentation de l'étendue des segments de mémoire dans l'unité d'allocation IN_ROW_DATA.

La valeur est mesurée en pourcentage et prend en compte plusieurs fichiers. Pour les définitions de la fragmentation logique et de la fragmentation de l'étendue, consultez la section Notes.

0 pour les unités d'allocation LOB_DATA et ROW_OVERFLOW_DATA.

NULL pour les segments de mémoire lorsque mode = SAMPLED.

fragment_count

bigint

Nombre de fragments dans le niveau feuille d'une unité d'allocation IN_ROW_DATA. Pour plus d'informations sur les fragments, consultez la section Notes.

NULL pour les niveaux non-feuille d'un index et les unités d'allocation LOB_DATA ou ROW_OVERFLOW_DATA.

NULL pour les segments de mémoire lorsque mode = SAMPLED.

avg_fragment_size_in_pages

float

Nombre moyen de pages dans un fragment au niveau feuille d'une unité d'allocation IN_ROW_DATA.

NULL pour les niveaux non-feuille d'un index et les unités d'allocation LOB_DATA ou ROW_OVERFLOW_DATA.

NULL pour les segments de mémoire lorsque mode = SAMPLED.

page_count

bigint

Nombre total d'index ou de pages de données.

Pour un index, il s'agit du nombre total de pages d'index au niveau actuel de l'arbre B (B-tree) dans l'unité d'allocation IN_ROW_DATA.

Pour un segment de mémoire, il s'agit du nombre total de pages de données dans l'unité d'allocation IN_ROW_DATA.

Pour les unités d'allocation LOB_DATA or ROW_OVERFLOW_DATA, il s'agit du nombre total de pages dans l'unité d'allocation.

avg_page_space_used_in_percent

float

Pourcentage moyen d'espace de stockage disponible utilisé dans toutes les pages.

Pour un index, la moyenne s'applique au niveau actuel de l'arbre B (B-tree) dans l'unité d'allocation IN_ROW_DATA.

Pour un segment de mémoire, il s'agit de la moyenne de toutes les pages de données dans l'unité d'allocation IN_ROW_DATA.

Pour les unités d'allocation LOB_DATA or ROW_OVERFLOW_DATA, il s'agit de la moyenne de toutes les pages dans l'unité d'allocation.

NULL lorsque mode = LIMITED.

record_count

bigint

Nombre total d'enregistrements.

Pour un index, le nombre total d'enregistrements s'applique au niveau actuel de l'arbre B (B-tree) dans l'unité d'allocation IN_ROW_DATA.

Pour un segment de mémoire, il s'agit du nombre total d'enregistrements dans l'unité d'allocation IN_ROW_DATA.

Pour les unités d'allocation LOB_DATA or ROW_OVERFLOW_DATA, il s'agit du nombre total d'enregistrements dans toute l'unité d'allocation.

NULL lorsque mode = LIMITED.

Remarque :

Pour un segment, le nombre d'enregistrements retournés par cette fonction peut ne pas correspondre au nombre de lignes retournées en exécutant une instruction SELECT COUNT (*) sur le segment. Cela est dû au fait qu'une ligne peut contenir plusieurs enregistrements. Par exemple, suite à certaines mises à jour, une ligne de segment peut contenir à elle seule un enregistrement de transfert et un enregistrement transféré. Par ailleurs, la plupart des lignes LOB volumineuses sont fractionnées en plusieurs enregistrements dans le stockage LOB_DATA.

ghost_record_count

bigint

Nombre d'enregistrements de type Ghost prêts à être supprimés par la tâche de nettoyage des enregistrements de type Ghost dans l'unité d'allocation.

0 pour les niveaux non-feuille d'un index dans l'unité d'allocation IN_ROW_DATA.

NULL lorsque mode = LIMITED.

version_ghost_record_count

bigint

Nombre d'enregistrements de type Ghost retenus par une transaction d'isolement de capture instantanée en attente dans une unité d'allocation.

0 pour les niveaux non-feuille d'un index dans l'unité d'allocation IN_ROW_DATA.

NULL lorsque mode = LIMITED.

min_record_size_in_bytes

int

Taille minimale des enregistrements en octets.

Pour un index, la taille minimale des enregistrements s'applique au niveau actuel de l'arbre B (B-tree) dans l'unité d'allocation IN_ROW_DATA.

Pour un segment de mémoire, il s'agit de la taille minimale des enregistrements dans l'unité d'allocation IN_ROW_DATA.

Pour les unités d'allocation LOB_DATA ou ROW_OVERFLOW_DATA, il s'agit de la taille minimale des enregistrements dans toute l'unité d'allocation.

NULL lorsque mode = LIMITED.

max_record_size_in_bytes

int

Taille maximale des enregistrements en octets.

Pour un index, la taille maximale des enregistrements s'applique au niveau actuel de l'arbre B (B-tree) dans l'unité d'allocation IN_ROW_DATA.

Pour un segment de mémoire, il s'agit de la taille maximale des enregistrements dans l'unité d'allocation IN_ROW_DATA.

Pour les unités d'allocation LOB_DATA ou ROW_OVERFLOW_DATA, il s'agit de la taille maximale des enregistrements dans toute l'unité d'allocation.

NULL lorsque mode = LIMITED.

avg_record_size_in_bytes

float

Taille moyenne des enregistrements en octets.

Pour un index, la taille moyenne des enregistrements s'applique au niveau actuel de l'arbre B (B-tree) dans l'unité d'allocation IN_ROW_DATA.

Pour un segment de mémoire, il s'agit de la taille moyenne des enregistrements dans l'unité d'allocation IN_ROW_DATA.

Pour les unités d'allocation LOB_DATA ou ROW_OVERFLOW_DATA, il s'agit de la taille moyenne des enregistrements dans toute l'unité d'allocation.

NULL lorsque mode = LIMITED.

forwarded_record_count

bigint

Nombre d'enregistrements d'un segment qui contiennent des pointeurs avant vers un autre emplacement de données. (Cet état se produit pendant une mise à jour, lorsque l'espace disponible est insuffisant pour stocker la nouvelle ligne à l'emplacement d'origine.)

NULL pour toute unité d'allocation différente des unités d'allocation IN_ROW_DATA d'un segment de mémoire.

NULL pour les segments de mémoire lorsque mode = LIMITED.

Exemples

A. Renvoie d'informations sur une table spécifiée

Le code exemple suivant renvoie des statistiques de taille et de fragmentation sur tous les index et partitions de la table Person.Address de la base de données AdventureWorks. Le mode d'analyse est défini à 'LIMITED' pour améliorer les performances et limiter les statistiques retournées. L'exécution de cette requête nécessite, au minimum, l'autorisation CONTROL sur la table Person.Address.

DECLARE @db_id SMALLINT;
DECLARE @object_id INT;

SET @db_id = DB_ID(N'AdventureWorks');
SET @object_id = OBJECT_ID(N'AdventureWorks.Person.Address');

IF @db_id IS NULL
BEGIN;
    PRINT N'Invalid database';
END;
ELSE IF @object_id IS NULL
BEGIN;
    PRINT N'Invalid object';
END;
ELSE
BEGIN;
    SELECT * FROM sys.dm_db_index_physical_stats(@db_id, @object_id, NULL, NULL , 'LIMITED');
END;
GO

B. Renvoie d'informations sur un segment de mémoire

Le code exemple suivant renvoie toutes les statistiques sur le segment de mémoire dbo.DatabaseLog de la base de données AdventureWorks. Comme la table contient des données LOB, une ligne est renvoyée pour l'unité d'allocation LOB_DATA, en plus de la ligne renvoyée pour l'unité d'allocation IN_ROW_ALLOCATION_UNIT qui stocke les pages de données du segment de mémoire. L'exécution de cette requête nécessite, au minimum, l'autorisation CONTROL sur la table dbo.DatabaseLog.

DECLARE @db_id SMALLINT;
DECLARE @object_id INT;
SET @db_id = DB_ID(N'AdventureWorks');
SET @object_id = OBJECT_ID(N'AdventureWorks.dbo.DatabaseLog');
IF @object_id IS NULL 
BEGIN;
    PRINT N'Invalid object';
END;
ELSE
BEGIN;
    SELECT * FROM sys.dm_db_index_physical_stats(@db_id, @object_id, 0, NULL , 'DETAILED');
END;
GO

C. Renvoie d'informations sur toutes les bases de données

L'exemple suivant retourne toutes les statistiques de l'ensemble des tables et des index dans l'instance de SQL Server en spécifiant la valeur générique NULL pour tous les paramètres. L'exécution de cette requête nécessite l'autorisation VIEW SERVER STATE.

SELECT * FROM sys.dm_db_index_physical_stats (NULL, NULL, NULL, NULL, NULL);
GO

D. Utilisation de sys.dm_db_index_physical_stats dans un script pour reconstruire ou réorganiser des index

Le code exemple suivant réorganise ou reconstruit automatiquement toutes les partitions d'une base de données dont la fragmentation moyenne est supérieure à 10 %. L'exécution de cette requête nécessite l'autorisation VIEW DATABASE STATE. Cet exemple spécifie DB_ID en tant que premier paramètre sans fournir de nom de base de données. Une erreur sera retournée si le niveau de compatibilité de la base de données active est inférieur ou égal à 80. Pour résoudre cette erreur, remplacez DB_ID() par un nom de base de données valide. Pour plus d'informations sur les niveaux de compatibilité des bases de données, consultez sp_dbcmptlevel (Transact-SQL).

-- Ensure a USE <databasename> statement has been executed first.
SET NOCOUNT ON;
DECLARE @objectid int;
DECLARE @indexid int;
DECLARE @partitioncount bigint;
DECLARE @schemaname nvarchar(130); 
DECLARE @objectname nvarchar(130); 
DECLARE @indexname nvarchar(130); 
DECLARE @partitionnum bigint;
DECLARE @partitions bigint;
DECLARE @frag float;
DECLARE @command nvarchar(4000); 
-- Conditionally select tables and indexes from the sys.dm_db_index_physical_stats function 
-- and convert object and index IDs to names.
SELECT
    object_id AS objectid,
    index_id AS indexid,
    partition_number AS partitionnum,
    avg_fragmentation_in_percent AS frag
INTO #work_to_do
FROM sys.dm_db_index_physical_stats (DB_ID(), NULL, NULL , NULL, 'LIMITED')
WHERE avg_fragmentation_in_percent > 10.0 AND index_id > 0;

-- Declare the cursor for the list of partitions to be processed.
DECLARE partitions CURSOR FOR SELECT * FROM #work_to_do;

-- Open the cursor.
OPEN partitions;

-- Loop through the partitions.
WHILE (1=1)
    BEGIN;
        FETCH NEXT
           FROM partitions
           INTO @objectid, @indexid, @partitionnum, @frag;
        IF @@FETCH_STATUS < 0 BREAK;
        SELECT @objectname = QUOTENAME(o.name), @schemaname = QUOTENAME(s.name)
        FROM sys.objects AS o
        JOIN sys.schemas as s ON s.schema_id = o.schema_id
        WHERE o.object_id = @objectid;
        SELECT @indexname = QUOTENAME(name)
        FROM sys.indexes
        WHERE  object_id = @objectid AND index_id = @indexid;
        SELECT @partitioncount = count (*)
        FROM sys.partitions
        WHERE object_id = @objectid AND index_id = @indexid;

-- 30 is an arbitrary decision point at which to switch between reorganizing and rebuilding.
        IF @frag < 30.0
            SET @command = N'ALTER INDEX ' + @indexname + N' ON ' + @schemaname + N'.' + @objectname + N' REORGANIZE';
        IF @frag >= 30.0
            SET @command = N'ALTER INDEX ' + @indexname + N' ON ' + @schemaname + N'.' + @objectname + N' REBUILD';
        IF @partitioncount > 1
            SET @command = @command + N' PARTITION=' + CAST(@partitionnum AS nvarchar(10));
        EXEC (@command);
        PRINT N'Executed: ' + @command;
    END;

-- Close and deallocate the cursor.
CLOSE partitions;
DEALLOCATE partitions;

-- Drop the temporary table.
DROP TABLE #work_to_do;
GO

Voir aussi

Référence

Fonctions et vues de gestion dynamique
Fonctions et vues de gestion dynamique relatives aux index
sys.dm_db_index_operational_stats
sys.dm_db_index_usage_stats
sys.dm_db_partition_stats
sys.allocation_units (Transact-SQL)
Vues système (Transact-SQL)

Autres ressources

Organisation des tables et des index

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
15 septembre 2007	Contenu modifié : Ajout d'une remarque dans record_count qui explique pourquoi le nombre d'enregistrements retournés peut être différent du nombre de lignes dans un segment. Précisions apportées à la définition de forwarded_record_count.
17 juillet 2006	Nouveau contenu : Ajout d'informations relatives à l'algorithme de calcul de la fragmentation dans la section « Détection de la fragmentation ». Ajout d'une explication à propos du niveau de compatibilité de base de données requis pour utiliser DB_ID() dans le premier paramètre.
14 avril 2006	Contenu modifié : Ajout des valeurs d'entrée 0 et DEFAULT à la syntaxe de database_id, object_id, et partition_number. Ajout des valeurs d'entrée -1 et DEFAULT à la syntaxe de index_id. L'exemple D a été corrigé.
5 décembre 2005	Nouveau contenu : La section « Utilisation de fonctions système pour spécifier des valeurs de paramètres » a été ajoutée. Contenu modifié : La section Autorisations a été modifiée. La description de la fragmentation logique a été corrigée.