DBCC CHECKTABLE (Transact-SQL)

Verifica a integridade de todas as páginas e estruturas que compõem a tabela ou a exibição indexada.

Convenções de sintaxe Transact-SQL

Sintaxe

DBCC CHECKTABLE 
(
        table_name | view_name
    [ , { NOINDEX | index_id }
     |, { REPAIR_ALLOW_DATA_LOSS | REPAIR_FAST | REPAIR_REBUILD } 
    ] 
)
    [ WITH 
        { ALL_ERRORMSGS ]
          [ , EXTENDED_LOGICAL_CHECKS ] 
          [ , NO_INFOMSGS ]
          [ , TABLOCK ] 
          [ , ESTIMATEONLY ] 
          [ , { PHYSICAL_ONLY | DATA_PURITY } ] 
        }
    ]

Argumentos

• table_name | view_name
  É a tabela ou exibição indexada para a qual executar verificações de integridade. Nomes de tabela ou de exibição devem estar de acordo com as regras de identificadores.

• NOINDEX
  Especifica que não devem ser executadas verificações intensas de índices não clusterizados de tabelas de usuário. Isso reduz o tempo de execução geral. NOINDEX não afeta tabelas do sistema porque as verificações de integridade sempre são executadas em todos os índices de tabela do sistema.

• index_id
  É o número da ID (identificação) do índice para o qual executar verificações de integridade. Se a opção index_id estiver especificada, DBCC CHECKTABLE executará verificações de integridade apenas nesse índice, juntamente com o índice heap ou clusterizado.

• REPAIR_ALLOW_DATA_LOSS | REPAIR_FAST | REPAIR_REBUILD
  Especifica que DBCC CHECKTABLE repara os erros encontrados. Para usar uma opção de reparo, o banco de dados deve estar em modo de usuário único.

  • REPAIR_ALLOW_DATA_LOSS
    Tenta reparar todos os erros relatados. Esses reparos podem provocar alguma perda de dados.

  • REPAIR_FAST
    A sintaxe é mantida apenas para compatibilidade com versões anteriores. Nenhuma ação de reparo é executada.

  • REPAIR_REBUILD
    Executa reparos que não têm nenhuma possibilidade de perda de dados. Isso pode incluir reparos rápidos, como reparo de linhas perdidas em índices não clusterizados e reparos mais demorados, como a recriação de um índice.

    REPAIR_REBUILD não repara erros que envolvem dados de FILESTREAM.

  Observação

  Use as opções REPAIR apenas como um último recurso. Para reparar erros, é recomendável restaurar de um backup. As operações de reparo não consideram nenhuma das restrições que podem existir em tabelas ou entre tabelas. Se a tabela especificada estiver envolvida em uma ou mais restrições, é recomendável executar DBCC CHECKCONSTRAINTS após uma operação de reparo. Se for necessário usar REPAIR, execute DBCC CHECKTABLE sem uma opção de reparo para localizar o nível de reparo a ser usado. Se você pretende usar o nível de REPAIR_ALLOW_DATA_LOSS, recomendamos fazer backup do banco de dados antes de executar DBCC CHECKTABLE com essa opção.

• ALL_ERRORMSGS
  Exibe um número ilimitado de erros. No SQL Server 2008 Service Pack 1 (SP1), todas as mensagens de erro são exibidas por padrão. Especificar ou omitir esta opção não tem nenhum efeito. Em versões anteriores do SQL Server (salvo SQL Server 2005 SP3), somente as primeiras 200 mensagens de erro de cada objeto eram exibidas se ALL_ERRORMSGS não fosse especificado.

• EXTENDED_LOGICAL_CHECKS
  Se o nível de compatibilidade for 100 (SQL Server 2008) ou superior, executará verificações de consistência lógica em uma exibição indexada, índices XML e índices espaciais, quando presentes.

  Para obter mais informações, consulte "Executando verificações de consistência lógica em índices" na seção "Comentários" deste tópico.

• NO_INFOMSGS
  Suprime todas as mensagens informativas.

• TABLOCK
  Faz com que DBCC CHECKTABLE obtenha um bloqueio de tabela compartilhada em vez de usar um instantâneo do banco de dados interno. TABLOCK faz com que DBCC CHECKTABLE seja executado com mais rapidez em uma tabela sob carga pesada, mas reduz a simultaneidade disponível na tabela durante a execução de DBCC CHECKTABLE.

• ESTIMATEONLY
  Exibe a quantidade estimada de espaço de tempdb necessária para executar DBCC CHECKTABLE com todas as outras opções especificadas.

