Partager via


sp_autostats (Transact-SQL)

Affiche ou modifie l'option de mise à jour automatique des statistiques, AUTO_UPDATE_STATISTICS, pour un index, un objet de statistiques, une table ou une vue indexée.

Pour plus d'informations sur l'option AUTO_UPDATE_STATISTICS, consultez Options SET de ALTER DATABASE (Transact-SQL) et Utilisation des statistiques pour améliorer les performances des requêtes.

Icône Lien de rubriqueConventions de syntaxe 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 (réussite) 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 spécifiée, sp_autostats retourne le jeu de résultats suivant.

Nom de colonne

Type de données

Description

Index Name

varchar(60)

Nom de l'index ou des statistiques.

AUTOSTATS

varchar(3)

Valeur actuelle de l'option AUTO_UPDATE_STATISTICS.

Last Updated

datetime

Date de la mise à jour des statistiques la plus récente.

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

L'exemple suivant affiche l'état de toutes les statistiques de la table Product.

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

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

L'exemple suivant active l'option AUTO_UPDATE_STATISTICS pour toutes les statistiques de la table Product.

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

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

L'exemple suivant désactive l'option AUTO_UPDATE_STATISTICS pour l'index AK_Product_Name de la table Product.

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

Historique des modifications

Mise à jour du contenu

Révisions apportées au document pour en améliorer la précision.

Cette rubrique fait référence au nouveau contenu sur les statistiques dans la rubrique Utilisation des statistiques pour améliorer les performances des requêtes.