sys.dm_db_index_operational_stats (Transact-SQL)

Sintaxe

sys.dm_db_index_operational_stats (
    { database_id | NULL | 0 | DEFAULT }
    , { object_id | NULL | 0 | DEFAULT }
    , { index_id | 0 | NULL | -1 | DEFAULT }
    , { partition_number | NULL | 0 | DEFAULT }
)

Argumentos

• database_id | NULL | 0 | DEFAULT
  A ID do banco de dados. database_id é smallint. As entradas válidas são o número da ID de um banco de dados, NULL, 0 ou DEFAULT. O padrão é 0. NULL, 0 e DEFAULT são valores equivalentes neste contexto.

  Especifique NULL para retornar informações de todos os bancos de dados na instância do SQL Server. Se você especificar NULL para database_id, especifique também NULL para object_id, index_id e partition_number.

  A função interna DB_ID pode ser especificada. Ao usar DB_ID sem especificar um nome de banco de dados, o nível de compatibilidade do banco de dados atual deve ser 90.

• object_id | NULL | 0 | DEFAULT
  A ID de objeto da tabela ou a exibição do índice está ativada. object_id é int.

  As entradas válidas são o número da ID de uma tabela e de uma exibição, NULL, 0 ou DEFAULT. O padrão é 0. NULL, 0 e DEFAULT são valores equivalentes neste contexto.

  Especifique NULL para retornar informações em cache de todas as tabelas e exibições no banco de dados especificado. Se você especificar NULL para object_id, também deverá especificar NULL para index_id e partition_number.

• index_id | 0 | NULL | -1 | DEFAULT
  A ID do índice. index_id é int. As entradas válidas são o número de identificação de um índice, 0 se object_id for um heap, NULL, -1 ou DEFAULT. O padrão é -1; NULL, -1 e DEFAULT são valores equivalentes neste contexto.

  Especifique NULL para retornar informações em cache de todos os índices de uma tabela base ou exibição. Se você especificar NULL para index_id, também deverá especificar NULL para partition_number.

• partition_number | NULL | 0 | DEFAULT
  O número da partição no objeto. partition_number é int. As entradas válidas são o partion_number de um índice ou heap, NULL, 0 ou DEFAULT. O padrão é 0. NULL, 0 e DEFAULT são valores equivalentes neste contexto.

  Especifique NULL para retornar informações em cache de todas as partições do índice ou heap.

  partition_number é de base 1. Um índice ou heap não particionado tem partition_number definido como 1.

Tabela retornada

Comentários

Esse objeto de gerenciamento dinâmico não aceita parâmetros correlatos de CROSS APPLY e OUTER APPLY.

Você pode usar sys.dm_db_index_operational_stats para rastrear o período de tempo que os usuários devem aguardar para ler ou gravar em uma tabela, índice ou partição e identificar as tabelas ou índices que estão encontrando atividade de E/S significativa ou pontos de acesso.

Use as seguintes colunas para identificar áreas de contenção.

Para analisar um padrão de acesso comum à tabela ou partição de índice, use estas colunas:

• leaf_insert_count

• leaf_delete_count

• leaf_update_count

• leaf_ghost_count

• range_scan_count

• singleton_lookup_count

Para identificar a contenção de bloqueio e trava, use estas colunas:

• page_latch_wait_count e page_latch_wait_in_ms

  Essas colunas indicam se há uma contenção de trava no índice ou heap e a importância da contenção.

• row_lock_count e page_lock_count

  Essas colunas indicam quantas vezes o Mecanismo de Banco de Dados tentou adquirir bloqueios de linha e página.

• row_lock_wait_in_ms e page_lock_wait_in_ms

  Estas colunas indicam se há uma contenção de bloqueio no índice ou heap e a importância da contenção.

Para analisar estatísticas de E/S física em uma partição de índice ou de heap

• page_io_latch_wait_count e page_io_latch_wait_in_ms

  Essas colunas indicam se foram emitidas E/S físicas para trazer as páginas de índice ou heap para a memória e quantas E/S foram emitidas.

Comentários sobre colunas

Como os contadores são redefinidos no cache de metadados

Usando funções de sistema para especificar valores de parâmetro

Permissões

Requer as seguintes permissões:

• Permissão CONTROL para o objeto especificado dentro do banco de dados

• A permissão VIEW DATABASE STATE para retornar informações sobre todos os objetos dentro do banco de dados especificado, usando o curinga de objeto @object\_id = NULL

• A permissão VIEW SERVER STATE para retornar informações sobre todos os banco de dados usando o curinga de banco de dados @database\_id = NULL

Conceder VIEW DATABASE STATE permite que todos os objetos no banco de dados sejam retornados, independentemente de qualquer permissão CONTROL negada a objetos específicos.

Negar VIEW DATABASE STATE impede que todos os objetos do banco de dados sejam retornados, independentemente de qualquer permissão CONTROL concedida a objetos específicos. Além disso, quando o curinga do banco de dados @database\_id= NULL é especificado, o banco de dados é omitido.

Para obter mais informações, consulte Exibições e funções de gerenciamento dinâmico (Transact-SQL).

Exemplos

A. Retornando informações de uma tabela especificada

O exemplo a seguir retorna informações de todos os índices e partições da tabela Person.Address no banco de dados AdventureWorks. A execução dessa consulta requer, no mínimo, a permissão CONTROL para a tabela Person.Address.

Importante

Ao usar as funções Transact-SQL DB_ID e OBJECT_ID para retornar um valor de parâmetro, sempre verifique se uma ID válida é retornada. Se o banco de dados ou o nome do objeto não puder ser encontrado, por não existir ou por estar escrito incorretamente, ambas as funções retornarão NULL. A função sys.dm_db_index_operational_stats interpreta NULL como um valor curinga que especifica todos os bancos de dados ou todos os objetos. Como essa pode ser uma operação não intencional, os exemplos desta seção demonstram a maneira segura de determinar as IDs do banco de dados e do objeto.

DECLARE @db_id int;
DECLARE @object_id int;
SET @db_id = DB_ID(N'AdventureWorks');
SET @object_id = OBJECT_ID(N'AdventureWorks.Person.Address');
IF @db_id IS NULL 
  BEGIN;
    PRINT N'Invalid database';
  END;
ELSE IF @object_id IS NULL
  BEGIN;
    PRINT N'Invalid object';
  END;
ELSE
  BEGIN;
    SELECT * FROM sys.dm_db_index_operational_stats(@db_id, @object_id, NULL, NULL);
  END;
GO

B. Retornando informações para todas as tabelas e índices

SELECT * FROM sys.dm_db_index_operational_stats(NULL, NULL, NULL, NULL);
GO 

Consulte também

Referência

Outros recursos