sp_autostats (Transact-SQL)

Syntaxe

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

Arguments

• [ @tblname= ] 'table_or_indexed_view_name'
  Nom de la table ou vue indexée pour laquelle afficher l'option AUTO_UPDATE_STATISTICS. table_or_indexed_view_name est de type nvarchar(776), sans valeur par défaut.

• [ @flagc= ] 'stats_value'
  Met à jour l'option AUTO_UPDATE_STATISTICS à partir de l'une de ces valeurs :

  ON = ON

  OFF = OFF

  Lorsque stats_flag n'est pas spécifié, le paramètre AUTO_UPDATE_STATISTICS actuel est affiché. stats_value est de type varchar(10), avec NULL comme valeur par défaut.

• [ @indname= ] 'statistics_name'
  Nom des statistiques pour lesquels afficher ou mettre à jour l'option AUTO_UPDATE_STATISTICS. Pour afficher les statistiques d'un index, vous pouvez utiliser le nom de l'index ; un index et son objet de statistiques correspondant portent le même nom.

  statistics_name est de type sysname, avec NULL comme valeur par défaut.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Si la valeur de stats_flag est spécifiée, sp_autostats indique l'action qui a été exécutée, mais ne retourne pas de jeu de résultats.

Si la valeur de stats_flag n'est pas définie, sp_autostats renvoie le jeu de résultats suivant.

Le jeu de résultats d'une table ou vue indexée comprend les statistiques créées pour les index, les statistiques de colonnes uniques générées à l'aide de l'option AUTO_CREATE_STATISTICS, ainsi que les statistiques créées avec l'instruction CREATE STATISTICS.

Notes

Si l'index spécifié est désactivé ou si la table spécifiée a un index cluster désactivé, un message d'erreur s'affiche.

Autorisations

La modification de l'option AUTO_UPDATE_STATISTICS requiert l'appartenance au rôle de base de données fixe db_owner ou l'autorisation ALTER sur table_name. L'affichage de l'option AUTO_UPDATE_STATISTICS requiert l'appartenance au rôle public.

Exemples

A. Afficher l'état de toutes les statistiques d'une table

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

B. Activer AUTO_UPDATE_STATISTICS pour toutes les statistiques d'une table

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

C. Désactiver AUTO_UPDATE_STATISTICS pour un index spécifique

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

Voir aussi

Référence

Concepts