DBCC CHECKTABLE (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 intensivas 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 index_id estiver especificada, DBCC CHECKTABLE executará verificações de integridade naquele í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 usuário de ú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, recomendamos restaurar de um backup. 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, recomendamos 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. Todas as mensagens de erro são exibidas por padrão. Especificar ou omitir esta opção não têm nenhum efeito.

• 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, registra cabeçalhos dos registros e a 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 podem comprometer os dados. Uma execução completa de DBCC CHECKTABLE pode demorar muito mais em versões anteriores. Esse comportamento ocorre devido às seguintes razões:

  • 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 frequente em sistemas de produção. Ainda é recomendável executar um DBCC CHECKTABLE completo periodicamente. A frequência dessas execuções depende de fatores específicos para 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 disto, por padrão, DBCC CHECKDB e DBCC CHECKTABLE verificam a integridade de valores de colunas.

  Erros de validação relatados por essa opção não podem ser corrigidos usando 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: Troubleshooting DBCC error 2570 in 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 dados de estouro de linha, índice, em linha e LOB 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.

• 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 um índice ou tabela particionada 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

Instantâneo do banco do 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

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

Relatório de erros

Resolvendo erros

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

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

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

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

C. Verificando um índice específico

USE AdventureWorks2008R2;
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);

Consulte também

Referência

Conceitos

Outros recursos