sp_autostats (Transact-SQL)

Visualizza o modifica l'opzione di aggiornamento delle statistiche automatiche AUTO_UPDATE_STATISTICS per un indice, un oggetto statistiche, una tabella o una vista indicizzata.

Per ulteriori informazioni sull'opzione AUTO_UPDATE_STATISTICS, vedere Opzioni ALTER DATABASE SET (Transact-SQL) e Utilizzo di statistiche per migliorare le prestazioni di esecuzione delle query.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sp_autostats [ @tblname = ] 'table_or_indexed_view_name' 
    [ , [ @flagc = ] 'stats_value' ] 
    [ , [ @indname = ] 'statistics_name' ]

Argomenti

  • [ @tblname= ] 'table_or_indexed_view_name'
    Nome della tabella o della vista indicizzata per cui si desidera visualizzare l'impostazione AUTO_UPDATE_STATISTICS. table_or_indexed_view_name è di tipo nvarchar(776) e non prevede alcun valore predefinito.

  • [ @flagc= ] 'stats_value'
    Aggiorna l'opzione AUTO_UPDATE_STATISTICS con uno di questi valori:

    ON = ON

    OFF = OFF

    Quando stats_flag non è specificato, visualizza l'impostazione AUTO_UPDATE_STATISTICS corrente. stats_value è di tipo varchar(10), con impostazione predefinita NULL.

  • [ @indname= ] 'statistics_name'
    Nome delle statistiche per cui si desidera visualizzare o aggiornare l'opzione AUTO_UPDATE_STATISTICS. Per visualizzare le statistiche per un indice, è possibile utilizzare il nome dell'indice, in quanto un indice e l'oggetto statistiche corrispondente hanno lo stesso nome.

    statistics_name è di tipo sysname e il valore predefinito è NULL.

Valori del codice restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Se stats_flag viene specificato, sp_autostats segnala l'operazione eseguita, ma non restituisce un set di risultati.

Se stats_flag viene omesso, sp_autostats restituisce il set di risultati seguente.

Nome colonna

Tipo di dati

Descrizione

Index Name

varchar(60)

Nome dell'indice o delle statistiche.

AUTOSTATS

varchar(3)

Valore corrente dell'opzione AUTO_UPDATE_STATISTICS.

Last Updated

datetime

Data dell'aggiornamento più recente delle statistiche.

Il set di risultati per una tabella o vista indicizzata include statistiche create per gli indici, statistiche a colonna singola generate con l'opzione AUTO_CREATE_STATISTICS e statistiche create con l'istruzione CREATE STATISTICS.

Osservazioni

Se l'indice specificato è disabilitato oppure la tabella specificata include un indice cluster disabilitato, viene visualizzato un messaggio di errore.

Autorizzazioni

Per modificare l'impostazione di AUTO_UPDATE_STATISTICS, è necessario essere membri del ruolo predefinito del database db_owner oppure disporre dell'autorizzazione ALTER per table_name. Per visualizzare l'opzione AUTO_UPDATE STATISTICS, è necessario essere membri del ruolo public.

Esempi

A. Visualizzazione dello stato di tutte le statistiche in una tabella

Nell'esempio seguente viene visualizzato lo stato di tutte le statistiche della tabella Product.

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

B. Abilitazione di AUTO_UPDATE_STATISTICS per tutte le statistiche di una tabella

In questo esempio viene abilitata l'opzione AUTO_UPDATE_STATISTICS per tutte le statistiche della tabella Product.

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

C. Disabilitazione di AUTO_UPDATE_STATISTICS per un indice specifico

Nell'esempio seguente l'opzione AUTO_UPDATE_STATISTICS viene disabilitata per l'indice AK_Product_Name della tabella Product.

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

Cronologia modifiche

Aggiornamento del contenuto

Revisioni in tutto il documento per migliorare l'accuratezza.

L'argomento contiene riferimenti al nuovo contenuto sulle statistiche nell'argomento Utilizzo di statistiche per migliorare le prestazioni di esecuzione delle query.