sp_autostats (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.

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

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

B. Habilite AUTO_UPDATE_STATISTICS para todas as estatísticas de uma tabela

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

C. Desabilite AUTO_UPDATE_STATISTICS de um determinado índice

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

Histórico de alterações

Consulte também

Referência

Conceitos