sys.stats (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise de SQL no Microsoft Fabric Warehouse no Microsoft Fabric

Contém uma linha para cada objeto de estatística que existe para as tabelas, índices e exibições indexadas no banco de dados do SQL Server. Todo índice tem uma linha de estatística correspondente com o mesmo nome e ID (index_id = stats_id), mas nem toda linha de estatística tem um índice correspondente.

A exibição do catálogo sys.stats_columns fornece informações de estatísticas para cada coluna do banco de dados.

Para obter mais informações sobre estatísticas, consulte Estatísticas.

Observação

Para obter mais informações sobre estatísticas no Microsoft Fabric, confira Estatísticas no Microsoft Fabric.

Nome da coluna Tipo de dados Descrição
object_id int ID do objeto ao qual essas estatísticas pertencem.
name sysname Nome da estatística. É exclusiva no objeto.
stats_id int ID da estatística. É exclusiva no objeto.

Se as estatísticas corresponderem a um índice, o valor de stats_id será o mesmo que o valor de index_id na exibição do catálogo sys.indexes.
auto_created bit Indica se as estatísticas foram criadas automaticamente pelo SQL Server.

0 = As estatísticas não foram criadas automaticamente pelo SQL Server.

1 = As estatísticas foram criadas automaticamente pelo SQL Server.
user_created bit Indica se as estatísticas foram criadas automaticamente por um usuário.

0 = As estatísticas não foram criadas por um usuário.

1 = As estatísticas foram criadas por um usuário.
no_recompute bit Indica se as estatísticas foram criadas com a opção NORECOMPUTE.

0 = As estatísticas não foram criadas com a opção NORECOMPUTE.

1 = As estatísticas foram criadas com a opção NORECOMPUTE.
has_filter bit 0 = As estatísticas não têm um filtro e são computadas em todas as linhas.

1 = As estatísticas têm um filtro e são computadas apenas em linhas que satisfazem a definição de filtro.
filter_definition nvarchar(max) Expressão do subconjunto de linhas incluído em estatísticas filtradas.

NULL = Estatísticas não filtradas.
is_temporary bit Indica se as estatísticas são temporárias. Estatísticas temporárias dão suporte a bancos de dados secundários de grupos de disponibilidade Always On que são habilitados para acesso somente leitura.

0 = As estatísticas não são temporárias.

1 = As estatísticas são temporárias.

Aplica-se ao: SQL Server (Começando pelo SQL Server 2012 (11.x))
is_incremental bit Indica se as estatísticas são criadas como estatísticas incrementais.

0 = as estatísticas não são incrementais.

1 = as estatísticas são incrementais.

Aplica-se ao: SQL Server (Começando pelo SQL Server 2014 (12.x))
has_persisted_sample bit Indica se as estatísticas foram criadas ou atualizadas com a opção PERSIST_SAMPLE_PERCENT.

0 = As estatísticas não estão persistindo o percentual de exemplo.

1 = As estatísticas foram criadas ou atualizadas com a opção PERSIST_SAMPLE_PERCENT.

Aplica-se ao: SQL Server (Começando pelo SQL Server 2019 (15.x))
stats_generation_method int Indica o método pelo qual as estatísticas são criadas.

0 = Estatísticas baseadas em classificação

1 = Somente para uso interno

Aplica-se ao: SQL Server (Começando pelo SQL Server 2019 (15.x))
stats_generation_method_desc varchar(255) A descrição do texto do método pelo qual as estatísticas são criadas.

Estatísticas baseadas em classificação

Somente para uso interno

Aplica-se ao: SQL Server (Começando pelo SQL Server 2019 (15.x))
auto_drop bit Indica se o recurso de remoção automática está ou não habilitado para este objeto de estatísticas. A propriedade AUTO_DROP permite a criação de objetos de estatísticas em um modo que uma alteração de esquema posterior não seja bloqueada pelo objeto de estatística, mas, em vez disso, as estatísticas sejam removidas conforme necessário. Dessa forma, as estatísticas criadas manualmente com o AUTO_DROP habilitado se comportam como as estatísticas criadas automaticamente. Para obter mais informações, confira Opção AUTO_DROP.

Aplica-se a: Banco de dados SQL do Azure, Instância Gerenciada de SQL do Azure e a partir do SQL Server 2022 (16.x).

Permissões

A visibilidade dos metadados em exibições do catálogo está limitada aos protegíveis que pertencem a um usuário ou para os quais o usuário recebeu permissão. Para obter mais informações, consulte Metadata Visibility Configuration.

Exemplos

Os exemplos a seguir retornam todas as estatísticas e as colunas de estatísticas da tabela HumanResources.Employee.

USE AdventureWorks2022;
GO
SELECT s.name AS statistics_name
      ,c.name AS column_name
      ,sc.stats_column_id
FROM sys.stats AS s
INNER JOIN sys.stats_columns AS sc
    ON s.object_id = sc.object_id AND s.stats_id = sc.stats_id
INNER JOIN sys.columns AS c
    ON sc.object_id = c.object_id AND c.column_id = sc.column_id
WHERE s.object_id = OBJECT_ID('HumanResources.Employee');

Confira também

Próximas etapas