Partilhar via


sp_autostats (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Apresenta 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 uma vista indexada.

Para mais informações sobre a AUTO_UPDATE_STATISTICS opção, consulte ALTERAR DATABASE SET opções e Estatísticas.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @tblname = ] N'tblname'

O nome da tabela ou vista indexada para a qual mostrar a AUTO_UPDATE_STATISTICS opção. @tblname é nvarchar(776), sem padrão.

[ @flagc = ] 'flagc'

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

Valor Description
ON On
OFF Off
Não especificado Mostra a configuração atual AUTO_UPDATE_STATISTICS

[ @indname = ] N'indname'

O nome das estatísticas para mostrar ou atualizar a AUTO_UPDATE_STATISTICS opção. @indname é sysname, com um padrão de NULL. Para mostrar as estatísticas de um índice, pode usar o nome do índice; um índice e o seu objeto de estatísticas correspondente têm o mesmo nome.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

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

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

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

O conjunto de resultados para uma tabela ou vista 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 .

Observações

Se o índice especificado estiver desativado, ou se a tabela especificada tiver um índice agrupado desativado, é exibida uma mensagem de erro.

AUTO_UPDATE_STATISTICS está sempre DESLIGADO para tabelas otimizadas para memória.

Permissions

Para alterar a AUTO_UPDATE_STATISTICS opção, precisas de pertença ao papel fixo de base de dados db_owner , ou ALTER permissão para @tblname.

Para mostrar a AUTO_UPDATE_STATISTICS opção, é necessário ser membro do cargo público .

Examples

A. Mostrar o estado de todas as estatísticas numa tabela

O seguinte mostra o estado de todas as estatísticas na Production.Product tabela.

USE AdventureWorks2022;
GO

EXECUTE sp_autostats 'Production.Product';
GO

B. Ative AUTO_UPDATE_STATISTICS para todas as estatísticas numa tabela

O exemplo seguinte permite a AUTO_UPDATE_STATISTICS opção para todas as estatísticas na Production.Product tabela.

USE AdventureWorks2022;
GO

EXECUTE sp_autostats 'Production.Product', 'ON';
GO

C. Desative AUTO_UPDATE_STATISTICS para um índice específico

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

USE AdventureWorks2022;
GO

EXECUTE sp_autostats 'Production.Product', 'OFF', AK_Product_Name;
GO