sp_autostats (Transact-SQL)

  • Articolo

Si applica a:SQL ServerDatabase SQL di AzureIstanza gestita di SQL di Azure

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

Per altre informazioni sull'opzioneAUTO_UPDATE_STATISTICS, vedere Opzioni ALTER DATABA edizione Standard edizione Standard T (Transact-SQL) e Statistiche.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @tblname = ] N'tblname'

Nome della tabella o della vista indicizzata per cui visualizzare l'opzione AUTO_UPDATE_STATISTICS . @tblname è nvarchar(776), senza impostazione predefinita.

[ @flagc = ] 'flagc'

Aggiornamenti o visualizza l'opzione AUTO_UPDATE_STATISTICS . @flagc è varchar(10)e può essere uno di questi valori:

Valore Descrizione
ON Attivato
OFF Disattivato
Non specificato Visualizza l'impostazione corrente AUTO_UPDATE_STATISTICS

[ @indname = ] N'indname'

Nome delle statistiche per cui visualizzare o aggiornare l'opzione AUTO_UPDATE_STATISTICS . @indname è sysname, con un valore predefinito .NULL 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.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Se viene specificato @flagc , sp_autostats segnala l'azione eseguita ma non restituisce alcun set di risultati.

Se @flagc non viene specificato, sp_autostats restituisce il set di risultati seguente.

Nome colonna Tipo di dati Descrizione
Index Name sysname Nome dell'indice o delle statistiche.
AUTOSTATS varchar(3) Valore corrente per l'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 le statistiche create per gli indici, le statistiche a colonna singola generate con l'opzione AUTO_CREATE_STATISTICS e le 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.

AUTO_UPDATE_STATISTICS è sempre OFF per le tabelle ottimizzate per la memoria.

Autorizzazioni

Per modificare l'opzione, è necessaria l'appartenenza AUTO_UPDATE_STATISTICS al ruolo predefinito del database db_owner o ALTER l'autorizzazione per @tblname.

Per visualizzare l'opzione, è necessaria l'appartenenza AUTO_UPDATE_STATISTICS al ruolo pubblico .

Esempi

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

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

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

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

Nell'esempio seguente viene abilitata l'opzione AUTO_UPDATE_STATISTICS per tutte le statistiche nella Production.Product tabella.

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

C. Disabilitazione di AUTO_UPDATE_STATISTICS per un indice specifico

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

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

Contenuto correlato