DBCC INDEXDEFRAG (Transact-SQL)

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

Desfragmenta índices da tabela ou exibição especificada.

Importante

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use ALTER INDEX nesse caso.

Aplica-se a: SQL Server 2008 (10.0.x) e versões posteriores

Convenções de sintaxe de Transact-SQL

Syntax

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 ]

Observação

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

database_name | database_id | 0

O banco de dados que contém o índice a ser desfragmentado. Se 0 for especificado, será usado o banco de dados atual. Os nomes de banco de dados precisam estar em conformidade com as regras de identificadores.

table_name | table_id | view_name | view_id

A tabela ou exibição que contém o índice a ser desfragmentado. Os nomes de tabelas e exibições devem obedecer às regras de identificadores.

index_name | index_id

A ID ou o nome do índice a ser desfragmentado. Se não for especificado, a instrução desfragmentará todos os índices da tabela ou exibição especificada. Os nomes de índice devem obedecer às regras para identificadores.

partition_number | 0

O número de partição do índice a ser desfragmentado. Se não for especificado ou se for especificado 0, a instrução desfragmentará todas as partições no índice especificado.

WITH NO_INFOMSGS

Suprime todas as mensagens informativas com níveis de severidade de 0 a 10.

Comentários

DBCC INDEXDEFRAG desfragmenta o nível folha de um índice a fim de que a ordem física das páginas corresponda à ordem lógica da esquerda para a direita dos nós folha, o que melhora o desempenho do exame de índice.

Observação

Quando DBCC INDEXDEFRAG é executado, a desfragmentação de índice ocorre em série. Isso significa que a operação em um único índice que usa um único thread é executada. Nenhum paralelismo ocorre. Além disso, operações em vários índices da mesma instrução DBCC INDEXDEFRAG são executadas em um índice por vez.

DBCC INDEXDEFRAG também compacta as páginas de um índice, levando em consideração o fator de preenchimento especificado quando ele foi criado. Qualquer página vazia criada por causa desta compactação é removida. Para obter mais informações, veja Especificar fator de preenchimento para um índice.

Se um índice abranger mais de um arquivo, DBCC INDEXDEFRAG desfragmentará um arquivo por vez. As páginas não podem ser migradas entre arquivos.

DBCC INDEXDEFRAG informa a estimativa de porcentagem concluída a cada cinco minutos. DBCC INDEXDEFRAG pode ser interrompido a qualquer momento do processo e qualquer trabalho concluído é retido.

Ao contrário de DBCC DBREINDEX ou da operação de criação de índice em geral, DBCC INDEXDEFRAG é uma operação online. Ela não mantém bloqueios por longos períodos. Assim sendo, DBCC INDEXDEFRAG não bloqueia as atualizações ou consultas em execução. Como o tempo de desfragmentação está relacionado ao nível de fragmentação, um índice relativamente não fragmentado pode ser desfragmentado mais rápido do que a criação de um novo índice. Um índice muito fragmentado pode levar muito mais tempo para ser desfragmentado do que para ser recompilado.

A desfragmentação é sempre totalmente armazenada em log, independentemente da configuração do modelo de recuperação do banco de dados. Para obter mais informações, veja ALTER DATABASE (Transact-SQL). A desfragmentação de um índice muito fragmentado pode gerar mais logs do que uma criação de índice totalmente registrada em log. Entretanto, a desfragmentação é executada como uma série de transações curtas; dessa forma, um log maior será desnecessário se os backups de log forem feitos com frequência ou se a configuração do modelo de recuperação for SIMPLE.

Restrições

DBCC INDEXDEFRAG mistura as páginas folha do índice no próprio lugar. Por isso, se um índice for intercalado com outros no disco, a execução de DBCC INDEXDEFRAG para ele não deixará todas as páginas folha relacionadas contíguas. Para melhorar a clusterização de páginas, recrie o índice.

DBCC INDEXDEFRAG não pode ser usado para desfragmentar os seguintes índices:

  • Um índice desabilitado.
  • Um índice com bloqueio de página definido como OFF.
  • Um índice espacial.

DBCC INDEXDEFRAG não há suporte para uso em tabelas do sistema.

Conjuntos de resultados

DBCC INDEXDEFRAG retornará o seguinte conjunto de resultados (os valores podem variar) se um índice for especificado na instrução (a menos que WITH NO_INFOMSGS seja especificado):

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.

Permissões

O chamador precisa ser o proprietário da tabela ou ser membro da função de servidor fixa sysadmin, da função de banco de dados fixa db_owner ou da função de banco de dados fixa db_ddladmin.

Exemplos

a. Usar DBCC INDEXDEFRAG para desfragmentar um índice

O exemplo a seguir desfragmenta todas as partições do índice PK_Product_ProductID na tabela Production.Product no banco de dados AdventureWorks2022.

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

B. Usar DBCC SHOWCONTIG e DBCC INDEXDEFRAG para desfragmentar os índices em um banco de dados

O exemplo a seguir mostra uma forma simples de desfragmentar todos os índices de um banco de dados que estão fragmentados acima de um limite 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

Confira também