sys.dm_db_index_operational_stats (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

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

Os índices com otimização de memória não aparecem nessa DMV.

Convenções de sintaxe de 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 | NULO | 0 | INADIMPLÊNCIA

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 para todos os bancos de dados na instância do SQL Server. Se você especificar NULL para database_id, também deverá especificar NULL para object_id, index_id e partition_number.

A função interna DB_ID pode ser especificada.

object_id | NULO | 0 | INADIMPLÊNCIA

ID do objeto da tabela ou exibição em que o índice está. 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 | NULO | -1 | INADIMPLÊNCIA

ID do índice. index_id é int. As entradas válidas são o número de 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 | NULO | 0 | INADIMPLÊNCIA

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 é baseado em 1. Um índice ou heap não particionado partition_number definido como 1.

Tabela retornada

Nome da coluna	Tipo de dados	Descrição
database_id	smallint	ID do banco de dados. No Banco de Dados SQL do Azure, os valores são exclusivos em um único banco de dados ou em um pool elástico, mas não em um servidor lógico.
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.
hobt_id	bigint	Aplica-se a: SQL Server 2016 (13.x) e versões posteriores, Banco de Dados SQL do Azure. ID do heap de dados ou conjunto de linhas de árvore B que rastreia dados internos para um índice columnstore. NULL - este não é um conjunto de linhas columnstore interno. Para obter mais detalhes, consulte sys.internal_partitions (Transact-SQL)
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_delete_count só é incrementado para registros excluídos que não são marcados como fantasmas primeiro. Para registros excluídos que são fantasmas primeiro, leaf_ghost_count é incrementado.
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. Essa contagem não inclui registros que são excluídos imediatamente sem serem marcados como fantasmas. 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.
nonleaf_insert_count	bigint	Contagem cumulativa de inserções acima do nível folha. 0 = Heap ou columnstore
nonleaf_delete_count	bigint	Contagem cumulativa de exclusões acima do nível folha. 0 = Heap ou columnstore
nonleaf_update_count	bigint	Contagem cumulativa de atualizações acima do nível folha. 0 = Heap ou columnstore
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 ou columnstore
leaf_page_merge_count	bigint	Contagem cumulativa de mesclagens de página no nível folha. Sempre 0 para índice columnstore.
nonleaf_page_merge_count	bigint	Contagem cumulativa de mesclagens de página acima do nível folha. 0 = Heap ou columnstore
range_scan_count	bigint	Contagem cumulativa de exames de intervalo e de 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).
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 enviadas para fora da linha.
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.
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 um bloqueio de linha.
row_lock_wait_in_ms	bigint	Número total de milissegundos que o Mecanismo de Banco de Dados esperou em 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 em um bloqueio de página.
page_lock_wait_in_ms	bigint	Número total de milissegundos que o Mecanismo de Banco de Dados esperou em um bloqueio de página.
index_lock_promotion_attempt_count	bigint	Número cumulativo de vezes que o Mecanismo de Banco de Dados tentou escalonar bloqueios.
index_lock_promotion_count	bigint	Número cumulativo de vezes que o Mecanismo de Banco de Dados escalonou bloqueios.
page_latch_wait_count	bigint	Número cumulativo de vezes que o Mecanismo de Banco de Dados esperou, devido à contenção de trava.
page_latch_wait_in_ms	bigint	Número cumulativo de milissegundos que o Mecanismo de Banco de Dados esperou, devido à contenção de trava.
page_io_latch_wait_count	bigint	Número cumulativo de vezes que o Mecanismo de Banco de Dados esperou uma trava 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 heaps ou índices columnstore.
tree_page_latch_wait_in_ms	bigint	Subconjunto de page_latch_wait_in_ms que inclui apenas as páginas de árvore B de nível superior. Sempre 0 para heaps ou índices columnstore.
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 heaps ou índices columnstore.
tree_page_io_latch_wait_in_ms	bigint	Subconjunto de page_io_latch_wait_in_ms que inclui apenas as páginas de árvore B de nível superior. Sempre 0 para heaps ou índices columnstore.
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. Sempre 0 para índice columnstore.
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. Sempre 0 para índice columnstore.

Comentários

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

Você pode usar o sys.dm_db_index_operational_stats para controlar o tempo que os usuários devem esperar 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ísicas em uma partição de índice ou 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 sempre iguais.

O valor nas colunas lob_fetch_in_pages e lob_fetch_in_bytes pode ser maior que zero para índices não clusterizados que contêm uma ou mais colunas LOB como colunas incluídas. Para obter mais informações, consulte Create Indexes with Included Columns. Da mesma forma, o valor nas colunas row_overflow_fetch_in_pages e row_overflow_fetch_in_bytes pode ser maior que 0 para índices não clusterizados se o índice contiver colunas que podem ser enviadas para fora da linha.

Como os contadores no Cache de Metadados são redefinidos

Os dados retornados pelo sys.dm_db_index_operational_stats existem apenas enquanto o objeto de cache de metadados que representa o heap ou índice estiver 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 informações sobre isso, 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 podem 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 do sistema para especificar valores de parâmetro

Você pode usar as funções Transact-SQL DB_ID e OBJECT_ID para especificar um valor para os parâmetros database_id e object_id . No entanto, passar valores que não sejam válidos a essas funções pode causar 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 no sys.dm_db_index_physical_stats (Transact-SQL).

Permissões

Requer as seguintes permissões:

• CONTROL no objeto especificado no banco de dados

• VIEW DATABASE STATE ou VIEW DATABASE PERFORMANCE STATE (SQL Server 2022) para retornar informações sobre todos os objetos dentro do banco de dados especificado, usando o curinga de objeto @object_id = NULL

• VIEW SERVER STATEVIEW SERVER PERFORMANCE STATE (SQL Server 2022) permissão para retornar informações sobre todos os bancos de dados, usando o curinga de banco de dados @database_id = NULL

A concessão VIEW DATABASE STATE permite que todos os objetos no banco de dados sejam retornados, independentemente de quaisquer permissões CONTROL negadas em objetos específicos.

A negação VIEW DATABASE STATE não permite que todos os objetos no banco de dados sejam retornados, independentemente de quaisquer permissões CONTROL concedidas em objetos específicos. Além disso, quando o curinga @database_id=NULL do banco de dados é especificado, o banco de dados é omitido.

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

Exemplos

R. Retornando informações de uma tabela especificada

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

DECLARE @db_id int;    
DECLARE @object_id int;    
SET @db_id = DB_ID(N'AdventureWorks2022');    
SET @object_id = OBJECT_ID(N'AdventureWorks2022.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 dentro da 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        

Confira também

Exibições e funções de gerenciamento dinâmico (Transact-SQL)
Exibições e funções de gerenciamento dinâmico relacionadas ao índice (Transact-SQL)
Monitorar e ajustar o desempenho
sys.dm_db_index_physical_stats (Transact-SQL)
sys.dm_db_index_usage_stats (Transact-SQL)
sys.dm_os_latch_stats (Transact-SQL)
sys.dm_db_partition_stats (Transact-SQL)
sys.allocation_units (Transact-SQL)
sys.indexes (Transact-SQL)