sp_autostats (Transact-SQL)

  • Artikel

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance

Zeigt die Option für die automatische Aktualisierung von Statistiken an, AUTO_UPDATE_STATISTICSfür einen Index, ein Statistikobjekt, eine Tabelle oder eine indizierte Ansicht.

Weitere Informationen zur AUTO_UPDATE_STATISTICS Option finden Sie unter ALTER DATABASE SET-Optionen und Statistiken.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @tblname = ] N'tblname'

Der Name der Tabellen- oder indizierten Ansicht, für die die AUTO_UPDATE_STATISTICS Option angezeigt werden soll. @tblname ist nvarchar(776), ohne Standard.

[ @flagc = ] 'flagc'

Aktualisiert oder zeigt die AUTO_UPDATE_STATISTICS Option an. @flagc ist varchar(10) und kann eine der folgenden Werte sein:

Wert Beschreibung
ON Andererseits
OFF Aus
Nicht angegeben Zeigt die aktuelle AUTO_UPDATE_STATISTICS Einstellung an.

[ @indname = ] N'indname'

Der Name der Statistik, für die die AUTO_UPDATE_STATISTICS Option angezeigt oder aktualisiert werden soll. @indname ist "sysname" mit der Standardeinstellung "NULL. Um die Statistik für einen Index anzuzeigen, können Sie den Namen des Indexes verwenden. Ein Index und das dazugehörige Statistikobjekt verfügen über den gleichen Namen.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Wenn @flagc angegeben ist, meldet die aktion, die ausgeführt wurde, sp_autostats gibt aber kein Resultset zurück.

Wenn @flagc nicht angegeben ist, sp_autostats wird das folgende Resultset zurückgegeben.

Spaltenname Datentyp Beschreibung
Index Name sysname Name des Indexes oder der Statistik.
AUTOSTATS varchar(3) Aktueller Wert für die AUTO_UPDATE_STATISTICS Option.
Last Updated datetime Das Datum des letzten Statistikupdates.

Das Resultset für eine Tabellen- oder indizierte Ansicht enthält Statistiken, die für Indizes, einzelspaltige Statistiken erstellt wurden, die mit der AUTO_CREATE_STATISTICS Option und statistiken erstellt wurden, die mit der CREATE STATISTICS-Anweisung erstellt wurden.

Hinweise

Wenn der angegebene Index deaktiviert ist oder die angegebene Tabelle einen deaktivierten gruppierten Index enthält, wird eine Fehlermeldung angezeigt.

AUTO_UPDATE_STATISTICS ist immer AUS für speicheroptimierte Tabellen.

Berechtigungen

Um die AUTO_UPDATE_STATISTICS Option zu ändern, benötigen Sie eine Mitgliedschaft in der db_owner festen Datenbankrolle oder ALTER die Berechtigung für @tblname.

Um die AUTO_UPDATE_STATISTICS Option anzuzeigen, benötigen Sie eine Mitgliedschaft in der öffentlichen Rolle.

Beispiele

A. Anzeigen des Status aller Statistiken für eine Tabelle

Das folgende Beispiel zeigt den Status aller Statistiken für die Production.Product-Tabelle an.

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

B. Aktivieren von AUTO_UPDATE_STATISTICS für alle Statistiken zu einer Tabelle

Im folgenden Beispiel wird die AUTO_UPDATE_STATISTICS Option für alle Statistiken in der Production.Product Tabelle aktiviert.

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

C. Deaktivieren von AUTO_UPDATE_STATISTICS für einen bestimmten Index

Im folgenden Beispiel wird die AUTO_UPDATE_STATISTICS Option für den AK_Product_Name Index in der Production.Product Tabelle deaktiviert.

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

Zugehöriger Inhalt