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.
.gif "Icône Lien de rubrique")
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. |
Voir aussi