sys.sp_autostats (Transact-SQL)

Si applica a:SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureDatabase SQL in Microsoft Fabric

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 maggiori informazioni sull'opzione AUTO_UPDATE_STATISTICS , consulta ALTER DATABASE SET Opzioni e Statistiche.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sys.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'

Aggiorna 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 una vista indicizzata include statistiche create per 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.

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.

Note

In database SQL di Azure e SQL database in Microsoft Fabric, l'USEaffermazione non è disponibile. Invece, collegati direttamente al database previsto ed esegui il resto del campione di codice.

USE AdventureWorks2022;
GO

EXECUTE 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

EXECUTE 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

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