sp_autostats (Transact-SQL)
S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance
Affiche ou modifie l’option de mise à jour automatique des statistiques, pour AUTO_UPDATE_STATISTICS
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 ALTER DATABASE SET (Transact-SQL) et Statistiques.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_autostats
[ @tblname = ] N'tblname'
[ , [ @flagc = ] 'flagc' ]
[ , [ @indname = ] N'indname' ]
[ ; ]
Arguments
[ @tblname = ] N’tblname'
Nom de la table ou de la vue indexée pour laquelle afficher l’option AUTO_UPDATE_STATISTICS
. @tblname est nvarchar(776), sans valeur par défaut.
[ @flagc = ] 'flagc'
Mises à jour ou affiche l’optionAUTO_UPDATE_STATISTICS
. @flagc est varchar(10) et peut être l’une des valeurs suivantes :
Valeur | Description |
---|---|
ON |
Il en va |
OFF |
Off |
Non spécifié(e) | Affiche le paramètre actuel AUTO_UPDATE_STATISTICS |
[ @indname = ] N’indname'
Nom des statistiques pour lesquelles afficher ou mettre à jour l’option AUTO_UPDATE_STATISTICS
. @indname est sysname, avec la valeur par défaut NULL
. 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.
Valeurs des codes de retour
0
(réussite) ou 1
(échec).
Jeu de résultats
Si @flagc est spécifié, sp_autostats
signale l’action qui a été effectuée, mais ne retourne aucun jeu de résultats.
Si @flagc n’est pas spécifié, sp_autostats
retourne le jeu de résultats suivant.
Nom de la colonne | Type de données | Description |
---|---|---|
Index Name |
sysname | 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 d’une vue indexée inclut des statistiques créées pour les index, des statistiques à colonne unique générées avec l’option AUTO_CREATE_STATISTICS
et 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.
AUTO_UPDATE_STATISTICS
est toujours désactivé pour les tables mémoire optimisées.
Autorisations
Pour modifier l’option AUTO_UPDATE_STATISTICS
, vous avez besoin d’appartenance au rôle de base de données fixe db_owner ou ALTER
d’une autorisation sur @tblname.
Pour afficher l’option AUTO_UPDATE_STATISTICS
, vous avez besoin d’appartenance au rôle public .
Exemples
R. Afficher l'état de toutes les statistiques d'une table
L'exemple suivant affiche l'état de toutes les statistiques de la table Production.Product
.
USE AdventureWorks2022;
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 Production.Product
table.
USE AdventureWorks2022;
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
de l’index AK_Product_Name
sur la Production.Product
table.
USE AdventureWorks2022;
GO
EXEC sp_autostats 'Production.Product', 'OFF', AK_Product_Name;
GO
Contenu connexe
- Statistiques
- Options ALTER DATABASE SET (Transact-SQL)
- Moteur de base de données procédures stockées (Transact-SQL)
- CREATE STATISTICS (Transact-SQL)
- DBCC SHOW_STATISTICS (Transact-SQL)
- DROP STATISTICS (Transact-SQL)
- sp_createstats (Transact-SQL)
- UPDATE STATISTICS (Transact-SQL)
- Procédures stockées système (Transact-SQL)
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour