sp_autostats (Transact-SQL)sp_autostats (Transact-SQL)

APLICA-SE A: simSQL Server (a partir do 2008) simBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Exibe ou altera a opção de atualização das estatísticas automáticas, AUTO_UPDATE_STATISTICS, para um índice, um objeto de estatísticas, uma tabela ou uma exibição indexada.Displays or changes the automatic statistics update option, AUTO_UPDATE_STATISTICS, for an index, a statistics object, a table, or an indexed view.

Para obter mais informações sobre a opção AUTO_UPDATE_STATISTICS, consulte opções ALTER DATABASE SET (Transact-SQL) e estatísticas.For more information about the AUTO_UPDATE_STATISTICS option, see ALTER DATABASE SET Options (Transact-SQL) and Statistics.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

ArgumentosArguments

[ @tblname = ] 'table_or_indexed_view_name' É o nome da tabela ou exibição indexada na qual exibir a opção AUTO_UPDATE_STATISTICS em.[ @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 está nvarchar(776) , sem padrão.table_or_indexed_view_name is nvarchar(776), with no default.

[ @flagc = ] 'stats_value' Atualiza a opção AUTO_UPDATE_STATISTICS para um destes valores:[ @flagc = ] 'stats_value' Updates the AUTO_UPDATE_STATISTICS option to one of these values:

ON = ONON = ON

OFF = OFFOFF = OFF

Quando stats_flag não é especificado, exiba a configuração AUTO_UPDATE_STATISTICS atual.When stats_flag is not specified, display the current AUTO_UPDATE_STATISTICS setting. stats_value está varchar(10) , com um padrão NULL.stats_value is varchar(10), with a default of NULL.

[ @indname = ] 'statistics_name' É o nome das estatísticas para exibir ou atualizar a opção AUTO_UPDATE_STATISTICS no.[ @indname = ] 'statistics_name' Is the name of the statistics to display or update the AUTO_UPDATE_STATISTICS option on. Para exibir as estatísticas de um índice, é possível usar o nome do índice; um índice e seu objeto de estatísticas correspondente têm o mesmo nome.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 está sysname, com um padrão NULL.statistics_name is sysname, with a default of NULL.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Se stats_flag for especificado, sp_autostats informará a ação realizada, mas não retorna nenhum conjunto de resultados.If stats_flag is specified, sp_autostats reports the action that was taken but returns no result set.

Se stats_flag não for especificado, sp_autostats retorna o conjunto de resultados a seguir.If stats_flag is not specified, sp_autostats returns the following result set.

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
Nome do ÍndiceIndex Name varchar(60)varchar(60) Nome do índice ou das estatísticas.Name of the index or statistics.
AUTOSTATSAUTOSTATS varchar(3)varchar(3) Valor atual da opção AUTO_UPDATE_STATISTICS.Current value for the AUTO_UPDATE_STATISTICS option.
Última atualizaçãoLast Updated datetimedatetime Data da atualização mais recente das estatísticas.Date of the most recent statistics update.

O conjunto de resultados para uma tabela ou exibição indexada inclui estatísticas criadas para índices, estatísticas de coluna única geradas com a opção AUTO_CREATE_STATISTICS e estatísticas criadas com o CREATE STATISTICS instrução.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.

ComentáriosRemarks

Se o índice especificado for desabilitado ou a tabela especificada tiver um índice clusterizado desabilitado, uma mensagem de erro será exibida.If the specified index is disabled, or the specified table has a disabled clustered index, an error message is displayed.

AUTO_UPDATE_STATISTICS será sempre OFF para tabelas otimizadas em memória.AUTO_UPDATE_STATISTICS is always OFF for memory-optimized tables.

PermissõesPermissions

Para alterar AUTO_UPDATE_STATISTICS opção exige associação à db_owner fixa a função de banco de dados ou a permissão ALTER no table_name. Para exibir AUTO_UPDATE_STATISTICS opção requer associação na pública função.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.

ExemplosExamples

A.A. Exibir o status de todas as estatísticas em uma tabelaDisplay the status of all statistics on a table

O exemplo a seguir exibe o status de todas as estatísticas na tabela Product.The following displays the status of all statistics on the Product table.

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

B.B. Habilitar AUTO_UPDATE_STATISTICS para todas as estatísticas de uma tabelaEnable AUTO_UPDATE_STATISTICS for all statistics on a table

O exemplo a seguir habilita a opção AUTO_UPDATE_STATISTICS para todas as estatísticas da tabela 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.C. Desabilitar AUTO_UPDATE_STATISTICS para um determinado índiceDisable AUTO_UPDATE_STATISTICS for a specific index

O exemplo a seguir desabilita a opção AUTO_UPDATE_STATISTICS para o índice AK_Product_Name na tabela 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  

Consulte tambémSee Also

Estatística Statistics
Opções ALTER DATABASE SET (Transact-SQL) ALTER DATABASE SET Options (Transact-SQL)
Procedimentos armazenados do mecanismo de banco de dados (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
CREATE STATISTICS (Transact-SQL) CREATE STATISTICS (Transact-SQL)
DBCC SHOW_STATISTICS (Transact-SQL) DBCC SHOW_STATISTICS (Transact-SQL)
DROP STATISTICS (Transact-SQL) DROP STATISTICS (Transact-SQL)
sp_createstats (Transact-SQL) sp_createstats (Transact-SQL)
UPDATE STATISTICS (Transact-SQL) UPDATE STATISTICS (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)System Stored Procedures (Transact-SQL)