sys.dm_db_incremental_stats_properties (Transact-SQL)

Aplica-se a: SQL Server

Devolve propriedades das estatísticas incrementais para o objeto da base de dados especificado (tabela) na base 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 usado para estatísticas não incrementais.

Esta 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
É o ID do objeto na base de dados atual para o qual se solicitam propriedades de uma das suas estatísticas incrementais. object_id é int.

stats_id
É o ID das estatísticas para a object_id especificada. O ID de estatísticas pode ser obtido a partir da visualizaçã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 devolver as propriedades do objeto de estatísticas.
stats_id int ID do objeto de estatística. É único dentro da tabela. Para obter mais informações, consulte 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 em que o objeto de estatísticas foi atualizado pela última vez. Para obter mais informações, consulte a seção comentários nesta página.
rows bigint Número total de linhas na tabela quando as estatísticas foram atualizadas pela última vez. Se as estatísticas forem filtradas ou corresponderem a um índice filtrado, o número de linhas poderá ser menor do que o número de linhas na tabela.
rows_sampled bigint Número total de linhas amostradas para cálculos estatísticos.
steps int Número de passos no histograma. Para obter mais informações, consulte DBCC SHOW_STATISTICS (Transact-SQL).
unfiltered_rows bigint Número total de linhas na tabela antes de aplicar a expressão do filtro (para estatísticas filtradas). Se as estatísticas não forem filtradas, unfiltered_rows é igual ao valor que retorna na coluna das linhas.
modification_counter bigint Número total de modificações para a coluna principal de estatísticas (a coluna sobre a qual o histograma é construído) desde a última atualização das estatísticas.

Esta coluna não contém informação para tabelas otimizadas para memória.

Observações

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

  • object_id ou stats_id é NULL.
  • O objeto especificado não é encontrado ou não corresponde a uma tabela com estatísticas incrementais.
  • O ID de estatísticas especificado não corresponde às estatísticas existentes para o ID do objeto especificado.
  • O utilizador atual não tem permissões para visualizar o objeto de estatísticas.

Este comportamento permite o uso seguro de sys.dm_db_incremental_stats_properties quando aplicado cruzadamente a linhas em vistas como sys.objects e sys.stats. Este método pode devolver propriedades para as estatísticas que correspondem a cada partição. Para ver as propriedades das estatísticas fundidas combinadas em todas as partições, use a sys.dm_db_stats_properties em vez disso.

A data de atualização das estatísticas é armazenada no objeto de blob de estatísticas juntamente com o de histograma e o vetor de densidade , não nos metadados. Quando não são lidos dados 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. Este é o caso de estatísticas filtradas para as quais o predicado não devolve linhas, ou para novas tabelas vazias.

Permissions

Requer que o utilizador tenha permissões de seleção nas colunas de estatísticas, que o utilizador seja dono da tabela ou que o utilizador seja membro do sysadmin papel fixo do servidor, do db_owner papel fixo na base de dados ou do db_ddladmin papel fixo da base de dados.

Examples

A. Exemplo simples

O exemplo seguinte devolve as estatísticas para a PartitionTable tabela descrita no tópico Criar Tabelas e Índices Particionados.

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

Para sugestões adicionais de utilização, consulte sys.dm_db_stats_properties.

Ver também

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

  • Last updated on