sys.dm_db_incremental_stats_properties (Transact-SQL)sys.dm_db_incremental_stats_properties (Transact-SQL)

APLICA-SE A: simSQL Server (a partir do 2014) nãoBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2014) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retorna propriedades de estatísticas incrementais para o objeto de banco de dados especificado (tabela) no banco de dados do SQL ServerSQL Server atual.Returns properties of incremental statistics for the specified database object (table) in the current SQL ServerSQL Server database. 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.The use of sys.dm_db_incremental_stats_properties (which contains a partition number) is similar to sys.dm_db_stats_properties which is used for non-incremental statistics.

Essa função foi introduzida no SQL Server 2014 (12.x)SQL Server 2014 (12.x) Service Pack 2 e SQL Server 2016 (13.x)SQL Server 2016 (13.x) Service Pack 1.This function was introduced in SQL Server 2014 (12.x)SQL Server 2014 (12.x) Service Pack 2 and SQL Server 2016 (13.x)SQL Server 2016 (13.x) Service Pack 1.

SintaxeSyntax

sys.dm_db_incremental_stats_properties (object_id, stats_id)  

ArgumentosArguments

object_idobject_id
É a ID do objeto no banco de dados atual para o qual as propriedades de uma de suas estatísticas incrementais é solicitada.Is the ID of the object in the current database for which properties of one of its incremental statistics is requested. object_id é int.object_id is int.

stats_idstats_id
É a ID de estatísticas do object_idespecificado.Is the ID of statistics for the specified object_id. A ID de estatísticas pode ser obtida na exibição de gerenciamento dinâmico sys.stats .The statistics ID can be obtained from the sys.stats dynamic management view. stats_id é int.stats_id is int.

Tabela retornadaTable Returned

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
object_idobject_id intint ID do objeto (tabela) para o qual as propriedades do objeto de estatísticas serão retornadas.ID of the object (table) for which to return the properties of the statistics object.
stats_idstats_id intint ID do objeto de estatísticas.ID of the statistics object. É exclusivo na tabela.Is unique within the table. Para obter mais informações, veja sys.stats (Transact-SQL).For more information, see sys.stats (Transact-SQL).
partition_numberpartition_number intint Número da partição que contém a parte da tabela.Number of the partition containing the portion of the table.
last_updatedlast_updated datetime2datetime2 Data e hora da última atualização do objeto de estatísticas.Date and time the statistics object was last updated. Para obter mais informações, consulte a seção de Comentários nesta página.For more information, see the Remarks section in this page.
rowsrows bigintbigint O número total de linhas da tabela na última atualização das estatísticas.Total number of rows in the table when statistics were last updated. 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.If the statistics are filtered or correspond to a filtered index, the number of rows might be less than the number of rows in the table.
rows_sampledrows_sampled bigintbigint O número total de linhas amostradas para cálculos de estatísticas.Total number of rows sampled for statistics calculations.
etapassteps intint O número de etapas no histograma.Number of steps in the histogram. Para obter mais informações, veja DBCC SHOW_STATISTICS (Transact-SQL).For more information, see DBCC SHOW_STATISTICS (Transact-SQL).
unfiltered_rowsunfiltered_rows bigintbigint O número total de linhas da tabela antes da aplicação da expressão de filtro (para estatísticas filtradas).Total number of rows in the table before applying the filter expression (for filtered statistics). Se as estatísticas não forem filtradas, unfiltered_rows será igual ao valor retornado na coluna de linhas.If statistics are not filtered, unfiltered_rows is equal to the value returns in the rows column.
modification_countermodification_counter bigintbigint 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.Total number of modifications for the leading statistics column (the column on which the histogram is built) since the last time statistics were updated.

Essa coluna não mantém informações para tabelas com otimização de memória.This column does not contain information for memory-optimized tables.

ComentáriosRemarks

sys.dm_db_incremental_stats_properties retorna um conjunto de linhas vazio em qualquer uma das seguintes condições:sys.dm_db_incremental_stats_properties returns an empty rowset under any of the following conditions:

  • stats_id ou object_id é NULO.object_id or stats_id is NULL.
  • O objeto especificado não foi encontrado ou não corresponde a uma tabela com estatísticas incrementais.The specified object is not found or does not correspond to a table with incremental statistics.
  • A ID de estatísticas especificada não corresponde às estatísticas existentes para a ID de objeto especificada.The specified statistics ID does not correspond to existing statistics for the specified object ID.
  • O usuário atual não tem permissões para exibir o objeto de estatísticas.The current user does not have permissions to view the statistics object.

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.This behavior allows for the safe usage of sys.dm_db_incremental_stats_properties when cross applied to rows in views such as sys.objects and sys.stats. Esse método pode retornar propriedades para as estatísticas que correspondem a cada partição.This method can return properties for the statistics that correspond to each partition. Para ver as propriedades das estatísticas mescladas combinadas entre todas as partições, use sys.dm_db_stats_properties.To see the properties for the merged statistics combined across all partitions, use the sys.dm_db_stats_properties instead.

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.Statistics update date is stored in the statistics blob object together with the histogram and density vector, not in the metadata. Quando nenhum dado é lido para gerar dados de estatísticas, o blob de estatísticas não é criado, a data não estiver disponível e o last_updated coluna será NULL.When no data is read to generate statistics data, the statistics blob is not created, the date is not available, and the last_updated column is NULL. Esse é o caso para estatísticas filtradas para as quais o predicado não retorna nenhuma linha ou para novas tabelas vazias.This is the case for filtered statistics for which the predicate does not return any rows, or for new empty tables.

PermissõesPermissions

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.Requires that the user has select permissions on statistics columns or the user owns the table or the user is a member of the sysadmin fixed server role, the db_owner fixed database role, or the db_ddladmin fixed database role.

ExemplosExamples

A.A. Exemplo simplesSimple example

O exemplo a seguir retorna as estatísticas para a tabela PartitionTable descrita no tópico Criar tabelas e índices particionados.The following example returns the statistics for the PartitionTable table described in the topic Create Partitioned Tables and Indexes.

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.For additional usage suggestions, see sys.dm_db_stats_properties.

Consulte tambémSee Also

DBCC SHOW_STATISTICS (Transact-SQL) DBCC SHOW_STATISTICS (Transact-SQL)
sys.stats (Transact-SQL) sys.stats (Transact-SQL)
Funções e exibições de gerenciamento dinâmico relacionadas ao objeto (Transact-SQL) Object Related Dynamic Management Views and Functions (Transact-SQL)
Exibições e funções de gerenciamento dinâmico (Transact-SQL)Dynamic Management Views and Functions (Transact-SQL)
sys.dm_db_stats_properties sys.dm_db_stats_properties
sys.dm_db_stats_histogram (Transact-SQL)sys.dm_db_stats_histogram (Transact-SQL)