sp_autostats (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Affiche ou modifie l’option de mise à jour automatique des statistiques, pour AUTO_UPDATE_STATISTICSun 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