sp_helpstats (Transact-SQL)

Статья
08/21/2023

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

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

Внимание

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

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

Синтаксис

  
sp_helpstats[ @objname = ] 'object_name'   
     [ , [ @results = ] 'value' ]

Аргументы

[ @objname = ] 'object_name' Указывает таблицу, в которой содержатся сведения о статистике. object_name является nvarchar(520) и не может иметь значение NULL. Можно указать одно- или двухкомпонентное имя таблицы.

[ @results = ] 'value' Указывает степень предоставленной информации. Допустимые записи — ALL и STATS. ВСЕ списки статистики для всех индексов, а также столбцов с статистикой, созданной на них; STATS выводит только статистику, не связанную с индексом. значение равно nvarchar(5) со значением по умолчанию STATS.

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

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

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

Замечания

Для отображения подробных статистических сведений об определенном индексе или статистике воспользуйтесь инструкцией DBCC SHOW_STATISTICS. Дополнительные сведения см. в статьях DBCC SHOW_STATISTICS (Transact-SQL) и sp_helpindex (Transact-SQL).

Разрешения

Необходимо быть членом роли 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

См. также

Системные хранимые процедуры (Transact-SQL)
ядро СУБД хранимые процедуры (Transact-SQL)