Compartilhar via


sp_helpstats (Transact-SQL)

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

Retorna informações de estatísticas sobre colunas e índices na tabela especificada.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Para obter informações sobre estatísticas, consulte as exibições sys.stats e sys.stats_columns catálogo.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_helpstats
    [ @objname = ] N'objname'
    [ , [ @results = ] N'results' ]
[ ; ]

Argumentos

@objname [ = ] n'objname'

Especifica a tabela na qual fornecer informações de estatísticas. @objname é nvarchar(776), sem padrão. Um nome de uma ou duas partes pode ser especificado.

@results [ = ] N'resultados'

Especifica a extensão de informações a fornecer. @results é nvarchar(5), com um padrão de STATS.

  • ALL Lista estatísticas para todos os índices e também colunas que têm estatísticas criadas nelas.
  • STATS lista apenas estatísticas não associadas a um índice.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

A tabela a seguir descreve as colunas do conjunto de resultados.

Nome da coluna Descrição
statistics_name O nome das estatísticas. Retorna sysname e não pode ser NULL.
statistics_keys As chaves nas quais estatísticas são baseadas. Retorna nvarchar(2078) e não pode ser NULL.

Comentários

Use DBCC SHOW_STATISTICS para exibir informações estatísticas detalhadas sobre qualquer índice ou estatística específica. Para obter mais informações, consulte DBCC SHOW_STATISTICS e sp_helpindex.

Permissões

Requer associação à função pública .

Exemplos

O exemplo seguinte cria estatísticas de uma única coluna para todas as colunas elegíveis de todas as tabelas de usuário no banco de dados AdventureWorks2022, executando sp_createstats. Então, sp_helpstats é executado para encontrar as estatísticas resultantes criadas na tabela Customer.

USE AdventureWorks2022;
GO

EXEC sp_createstats;
GO

EXEC sp_helpstats
    @objname = 'Sales.Customer',
    @results = 'ALL';

Veja a seguir o conjunto de resultados.

statistics_name               statistics_keys
---------------------------- ----------------
_WA_Sys_00000003_22AA2996     AccountNumber
AK_Customer_AccountNumber     AccountNumber
AK_Customer_rowguid           rowguid
CustomerType                  CustomerType
IX_Customer_TerritoryID       TerritoryID
ModifiedDate                  ModifiedDate
PK_Customer_CustomerID        CustomerID