Partilhar via


sp_helpstats (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Devolve estatísticas informações 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 novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Para obter informações sobre estatísticas, consulte as vistas sys.stats e sys.stats_columns catálogo.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @objname = ] N'objname'

Especifica a tabela onde deve fornecer informação estatística. @objname é nvarchar(776), sem padrão. Pode ser especificado um nome de uma ou duas partes.

[ @results = ] N'resultados'

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

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

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

A tabela seguinte descreve as colunas do conjunto de resultados.

Nome da coluna Description
statistics_name O nome das estatísticas. Devolve sysname e não pode ser NULL.
statistics_keys As chaves em que se baseiam as estatísticas. Devolve nvarchar(2078) e não pode ser NULL.

Observações

Use DBCC SHOW_STATISTICS para mostrar estatísticas detalhadas sobre qualquer índice ou estatística em particular. Para mais informações, consulte o DBCC SHOW_STATISTICS e sp_helpindex.

Permissions

Requer adesão à função pública de .

Examples

O exemplo seguinte cria estatísticas de coluna única para todas as colunas elegíveis de todas as tabelas de utilizador na AdventureWorks2025 base de dados ao executar sp_createstats. Depois, sp_helpstats é executado para encontrar as estatísticas resultantes criadas na Customer tabela.

USE AdventureWorks2022;
GO

EXECUTE sp_createstats;
GO

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

Aqui está 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