Partilhar via


sys.dm_db_index_operational_stats (Transact-SQL)

Retorna a atividade atual de E/S de baixo nível, de bloqueio, de trava e de método de acesso de cada partição de uma tabela ou índice no banco de dados.

Ícone de vínculo de tópicoConvenções de sintaxe 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 da ID 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

Nome da coluna

Tipo de dados

Descrição

database_id

smallint

ID do banco de dados.

object_id

int

ID da tabela ou exibição.

index_id

int

ID do índice ou heap.

0 = Heap

partition_number

int

Número de partição com base 1 no índice ou heap.

leaf_insert_count

bigint

Contagem cumulativa de inserções de nível folha.

leaf_delete_count

bigint

Contagem cumulativa de exclusões de nível folha.

leaf_update_count

bigint

Contagem cumulativa de atualizações de nível folha.

leaf_ghost_count

bigint

Contagem cumulativa de linhas de nível folha marcadas como excluídas, mas não removidas ainda. Essas filas são removidas por um thread de limpeza em intervalos definidos. Esse valor não inclui linhas retidas que foram retidas, devido a uma transação de isolamento de instantâneo pendente. Para obter mais informações sobre as transações de isolamento de instantâneo, consulte Níveis de isolamento com base no controle de versão de linha no Mecanismo de Banco de Dados.

nonleaf_insert_count

bigint

Contagem cumulativa de inserções acima do nível folha.

0 = Heap

nonleaf_delete_count

bigint

Contagem cumulativa de exclusões acima do nível folha.

0 = Heap

nonleaf_update_count

bigint

Contagem cumulativa de atualizações acima do nível folha.

0 = Heap

leaf_allocation_count

bigint

Contagem cumulativa de alocações de página de nível folha no índice ou heap.

Para um índice, uma alocação de página corresponde a uma página dividida.

nonleaf_allocation_count

bigint

Contagem cumulativa de alocações de página provocadas por divisões de página acima do nível folha.

0 = Heap

leaf_page_merge_count

bigint

Contagem cumulativa de mesclagens de página no nível folha.

nonleaf_page_merge_count

bigint

Contagem cumulativa de mesclagens de página acima do nível folha.

0 = Heap

range_scan_count

bigint

Contagem cumulativa de exames de intervalo e tabela iniciados no índice ou heap.

singleton_lookup_count

bigint

Contagem cumulativa de recuperações de linha única do índice ou heap.

forwarded_fetch_count

bigint

Contagem de linhas buscadas por meio de um registro de encaminhamento.

0 = Índices

lob_fetch_in_pages

bigint

Contagem cumulativa de páginas de LOB (objeto grande) recuperadas da unidade de alocação LOB_DATA. Essas páginas contêm dados armazenados em colunas do tipo text, ntext, image, varchar(max), nvarchar(max), varbinary(max) e xml. Para obter mais informações, consulte Tipos de dados (Transact-SQL). Para obter mais informações sobre unidades de alocação, consulte Organização de tabela e índice.

lob_fetch_in_bytes

bigint

Contagem cumulativa de bytes de dados LOB recuperados.

lob_orphan_create_count

bigint

Contagem cumulativa de valores LOB órfãos criados para operações em massa.

0 = Índice não clusterizado

lob_orphan_insert_count

bigint

Contagem cumulativa de valores LOB órfãos inseridos durante operações em massa.

0 = Índice não clusterizado

row_overflow_fetch_in_pages

bigint

Contagem cumulativa de páginas de dados de estouro de linha recuperada da unidade de alocação ROW_OVERFLOW_DATA.

Essas páginas contém dados armazenados em colunas do tipo varchar(n), nvarchar(n), varbinary(n) e sql_variant que foram empurrados para fora da linha. Para obter mais informações, consulte Dados de estouro de linha excedendo 8 KB. Para obter mais informações sobre unidades de alocação, consulte Organização de tabela e índice.

row_overflow_fetch_in_bytes

bigint

Contagem cumulativa de bytes de dados de estouro de linha recuperados.

column_value_push_off_row_count

bigint

Contagem cumulativa de valores de coluna para dados LOB e dados de estouro de linha empurrados para fora da linha para que uma linha atualizada ou inserida coubesse na página.

column_value_pull_in_row_count

bigint

Contagem cumulativa de valores de coluna para dados de LOB e dados de estouro de linha puxados para dentro da linha. Isso ocorre quando uma operação de atualização libera espaço em um registro e fornece uma oportunidade de empurrar um ou mais valores para fora da linha das unidades de alocação LOB_DATA ou ROW_OVERFLOW_DATA. Para obter mais informações sobre unidades de alocação, consulte Organização de tabela e índice.

row_lock_count

bigint

Número cumulativo de bloqueios solicitados.

row_lock_wait_count

bigint

Número cumulativo de vezes que o Mecanismo de Banco de Dados esperou por um bloqueio de linha.

row_lock_wait_in_ms

bigint

Número total de milissegundos que o Mecanismo de Banco de Dados esperou por um bloqueio de linha.

page_lock_count

bigint

Número cumulativo de bloqueios de página solicitados.

