DBCC INDEXDEFRAG (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

Desfragmenta los índices de la tabla o la vista especificada.

Se aplica a: SQL Server 2008 (10.0.x) y versiones posteriores

Convenciones de sintaxis de Transact-SQL

Sintaxis

DBCC INDEXDEFRAG
(
    { database_name | database_id | 0 }
    , { table_name | table_id | view_name | view_id }
    [ , { index_name | index_id } [ , { partition_number | 0 } ] ]
)
    [ WITH NO_INFOMSGS ]

Argumentos

database_name | database_id | 0

La base de datos que contiene el índice que se va a desfragmentar. Si se especifica 0, se utiliza la base de datos actual. Los nombres de las bases de datos deben cumplir las reglas de los identificadores.

table_name | table_id | view_name | view_id

La tabla o la vista que contiene el índice que se va a desfragmentar. Los nombres de las tablas y las vistas deben ajustarse a las reglas de los identificadores.

index_name | index_id

El nombre o id. del índice que se va a desfragmentar. Si no se especifica, la instrucción desfragmenta todos los índices de la tabla o la vista especificada. Los nombres de los índices deben ajustarse a las reglas de los identificadores.

número_de_partición | 0

El número de partición del índice que se va a desfragmentar. Si no se especifica o se especifica 0, la instrucción desfragmenta todas las particiones del índice especificado.

WITH NO_INFOMSGS

Suprime todos los mensajes informativos con niveles de gravedad entre 0 y 10.

Observaciones

DBCC INDEXDEFRAG desfragmenta el nivel hoja de un índice para que el orden físico de las páginas coincida con el orden lógico de izquierda a derecha de los nodos hoja, lo que mejora el rendimiento de recorrido del índice.

DBCC INDEXDEFRAG también compacta las páginas de un índice, teniendo en cuenta el factor de relleno especificado cuando se creó el índice. Las páginas vacías creadas como consecuencia de esta compactación se quitan. Para obtener más información, vea Especificar el factor de relleno para un índice.

Si un índice abarca más de un archivo, DBCC INDEXDEFRAG desfragmenta los archivos de uno en uno. Las páginas no se migran entre archivos.

DBCC INDEXDEFRAG especifica el porcentaje completado estimado cada cinco minutos. DBCC INDEXDEFRAG puede terminarse en cualquier momento del proceso y se mantiene el trabajo finalizado.

A diferencia de DBCC DBREINDEX, o la operación de generación del índice en general, DBCC INDEXDEFRAG es una operación en línea. No mantiene bloqueos a largo plazo. Por tanto, DBCC INDEXDEFRAG no bloquea consultas o actualizaciones en ejecución. Se puede tardar menos en desfragmentar un índice relativamente poco fragmentado que en generar un índice nuevo porque el tiempo de desfragmentación está relacionado con el volumen de la fragmentación. Un índice muy fragmentado puede tardar mucho más en desfragmentarse que en volver a generarse.

La desfragmentación siempre se registra por completo con independencia de la configuración del modelo de recuperación. Para obtener más información, consulte ALTER DATABASE (Transact-SQL). La desfragmentación de un índice muy fragmentado puede generar más información en el registro que la creación de un índice de registro completo. No obstante, la desfragmentación se realiza como una serie de transacciones cortas y, por tanto, no es necesario un registro grande si se realizan con frecuencia copias de seguridad de registros o si la configuración del modelo de recuperación es SIMPLE.

Restricciones

DBCC INDEXDEFRAG coloca las páginas hoja del índice en su lugar. Por lo tanto, si un índice se intercala con otros índices en el disco, la ejecución de DBCC INDEXDEFRAG en dicho índice no ordena las páginas hoja del índice de forma contigua. Para mejorar la agrupación en clústeres de páginas, vuelva a generar el índice.

No se puede usar DBCC INDEXDEFRAG para desfragmentar los índices siguientes:

• Un índice deshabilitado.
• Un índice con bloqueo de página establecido en OFF.
• Un índice espacial.

DBCC INDEXDEFRAG no se admite para su uso en tablas del sistema.

Conjuntos de resultados

DBCC INDEXDEFRAG devuelve el siguiente conjunto de resultados (los valores pueden variar) si se especifica un índice en la instrucción (a menos que se especifique WITH NO_INFOMSGS):

Pages Scanned Pages Moved Pages Removed
------------- ----------- -------------
359           346         8
  
(1 row(s) affected)
  
DBCC execution completed. If DBCC printed error messages, contact your system administrator.

Permisos

El autor de la llamada debe ser el propietario de la tabla, o bien un miembro del rol fijo de servidor sysadmin o de los roles fijos de base de datos db_owner o db_ddladmin.

Ejemplos

A. Uso de DBCC INDEXDEFRAG para desfragmentar un índice

En el siguiente ejemplo se desfragmentan todas las particiones del índice PK_Product_ProductID de la tabla Production.Product de la base de datos AdventureWorks2022.

DBCC INDEXDEFRAG (AdventureWorks2022, 'Production.Product', PK_Product_ProductID);
GO

B. Uso de DBCC SHOWCONTIG y DBCC INDEXDEFRAG para desfragmentar los índices de una base de datos

En el siguiente ejemplo se muestra una forma sencilla de desfragmentar todos los índices de una base de datos que están fragmentados por encima de un umbral declarado.

/*Perform a 'USE <database name>' to select the database in which to run the script.*/
-- Declare variables
SET NOCOUNT ON;
DECLARE @tablename VARCHAR(255);
DECLARE @execstr   VARCHAR(400);
DECLARE @objectid  INT;
DECLARE @indexid   INT;
DECLARE @frag      DECIMAL;
DECLARE @maxfrag   DECIMAL;
  
-- Decide on the maximum fragmentation to allow for.
SELECT @maxfrag = 30.0;
  
-- Declare a cursor.
DECLARE tables CURSOR FOR
   SELECT TABLE_SCHEMA + '.' + TABLE_NAME
   FROM INFORMATION_SCHEMA.TABLES
   WHERE TABLE_TYPE = 'BASE TABLE';
  
-- Create the table.
CREATE TABLE #fraglist (
   ObjectName CHAR(255),
   ObjectId INT,
   IndexName CHAR(255),
   IndexId INT,
   Lvl INT,
   CountPages INT,
   CountRows INT,
   MinRecSize INT,
   MaxRecSize INT,
   AvgRecSize INT,
   ForRecCount INT,
   Extents INT,
   ExtentSwitches INT,
   AvgFreeBytes INT,
   AvgPageDensity INT,
   ScanDensity DECIMAL,
   BestCount INT,
   ActualCount INT,
   LogicalFrag DECIMAL,
   ExtentFrag DECIMAL);
  
