sp_autostats (Transact-SQL)
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.
Para obter mais informações sobre a opção AUTO_UPDATE_STATISTICS, consulte Opções ALTER DATABASE SET (Transact-SQL) e Estatísticas.
Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual). |
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
Sintaxe
sp_autostats [ @tblname = ] 'table_or_indexed_view_name'
[ , [ @flagc = ] 'stats_value' ]
[ , [ @indname = ] 'statistics_name' ]
Argumentos
[ @tblname= ] 'table_or_indexed_view_name'
É o nome da tabela ou da exibição indexada na qual exibir a opção AUTO_UPDATE_STATISTICS. table_or_indexed_view_name é nvarchar(776), sem padrão.[ @flagc= ] 'stats_value'
Atualiza a opção AUTO_UPDATE_STATISTICS para um destes valores:ON = ON
OFF = OFF
Quando stats_flag não é especificado, exiba a configuração AUTO_UPDATE_STATISTICS atual. stats_value é varchar(10), com um padrão de NULL.
[ @indname= ] 'statistics_name'
É o nome das estatísticas de exibição ou atualização da opção AUTO_UPDATE_STATISTICS. 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.statistics_name é sysname, com um padrão NULL.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Conjuntos de resultados
Se stats_flag for especificado, sp_autostats informará a ação realizada, mas não retornará nenhum conjunto de resultados.
Se stats_flag não for especificado, sp_autostats retornará o conjunto de resultados a seguir.
Nome da coluna |
Tipo de dados |
Descrição |
|---|---|---|
Index Name |
varchar(60) |
Nome do índice ou das estatísticas. |
AUTOSTATS |
varchar(3) |
Valor atual da opção AUTO_UPDATE_STATISTICS. |
Last Updated |
datetime |
Data da atualização mais recente das estatísticas. |
O conjunto de resultados de 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 a instrução CREATE STATISTICS.
Comentários
Se o índice especificado for desabilitado ou a tabela especificada tiver um índice clusterizado desabilitado, uma mensagem de erro será exibida.
AUTO_UPDATE_STATISTICS será sempre OFF para tabelas otimizadas em memória.
Permissões
Para alterar AUTO_UPDATE_STATISTICS, a opção exige associação à função de banco de dados fixa db_owner ou a permissão ALTER em table_name. Para exibir AUTO_UPDATE_STATISTICS, a opção exige associação à função public.
Exemplos
A.Exibir o status de todas as estatísticas em uma tabela
O exemplo a seguir exibe o status de todas as estatísticas na tabela Product.
USE AdventureWorks2012;
GO
EXEC sp_autostats 'Production.Product';
GO
B.Habilitar AUTO_UPDATE_STATISTICS para todas as estatísticas de uma tabela
O exemplo a seguir habilita a opção AUTO_UPDATE_STATISTICS para todas as estatísticas da tabela Product.
USE AdventureWorks2012;
GO
EXEC sp_autostats 'Production.Product', 'ON';
GO
C.Desabilitar AUTO_UPDATE_STATISTICS para um determinado índice
O exemplo a seguir desabilita a opção AUTO_UPDATE_STATISTICS para o índice AK_Product_Name na tabela Product.
USE AdventureWorks2012;
GO
EXEC sp_autostats 'Production.Product', 'OFF', AK_Product_Name;
GO
Consulte também
Referência
Opções ALTER DATABASE SET (Transact-SQL)
Procedimentos armazenados do Mecanismo de Banco de Dados (Transact-SQL)
CREATE STATISTICS (Transact-SQL)
DBCC SHOW_STATISTICS (Transact-SQL)
DROP STATISTICS (Transact-SQL)
UPDATE STATISTICS (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)