• PHYSICAL_ONLY
  Limita a verificação à integridade da estrutura física da página, de cabeçalhos dos registros e da estrutura física de árvores B. Criada para fornecer uma pequena verificação de sobrecarga da consistência física da tabela, essa verificação também pode detectar páginas interrompidas e falhas comuns de hardware que possam comprometer os dados. Uma execução completa de DBCC CHECKTABLE pode demorar muito mais em versões anteriores. Esse comportamento ocorre pelos seguintes motivos:

  • As verificações lógicas são mais abrangentes.

  • Algumas das estruturas subjacentes a serem verificadas são mais complexas.

  • Foram introduzidas muitas verificações novas para incluir os novos recursos.

  O uso da opção PHYSICAL_ONLY pode provocar um tempo de execução muito mais curto para DBCC CHECKTABLE em tabelas grandes. Portanto é recomendado para uso freqüente em sistemas de produção. Ainda é recomendável executar um DBCC CHECKTABLE completo periodicamente. A freqüência dessas execuções depende de fatores específicos aos negócios e ambientes de produção individuais. PHYSICAL_ONLY sempre implica NO_INFOMSGS e não é permitido com nenhuma das opções de reparo.

  Observação
  A especificação de PHYSICAL_ONLY faz com que DBCC CHECKTABLE ignore todas as verificações de dados FILESTREAM.

• DATA_PURITY
  Faz com que o DBCC CHECKTABLE verifique valores de colunas na tabela que não são válidos ou estão fora do intervalo. Por exemplo, o DBCC CHECKTABLE detecta colunas com valores de data e hora que são maiores ou menores do que o intervalo aceitável para o tipo de dados datetime; ou colunas de tipo de dados decimal ou numérico aproximado com valores de escala ou precisão que não são válidos.

  Para bancos de dados criados no SQL Server 2005 e versões posteriores, verificações de integridade de valor de coluna são habilitadas por padrão e não requerem a opção DATA_PURITY. Para bancos de dados atualizados de versões anteriores do SQL Server, é possível usar DBCC CHECKTABLE WITH DATA_PURITY para localizar e corrigir erros em uma tabela específica. No entanto verificações de valores de colunas na tabela não são habilitadas por padrão até que o DBCC CHECKDB WITH DATA_PURITY tenha sido executado sem erros no banco de dados. Depois disso, por padrão, DBCC CHECKDB e DBCC CHECKTABLE verificam a integridade de valores de colunas.

  Os erros de validação relatados por essa opção não podem ser corrigidos com opções de reparo de DBCC. Para obter informações sobre como corrigir esses erros manualmente, consulte o artigo 923247 da Base de Dados de Conhecimento: Solucionando problemas de erro DBCC 2570 no SQL Server 2005.

  Se PHYSICAL_ONLY estiver especificado, não serão executadas verificações de integridade de colunas.

Comentários

Observação
Para executar DBCC CHECKTABLE em cada tabela do banco de dados, use DBCC CHECKDB.

Para a tabela especificada, DBCC CHECKTABLE verifica o seguinte:

• Páginas de índice, em linha, LOB e de estouro de linha estão vinculadas corretamente.

• Os índices estão na ordem de classificação correta.

• Os ponteiros são consistentes.

• Os dados em cada página são razoáveis, inclusive colunas computadas.

• Os deslocamentos de página são razoáveis.

• Cada linha da tabela base tem uma linha correspondente em cada índice não clusterizado e vice-versa.

• Cada linha de uma tabela ou índice particionado está na partição correta.

• Consistência do nível de vínculo entre o sistema de arquivos e a tabela ao armazenar dados varbinary(max) no sistema de arquivos usando FILESTREAM.

Executando verificações de consistência lógica em índices

A verificação de consistência lógica em índices varia de acordo com o nível de compatibilidade do banco de dados, da seguinte maneira:

