DBCC INDEXDEFRAG (Transact-SQL)
Se aplica a:
SQL ServerAzure SQL Managed Instance
Desfragmenta los índices de la tabla o la vista especificada.
Importante
Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Use ALTER INDEX en su lugar.
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 ]
Nota:
Para ver la sintaxis de Transact-SQL para SQL Server 2014 y versiones anteriores, consulte Versiones anteriores de la documentación.
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.
Nota
Si se ejecuta DBCC INDEXDEFRAG, la desfragmentación del índice se realiza en serie. Esto significa que la operación en un índice único se realiza con un solo subproceso. No se produce ningún paralelismo. Además, las operaciones en varios índices desde la misma instrucción DBCC INDEXDEFRAG se realizan en los índices de uno en uno.
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