sp_autostats (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Exibe ou altera a opção de atualização automática de estatísticas, AUTO_UPDATE_STATISTICS, para um índice, um objeto de estatísticas, uma tabela ou um modo de exibição indexado.

Para obter mais informações sobre a AUTO_UPDATE_STATISTICS opção, consulte ALTER DATABASE SET Options (Transact-SQL) e Statistics.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_autostats
    [ @tblname = ] N'tblname'
    [ , [ @flagc = ] 'flagc' ]
    [ , [ @indname = ] N'indname' ]
[ ; ]

Argumentos

@tblname [ = ] N'tblname'

O nome da tabela ou do modo de exibição indexado para o qual exibir a AUTO_UPDATE_STATISTICS opção. @tblname é nvarchar(776), sem padrão.

@flagc [ = ] 'flagc'

Atualiza ou exibe a AUTO_UPDATE_STATISTICS opção. @flagc é varchar(10) e pode ser um destes valores:

Valor Descrição
ON Ativado
OFF Desativado
Não especificado Exibe a configuração atual AUTO_UPDATE_STATISTICS

@indname [ = ] N'indname'

O nome das estatísticas para as quais exibir ou atualizar a AUTO_UPDATE_STATISTICS opção. @indname é sysname, com um padrão de NULL. 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.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Se @flagc for especificado, relata a ação que foi executada, sp_autostats mas não retorna nenhum conjunto de resultados.

Se @flagc não for especificado, sp_autostats retornará o seguinte conjunto de resultados.

Nome da coluna Tipo de dados Descrição
Index Name sysname Nome do índice ou das estatísticas.
AUTOSTATS varcar(3) Valor atual da AUTO_UPDATE_STATISTICS opção.
Last Updated datetime Data da atualização mais recente das estatísticas.

O conjunto de resultados para uma tabela ou exibição indexada inclui estatísticas criadas para índices, estatísticas de coluna única geradas com a AUTO_CREATE_STATISTICS opção 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 está sempre DESLIGADO para tabelas otimizadas para memória.

Permissões

Para alterar a AUTO_UPDATE_STATISTICS opção, você precisa de associação na db_owner função de banco de dados fixa ou ALTER permissão em @tblname.

Para exibir a AUTO_UPDATE_STATISTICS opção, você precisa ser membro da função pública .

Exemplos

R. 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 Production.Product.

USE AdventureWorks2022;
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 AUTO_UPDATE_STATISTICS opção para todas as estatísticas na Production.Product tabela.

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

C. Desabilitar AUTO_UPDATE_STATISTICS para um determinado índice

O exemplo a seguir desabilita a AUTO_UPDATE_STATISTICS opção para o AK_Product_Name índice na Production.Product tabela.

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

Conteúdo relacionado