sys.dm_db_incremental_stats_properties (Transact-SQL)

Aplica-se a: SQL Server

Retorna propriedades de estatísticas incrementais para o objeto de banco de dados especificado (tabela) no banco de dados SQL Server atual. O uso de sys.dm_db_incremental_stats_properties (que contém um número de partição) é semelhante ao sys.dm_db_stats_properties , que é usado para estatísticas não incrementais.

Essa função foi introduzida no SQL Server 2014 (12.x) Service Pack 2 e no SQL Server 2016 (13.x) Service Pack 1.

Sintaxe

sys.dm_db_incremental_stats_properties (object_id, stats_id)  

Argumentos

object_id
É a ID do objeto no banco de dados atual para o qual as propriedades de uma de suas estatísticas incrementais é solicitada. object_id é int.

stats_id
É a ID de estatísticas do object_idespecificado. A ID de estatísticas pode ser obtida na exibição de gerenciamento dinâmico sys.stats . stats_id é int.

Tabela retornada

Nome da coluna Tipo de dados Descrição
object_id int ID do objeto (tabela) para o qual as propriedades do objeto de estatísticas serão retornadas.
stats_id int ID do objeto de estatísticas. É exclusivo na tabela. Para obter mais informações, veja sys.stats (Transact-SQL).
partition_number int Número da partição que contém a parte da tabela.
last_updated datetime2 Data e hora da última atualização do objeto de estatísticas. Para obter mais informações, consulte a seção de Comentários nesta página.
rows bigint O número total de linhas da tabela na última atualização das estatísticas. Se as estatísticas forem filtradas ou corresponderem a um índice filtrado, o número de linhas talvez seja menor do que o número de linhas na tabela.
rows_sampled bigint O número total de linhas amostradas para cálculos de estatísticas.
etapas int O número de etapas no histograma. Para obter mais informações, veja DBCC SHOW_STATISTICS (Transact-SQL).
unfiltered_rows bigint O número total de linhas da tabela antes da aplicação da expressão de filtro (para estatísticas filtradas). Se as estatísticas não forem filtradas, unfiltered_rows será igual ao valor retornado na coluna de linhas.
modification_counter bigint Número total de modificações da coluna de estatísticas principal (a coluna em que o histograma é criado) desde que as últimas estatísticas de tempo foram atualizadas.

Essa coluna não mantém informações para tabelas com otimização de memória.

Comentários

sys.dm_db_incremental_stats_properties retorna um conjunto de linhas vazio em qualquer uma das seguintes condições:

  • stats_id ou object_id é NULO.
  • O objeto especificado não foi encontrado ou não corresponde a uma tabela com estatísticas incrementais.
  • A ID de estatísticas especificada não corresponde às estatísticas existentes para a ID de objeto especificada.
  • O usuário atual não tem permissões para exibir o objeto de estatísticas.

Esse comportamento permite o uso seguro de sys.dm_db_incremental_stats_properties quando aplicado a linhas em exibições como sys.objects e sys.stats. Esse método pode retornar propriedades para as estatísticas que correspondem a cada partição. Para ver as propriedades das estatísticas mescladas combinadas entre todas as partições, use sys.dm_db_stats_properties.

A data de atualização de estatísticas é armazenada no objeto de blob de estatísticas, junto com o histograma e o vetor de densidade, não nos metadados. Quando nenhum dado é lido para gerar dados estatísticos, o blob de estatísticas não é criado, a data não está disponível e a coluna last_updated é NULL. Esse é o caso para estatísticas filtradas para as quais o predicado não retorna nenhuma linha ou para novas tabelas vazias.

Permissões

Requer que o usuário tenha permissões selecionadas em colunas de estatísticas, que ele possua a tabela ou que seja membro da função de servidor fixa sysadmin, da função de banco de dados fixa db_owner ou da função de banco de dados fixa db_ddladmin.

Exemplos

a. Exemplo simples

O exemplo a seguir retorna as estatísticas para a tabela PartitionTable descrita no tópico Criar tabelas e índices particionados.

SELECT * FROM sys.dm_db_incremental_stats_properties (object_id('PartitionTable'), 1);

Para obter sugestões de uso adicionais, consulte sys.dm_db_stats_properties.

Confira também

DBCC SHOW_STATISTICS (Transact-SQL)
sys.stats (Transact-SQL)
Funções e exibições de gerenciamento dinâmico relacionadas a objetos (Transact-SQL)
Exibições e funções de gerenciamento dinâmico (Transact-SQL)
sys.dm_db_stats_properties
sys.dm_db_stats_histogram (Transact-SQL)