Compartilhar via


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.

Ícone de vínculo de tópicoConvenções de 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 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