-- Open the cursor.
OPEN tables;
  
-- Loop through all the tables in the database.
FETCH NEXT
   FROM tables
   INTO @tablename;
  
WHILE @@FETCH_STATUS = 0
BEGIN
-- Do the showcontig of all indexes of the table
   INSERT INTO #fraglist
   EXEC ('DBCC SHOWCONTIG (''' + @tablename + ''')
      WITH FAST, TABLERESULTS, ALL_INDEXES, NO_INFOMSGS');
   FETCH NEXT
      FROM tables
      INTO @tablename;
END;
  
-- Close and deallocate the cursor.
CLOSE tables;
DEALLOCATE tables;
  
-- Declare the cursor for the list of indexes to be defragged.
DECLARE indexes CURSOR FOR
   SELECT ObjectName, ObjectId, IndexId, LogicalFrag
   FROM #fraglist
   WHERE LogicalFrag >= @maxfrag
      AND INDEXPROPERTY (ObjectId, IndexName, 'IndexDepth') > 0;
  
-- Open the cursor.
OPEN indexes;
  
-- Loop through the indexes.
FETCH NEXT
   FROM indexes
   INTO @tablename, @objectid, @indexid, @frag;
  
WHILE @@FETCH_STATUS = 0
BEGIN
   PRINT 'Executing DBCC INDEXDEFRAG (0, ' + RTRIM(@tablename) + ',
      ' + RTRIM(@indexid) + ') - fragmentation currently '
       + RTRIM(CONVERT(varchar(15),@frag)) + '%';
   SELECT @execstr = 'DBCC INDEXDEFRAG (0, ' + RTRIM(@objectid) + ',
       ' + RTRIM(@indexid) + ')';
   EXEC (@execstr);
  
   FETCH NEXT
      FROM indexes
      INTO @tablename, @objectid, @indexid, @frag;
END;
  
-- Close and deallocate the cursor.
CLOSE indexes;
DEALLOCATE indexes;
  
-- Delete the temporary table.
DROP TABLE #fraglist;
GO

Consulte también

• DBCC (Transact-SQL)
• sys.dm_db_index_physical_stats (Transact-SQL)
• CREATE TABLE (Transact-SQL)
• ALTER TABLE (Transact-SQL)
• ALTER INDEX (Transact-SQL)