• Se o nível de compatibilidade for 100 (SQL Server 2008) ou superior:

  • A menos que NOINDEX esteja especificado, DBCC CHECKTABLE executará verificações de consistência física e lógica em uma única tabela e em todos os índices não clusterizados. Entretanto, em índices XML, índices espaciais e exibições indexadas, por padrão são executadas somente as verificações de consistência física.

  • Se WITH EXTENDED_LOGICAL_CHECKS estiver especificado, as verificações lógicas serão executadas em uma exibição indexada, em índices XML e em índices espaciais, quando presentes. Por padrão, as verificações de consistência física são executadas antes das verificações de consistência lógica. Se NOINDEX também estiver especificado, apenas as verificações lógicas serão executadas.

    Essas verificações de consistência lógica comparam a tabela de índice interna do objeto de índice com a tabela do usuário à qual se está fazendo referência. Para localizar linhas externas, uma consulta interna é construída para executar uma interseção completa das tabelas internas e do usuário. A execução dessa consulta pode afetar bastante o desempenho e não é possível controlar seu andamento. Portanto, é recomendável especificar WITH EXTENDED_LOGICAL_CHECKS apenas se você suspeitar de problemas de índice que não estão relacionados a dano físico ou se as somas de verificação em nível de página tiverem sido desativadas e você suspeitar de dano de hardware em nível de coluna.

  • Se o índice for filtrado, DBCC CHECKDB executará verificações de consistência para verificar se as entradas do índice atendem ao predicado do filtro.

• Se o nível de compatibilidade for 90 ou inferior, a menos que NOINDEX esteja especificado, DBCC CHECKTABLE executará verificações de consistência física e lógica em uma única tabela ou exibição indexada e em todos os índices XML e não clusterizados. Não há suporte para índices espaciais.

Para obter informações sobre o nível de compatibilidade de um banco de dados

• Como exibir ou alterar o nível de compatibilidade de um banco de dados (SQL Server Management Studio)

Instantâneo do banco de dados interno

DBCC CHECKTABLE usa um instantâneo do banco de dados interno para fornecer a consistência transacional necessária ao executar essas verificações. Para obter mais informações, consulte Compreendendo tamanhos de arquivo esparso em instantâneos do banco de dados e a seção "Uso de instantâneo do banco de dados interno DBCC" em DBCC (Transact-SQL).

Se um instantâneo não puder ser criado, ou se a opção TABLOCK estiver especificada, DBCC CHECKTABLE irá adquirir um bloqueio de tabela compartilhada para obter a consistência necessária.

Observação
Se DBCC CHECKTABLE for executado em relação a tempdb, ele deverá adquirir um bloqueio de tabela compartilhada. Isso porque, por razões de desempenho, instantâneos de banco de dados não estão disponíveis no tempdb. Isso significa que a consistência transacional exigida não pode ser obtida.

Verificando e reparando dados FILESTREAM

Quando FILESTREAM está habilitado para um banco de dados e tabela, é possível armazenar opcionalmente BLOBs (objetos binários grandes) varbinary(max) no sistema de arquivos. Ao usar DBCC CHECKTABLE em uma tabela que armazena BLOBs no sistema de arquivos, DBCC verifica a consistência em nível de vinculação entre o sistema de arquivos e o banco de dados.

Por exemplo, se uma tabela contiver uma coluna varbinary(max) que usa o atributo FILESTREAM, DBCC CHECKTABLE verificará se existe um mapeamento de um para um entre os diretórios do sistema de arquivos e os arquivos e as linhas da tabela, as colunas e os valores da coluna. DBCC CHECKTABLE poderá reparar dano se você especificar a opção REPAIR_ALLOW_DATA_LOSS. Para reparar dano de FILESTREAM, DBCC excluirá todas as linhas da tabela que não têm dados do sistema de arquivos e excluirá todos os diretórios e arquivos que não mapeiam para uma linha, coluna ou valor de coluna da tabela.

Verificando objetos em paralelo

Por padrão, DBCC CHECKTABLE executa a verificação paralela de objetos. O grau de paralelismo é automaticamente determinado pelo processador de consulta. O grau máximo de paralelismo é configurado da mesma maneira como o de consultas paralelas. Para restringir o número de máximo de processadores disponíveis para a verificação DBCC, use sp_configure. Para obter mais informações, consulte Opção max degree of parallelism.

A verificação paralela pode ser desabilitada usando o sinalizador de rastreamento 2528. Para obter mais informações, consulte Sinalizadores de rastreamento (Transact-SQL).

Observação
Durante uma operação de DBCC CHECKTABLE, os bytes armazenados em uma coluna de tipo definido pelo usuário, ordenada por byte, devem ser iguais aos da serialização computada do valor do tipo definido pelo usuário. Se isto não for verdadeiro, a rotina de DBCC CHECKTABLE relatará um erro de consistência.

Compreendendo mensagens de erro DBCC

Depois que o comando DBCC CHECKTABLE é concluído, uma mensagem é gravada no log de erros do SQL Server. Se o comando DBCC for executado com êxito, a mensagem indicará uma conclusão bem-sucedida e o tempo de execução do comando. Se o comando DBCC parar antes de concluir a verificação por causa de um erro, a mensagem indicará que o comando foi finalizado, um valor de estado e o tempo de execução do comando. A tabela a seguir lista e descreve os valores de estado que podem ser incluídos na mensagem.

