Хранимая процедура sp_autostats (Transact-SQL)sp_autostats (Transact-SQL)

Область применения: ДаSQL Server ДаБаза данных SQL Azure НетAzure Synapse Analytics (Хранилище данных SQL) НетParallel Data Warehouse APPLIES TO: YesSQL Server YesAzure SQL Database NoAzure Synapse Analytics (SQL DW) NoParallel Data Warehouse

Отображает или изменяет параметр автоматического обновления статистики AUTO_UPDATE_STATISTICS для индекса, объекта статистики, таблицы или индексированного представления.Displays or changes the automatic statistics update option, AUTO_UPDATE_STATISTICS, for an index, a statistics object, a table, or an indexed view.

Дополнительные сведения о параметре AUTO_UPDATE_STATISTICS см. в разделе Параметры ALTER DATABASE SET ()и статистики Transact-SQL . For more information about the AUTO_UPDATE_STATISTICS option, see ALTER DATABASE SET Options (Transact-SQL) and Statistics.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

  
sp_autostats [ @tblname = ] 'table_or_indexed_view_name'   
    [ , [ @flagc = ] 'stats_flag' ]   
    [ , [ @indname = ] 'statistics_name' ]  

АргументыArguments

[ @tblname = ] 'table_or_indexed_view_name'Имя таблицы или индексированного представления для отображения параметра AUTO_UPDATE_STATISTICS.[ @tblname = ] 'table_or_indexed_view_name' Is the name of the table or indexed view to display the AUTO_UPDATE_STATISTICS option on. table_or_indexed_view_name имеет тип nvarchar (776) и не имеет значения по умолчанию.table_or_indexed_view_name is nvarchar(776), with no default.

[ @flagc = ] 'stats_flag'Обновляет параметр AUTO_UPDATE_STATISTICS одним из следующих значений:[ @flagc = ] 'stats_flag' Updates the AUTO_UPDATE_STATISTICS option to one of these values:

вкл . = вкл.ON = ON

выкл . = выкл.OFF = OFF

Если параметр stats_flag не указан, отобразится текущее значение параметра AUTO_UPDATE_STATISTICS.When stats_flag is not specified, display the current AUTO_UPDATE_STATISTICS setting. stats_flag имеет тип varchar (10) и значение по умолчанию NULL.stats_flag is varchar(10), with a default of NULL.

[ @indname = ] 'statistics_name'Имя статистики для вывода или обновления параметра AUTO_UPDATE_STATISTICS в.[ @indname = ] 'statistics_name' Is the name of the statistics to display or update the AUTO_UPDATE_STATISTICS option on. Чтобы отобразить статистику для индекса, можно использовать имя индекса. Имя индекса совпадает с именем соответствующего объекта статистики.To display the statistics for an index, you can use the name of the index; an index and its corresponding statistics object have the same name.

Аргумент statistics_name имеет тип sysnameи значение по умолчанию NULL.statistics_name is sysname, with a default of NULL.

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

0 (успех) или 1 (сбой).0 (success) or 1 (failure)

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

Если указан параметр stats_flag , sp_autostats сообщает о выполненном действии, но не возвращает результирующий набор.If stats_flag is specified, sp_autostats reports the action that was taken but returns no result set.

Если stats_flag не указан, sp_autostats возвращает следующий результирующий набор.If stats_flag is not specified, sp_autostats returns the following result set.

Имя столбцаColumn name Тип данныхData type DescriptionDescription
Имя индексаIndex Name varchar(60)varchar(60) Имя индекса или статистики.Name of the index or statistics.
AUTOSTATSAUTOSTATS varchar (3)varchar(3) Текущее значение параметра AUTO_UPDATE_STATISTICS.Current value for the AUTO_UPDATE_STATISTICS option.
Последнее обновлениеLast Updated datetimedatetime Дата последнего обновления статистики.Date of the most recent statistics update.

Результирующий набор для таблицы или индексированного представления включает статистику, созданную для индексов, статистику по отдельным столбцам, созданную с параметром AUTO_CREATE_STATISTICS и статистикой, созданной с помощью инструкции CREATE STATISTICS .The result set for a table or indexed view includes statistics created for indexes, single-column statistics generated with the AUTO_CREATE_STATISTICS option and statistics created with the CREATE STATISTICS statement.

RemarksRemarks

Если указанный индекс отключен или указанная таблица имеет отключенный кластеризованный индекс, выводится сообщение об ошибке.If the specified index is disabled, or the specified table has a disabled clustered index, an error message is displayed.

Параметр AUTO_UPDATE_STATISTICS всегда имеет значение OFF для таблиц с оптимизацией памяти.AUTO_UPDATE_STATISTICS is always OFF for memory-optimized tables.

РазрешенияPermissions

Для изменения параметра AUTO_UPDATE_STATISTICS требуется членство в предопределенной роли базы данных db_owner или разрешение ALTER на table_name. Для вывода параметра AUTO_UPDATE_STATISTICS требуется членство в роли Public .To change the AUTO_UPDATE_STATISTICS option requires membership n the db_owner fixed database role, or ALTER permission on table_name.To display the AUTO_UPDATE_STATISTICS option requires membership in the public role.

ПримерыExamples

A.A. Отображение состояния всей статистики по таблицеDisplay the status of all statistics on a table

Следующий код выводит состояние всей статистики по таблице Product.The following displays the status of all statistics on the Product table.

USE AdventureWorks2012;  
GO  
EXEC sp_autostats 'Production.Product';  
GO  

Б.B. Включение параметра AUTO_UPDATE_STATISTICS для всей статистики по таблицеEnable AUTO_UPDATE_STATISTICS for all statistics on a table

Следующий код включает параметр AUTO_UPDATE_STATISTICS для всей статистики по таблице Product.The following enables the AUTO_UPDATE_STATISTICS option for all statistics on the Product table.

USE AdventureWorks2012;  
GO  
EXEC sp_autostats 'Production.Product', 'ON';  
GO  

В.C. Отключение параметра AUTO_UPDATE_STATISTICS для конкретного индексаDisable AUTO_UPDATE_STATISTICS for a specific index

В следующем примере отключается параметр AUTO_UPDATE_STATISTICS для индекса AK_Product_Name по таблице Product.The following example disables the AUTO_UPDATE_STATISTICS option for the AK_Product_Name index on the Product table.

USE AdventureWorks2012;  
GO  
EXEC sp_autostats 'Production.Product', 'OFF', AK_Product_Name;  
GO  

См. также:See Also

Статистически Statistics
Параметры ALTER DATABASE SET (Transact-SQL) ALTER DATABASE SET Options (Transact-SQL)
Ядро СУБД хранимых процедур (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
Создание статистики (Transact-SQL) CREATE STATISTICS (Transact-SQL)
DBCC SHOW_STATISTICS (Transact-SQL) DBCC SHOW_STATISTICS (Transact-SQL)
Удаление статистики (Transact-SQL) DROP STATISTICS (Transact-SQL)
sp_createstats (Transact-SQL) sp_createstats (Transact-SQL)
Обновление статистики (Transact-SQL) UPDATE STATISTICS (Transact-SQL)
Системные хранимые процедуры ()Transact-SQLSystem Stored Procedures (Transact-SQL)