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.

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.

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 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)

sp_createstats (Transact-SQL)

UPDATE STATISTICS (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)

Conceitos

Estatísticas