Estado	Descrição
0	O erro número 8930 foi gerado. Isso indica um dano de metadados que provocou a finalização do comando DBCC.
1	Erro número 8967 foi gerado. Ocorreu um erro do DBCC interno.
2	Ocorreu uma falha durante o reparo do banco de dados em modo de emergência.
3	Isso indica um dano de metadados que provocou a finalização do comando DBCC.
4	Uma declaração ou violação de acesso foi detectada.
5	Ocorreu um erro desconhecido que finalizou o comando DBCC.

Relatório de erros

Um mini-arquivo de despejo (SQLDUMPnnnn.txt) é criado no diretório LOG do SQL Server sempre que DBCC CHECKTABLE detecta um erro de dano. Quando os recursos de coleta de dados Uso de Recursos e Relatório de Erros são habilitados para a instância do SQL Server, o arquivo é automaticamente encaminhado à Microsoft. Os dados coletados são usados para aprimorar a funcionalidade do SQL Server.

O arquivo de despejo contém os resultados do comando DBCC CHECKTABLE e saídas de diagnóstico adicionais. O arquivo tem DACLs (listas de controle de acesso discricionário) restritas. O acesso é limitado à conta de serviço do SQL Server e aos membros da função sysadmin. Por padrão, a função sysadmin contém todos os membros do grupo BUILTIN\Administradores do Windows e do grupo de administradores locais. O comando DBCC não falhará se o processo de coleta de dados falhar.

Resolvendo erros

Se qualquer erro for relatado pelo DBCC CHECKTABLE, recomendamos a restauração do banco de dados do backup em vez da execução de REPAIR com uma das opções REPAIR. Se não existir nenhum backup, a execução de REPARAR poderá corrigir os erros relatados. A opção REPAIR a ser usada é especificada no fim da lista de erros relatados. No entanto, a correção dos erros usando a opção REPAIR_ALLOW_DATA_LOSS pode exigir que algumas páginas e, portanto, dados, sejam excluídos.

O reparo pode ser executado sob uma transação do usuário para permitir que o usuário reverta as alterações feitas. Se reparos forem revertidos, o banco de dados ainda conterá erros e deverá ser restaurado de um backup. Depois de concluir todos os reparos, faça backup do banco de dados.

Conjuntos de resultados

O DBCC CHECKTABLE retorna o seguinte conjunto de resultados. O mesmo conjunto de resultados será retornado se você especificar apenas o nome da tabela ou qualquer uma das opções.

DBCC results for 'HumanResources.Employee'.
There are 288 rows in 13 pages for object 'Employee'.
DBCC execution completed. If DBCC printed error messages, contact your system administrator.

O DBCC CHECKTABLE retornará o conjunto de resultados a seguir se a opção de ESTIMATEONLY estiver especificada:

Estimated TEMPDB space needed for CHECKTABLES (KB) 
-------------------------------------------------- 
21
(1 row(s) affected)
DBCC execution completed. If DBCC printed error messages, contact your system administrator.

Permissões

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

Exemplos

A. Verificando uma tabela específica

O exemplo a seguir verifica a integridade da página de dados da tabela HumanResources.Employee no banco de dados AdventureWorks .

USE AdventureWorks;
GO
DBCC CHECKTABLE ("HumanResources.Employee");
GO

B. Executando uma verificação de sobrecarga baixa da tabela

O exemplo a seguir executa uma verificação de sobrecarga baixa da tabela Employee no banco de dados AdventureWorks.

USE AdventureWorks;
GO
DBCC CHECKTABLE ("HumanResources.Employee") WITH PHYSICAL_ONLY;
GO

C. Verificando um índice específico

O exemplo a seguir verifica um índice específico obtido por meio de acesso a sys.indexes.

USE AdventureWorks;
GO
DECLARE @indid int;
SET @indid = (SELECT index_id 
              FROM sys.indexes
              WHERE object_id = OBJECT_ID('Production.Product')
                    AND name = 'AK_Product_Name');
DBCC CHECKTABLE ("Production.Product", @indid);

Histórico de alterações

Conteúdo atualizado
Na definição de ALL_ERRORMSGS, uma nova funcionalidade é descrita no SQL Server 2008 SP1.

Consulte também

Referência

DBCC (Transact-SQL)

DBCC CHECKDB (Transact-SQL)

Conceitos

Solucionando problemas de erros de DBCC em exibições indexadas

Outros recursos

Arquitetura de estruturas de dados de índice e tabela