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 Usando estatísticas para melhorar o desempenho de consultas.
.gif "Ícone de vínculo de tópico")
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 para qual a opção AUTO_UPDATE_STATISTICS é exibida. 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 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 retorna nenhum conjunto de resultados.
Se stats_flag não for especificado, sp_autostats retornará o seguinte conjunto de resultados.
Nome da coluna |
Tipo de dados |
Descrição |
|---|---|---|
Nome do Índice |
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.
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 público.
Exemplos
A. Exiba o status de todas as estatísticas em uma tabela
O seguinte exemplo exibe o status de todas as estatísticas na tabela Product.
USE AdventureWorks2008R2;
GO
EXEC sp_autostats 'Production.Product';
GO
B. Habilite AUTO_UPDATE_STATISTICS para todas as estatísticas de uma tabela
O seguinte exemplo habilita a opção AUTO_UPDATE_STATISTICS de todas as estatísticas da tabela Product.
USE AdventureWorks2008R2;
GO
EXEC sp_autostats 'Production.Product', 'ON';
GO
C. Desabilite AUTO_UPDATE_STATISTICS de um determinado índice
O seguinte exemplo desabilita a opção AUTO_UPDATE_STATISTICS do índice AK_Product_Name da tabela Product.
USE AdventureWorks2008R2;
GO
EXEC sp_autostats 'Production.Product', 'OFF', AK_Product_Name;
GO
Consulte também