Поделиться через


sp_helpstats (Transact-SQL)

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

Возвращает статистические сведения о столбцах и индексах указанной таблицы.

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Чтобы получить сведения о статистике, выполните запрос к представлениям sys.stats и sys.stats_columns каталога.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @objname = ] N'objname'

Указывает таблицу, для которой необходимо получить статистические сведения. @objname — nvarchar(776) без значения по умолчанию. Можно указать одно- или двух частей.

[ @results = ] N'results'

Определяет экстент предоставляемых сведений. @results — nvarchar(5) с значением по умолчаниюSTATS.

  • ALL выводит статистику для всех индексов и столбцов, имеющих статистику, созданную на них.
  • STATS только выводит статистику, не связанную с индексом.

Значения кода возврата

0 (успешно) или 1 (сбой).

Результирующий набор

В следующей таблице отображены столбцы результирующего набора.

Имя столбца Description
statistics_name Название статистики. Возвращает имя sysname и не может быть NULL.
statistics_keys Ключи, на которых основаны статистические сведения. Возвращает nvarchar(2078) и не может быть NULL.

Замечания

Используется DBCC SHOW_STATISTICS для отображения подробных сведений о любом конкретном индексе или статистике. Дополнительные сведения см. в разделе DBCC SHOW_STATISTICS и sp_helpindex.

Разрешения

Необходимо быть членом роли public.

Примеры

В следующем примере с помощью процедуры sp_createstats создаются статистики, состоящие из одного столбца, для всех подходящих столбцов всех таблиц пользователя в базе данных AdventureWorks2022. Затем, чтобы найти полученные статистики, созданные для таблицы sp_helpstats, запускается процедура Customer.

USE AdventureWorks2022;
GO

EXEC sp_createstats;
GO

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

Вот результирующий набор.

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