page_lock_wait_count

bigint

Número cumulativo de vezes que o Mecanismo de Banco de Dados esperou por um bloqueio de página.

page_lock_wait_in_ms

bigint

Número total de milissegundos que o Mecanismo de Banco de Dados esperou por um bloqueio de página.

index_lock_promotion_attempt_count

bigint

Número cumulativo de vezes que o Mecanismo de Banco de Dados tentou escalar bloqueios.

index_lock_promotion_count

bigint

Número cumulativo de vezes que o Mecanismo de Banco de Dados escalou bloqueios.

page_latch_wait_count

bigint

Número cumulativo de vezes que o Mecanismo de Banco de Dados esperou devido a uma contenção de travamento.

page_latch_wait_in_ms

bigint

Número cumulativo de milissegundos que o Mecanismo de Banco de Dados esperou devido a uma contenção de travamento.

page_io_latch_wait_count

bigint

Número cumulativo de vezes que o Mecanismo de Banco de Dados esperou em um travamento de página de E/S.

page_io_latch_wait_in_ms

bigint

Número cumulativo de milissegundos que o Mecanismo de Banco de Dados esperou em uma trava de E/S de página.

tree_page_latch_wait_count

bigint

Subconjunto de page_latch_wait_count que inclui apenas as páginas da árvore B de nível superior. Sempre 0 para um heap.

tree_page_latch_wait_in_ms

bigint

Subconjunto de page_latch_wait_in_ms que inclui só as páginas da árvore B de nível superior. Sempre 0 para um heap.

tree_page_io_latch_wait_count

bigint

Subconjunto de page_io_latch_wait_count que inclui apenas as páginas da árvore B de nível superior. Sempre 0 para um heap.

tree_page_io_latch_wait_in_ms

bigint

Subconjunto de page_io_latch_wait_in_ms que inclui apenas as páginas da árvore B de nível superior. Sempre 0 para um heap.

page_compression_attempt_count

bigint

Número de páginas avaliadas por compactação de nível de PAGE para partições específicas de tabela, índice ou exibição indexada. Inclui páginas que não foram compactadas porque economias significativas não puderam ser obtidas.

page_compression_success_count

bigint

Número de páginas de dados que foram compactadas com a compactação de PAGE para partições específicas de tabela, índice ou exibição indexada.

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

Os valores em lob_orphan_create_count e lob_orphan_insert_count devem ser iguais sempre.

O valor nas colunas lob_fetch_in_pages e lob_fetch_in_bytes podem ser maiores do que zero para índices não clusterizados que contenham uma ou mais colunas LOB como colunas incluídas. Para obter mais informações, consulte Índice com colunas incluídas. Do mesmo modo, o valor nas colunas row_overflow_fetch_in_pages e row_overflow_fetch_in_bytes poderão ser maiores do que 0 para índices não clusterizados se o índice contiver colunas que possam ser empurradas para fora da linha. Para obter mais informações, consulte Dados de estouro de linha excedendo 8 KB.

Como são reiniciados os contadores no cache de metadados

Os dados retornados por sys.dm_db_index_operational_stats só existem enquanto o objeto do cache de metadados que representa o heap ou o índice está disponível. Esses dados não são persistentes nem transacionalmente consistentes. Isso significa que você não pode usar esses contadores para determinar se um índice foi usado ou não, ou quando o índice foi usado pela última vez. Para obter mais informações a respeito, consulte sys.dm_db_index_usage_stats (Transact-SQL).

Os valores de cada coluna são definidos como zero sempre que os metadados do heap ou do índice forem trazidos para o cache de metadados e as estatísticas são acumuladas até que o objeto do cache seja removido do cache de metadados. Portanto, um heap ou índice ativo provavelmente sempre terá seus metadados no cache e as contagens cumulativas poderão refletir a atividade desde que a instância do SQL Server foi iniciada pela última vez. Os metadados de um heap ou índice menos ativo são movidos para dentro e para fora do cache à medida que ele é usado. Como resultado, ele pode ou não ter valores disponíveis. Descartar um índice fará com que as estatísticas correspondentes sejam removidas da memória e não sejam mais reportadas pela função. Outras operações DDL em relação ao índice podem fazer com que o valor das estatísticas seja redefinido como zero.

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

É possível usar as funções Transact-SQLDB_ID e OBJECT_ID para especificar um valor para os parâmetros database_id e object_id. Entretanto, passar valores que não sejam válidos para essas funções pode provocar resultados não intencionais. Sempre verifique se uma ID válida é retornada ao usar DB_ID ou OBJECT_ID. Para obter mais informações, consulte a seção Comentários em sys.dm_db_index_physical_stats (Transact-SQL).

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 AdventureWorks2008R2. A execução desta consulta requer, no mínimo, a permissão CONTROL na tabela Person.Address.

Observação importanteImportante

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 de 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'AdventureWorks2008R2');
SET @object_id = OBJECT_ID(N'AdventureWorks2008R2.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

O exemplo a seguir retorna informações para todas as tabelas e índices na instância do SQL Server. A execução dessa consulta requer a permissão VIEW SERVER STATE.

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