sp_autostats (Transact-SQL)

Syntax

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

Argumente

• [ @tblname= ] 'table_or_indexed_view_name'
  Der Name der Tabelle oder indizierten Sicht, für die die AUTO_UPDATE_STATISTICS-Option angezeigt werden soll. table_or_indexed_view_name ist vom Datentyp nvarchar(776) und verfügt über keinen Standardwert.

• [ @flagc= ] 'stats_value'
  Aktualisiert die AUTO_UPDATE_STATISTICS-Option auf einen dieser Werte:

  ON = ON

  OFF = OFF

  Wenn stats_flag nicht angegeben wird, wird die aktuelle AUTO_UPDATE_STATISTICS-Einstellung angezeigt. stats_value entspricht varchar(10) und hat den Standardwert NULL.

• [ @indname= ] 'statistics_name'
  Der Name der Statistik, für die die AUTO_UPDATE_STATISTICS-Option angezeigt oder aktualisiert werden soll. Um die Statistik für einen Index anzuzeigen, können Sie den Namen des Index verwenden. Ein Index und das dazugehörige Statistikobjekt verfügen über den gleichen Namen.

  statistics_name ist vom Datentyp sysname und hat den Standardwert NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Wenn stats_flag angegeben ist, erstellt sp_autostats einen Bericht über die ausgeführte Aktion. Es wird jedoch kein Resultset zurückgegeben.

Wenn stats_flag nicht angegeben ist, gibt sp_autostats das folgende Resultset zurück.

Das Resultset für eine Tabelle oder indizierte Sicht umfasst Statistiken, die für Indizes, Statistiken für einzelne Spalten, die mit der AUTO_CREATE_STATISTICS-Option generiert wurden, und mit der CREATE STATISTICS-Anweisung generierte Statistiken erstellt wurden.

Hinweise

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

Berechtigungen

Zum Ändern der AUTO_UPDATE_STATISTICS-Option ist eine Mitgliedschaft in der festen Datenbankrolle db_owner oder eine ALTER-Berechtigung für table_name erforderlich. Zum Anzeigen der AUTO_UPDATE_STATISTICS-Option ist eine Mitgliedschaft in der public-Rolle erforderlich.

Beispiele

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

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

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

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

C. Deaktivieren von AUTO_UPDATE_STATISTICS für einen bestimmten Index

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

Änderungsverlauf

Siehe auch

Verweis

Konzepte