sp_autostats (Transact-SQL)

Affiche ou modifie le paramètre automatique UPDATE STATISTICS d'un index et d'une statistique spécifiques ou de tous les index et statistiques d'une table ou d'une vue indexée spécifiée dans la base de données actuelle.

Remarque :
Dans le contexte de cette procédure stockée, le terme index fait référence aux statistiques de la table ou de la vue.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_autostats [ @tblname = ] 'table_name' 
    [ , [ @flagc = ] 'stats_flag' ] 
    [ , [ @indname = ] 'index_name' ]

Arguments

[ @tblname= ] 'table_name'

Nom de la table ou de la vue pour laquelle afficher le paramètre automatique UPDATE STATISTICS. table_name est de type nvarchar(776), sans valeur par défaut. Si la valeur de index_name est fournie, SQL Server 2005 modifie le paramètre automatique UPDATE STATISTICS pour cet index.

[ @flagc= ] 'stats_flag'

Spécifie le paramètre automatique UPDATE STATISTICS de la table, de la vue ou de l'index :

ON = activé

OFF = désactivé

L'argument stats_flag est de type varchar(10), avec NULL comme valeur par défaut.

[ @indname= ] 'index_name'

Nom de l'index dont le paramètre automatique UPDATE STATISTICS doit être activé ou désactivé. index_name est de type sysname, avec la valeur NULL par défaut.

Valeurs des codes de retour

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

Notes

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

Autorisations

La modification du paramètre automatique UPDATE STATISTICS nécessite l'adhésion au rôle de base de données fixe db_owner ou l'autorisation de modification (ALTER) sur table_name. L'affichage du paramètre automatique UPDATE STATISTICS nécessite l'adhésion au rôle public.

Ensembles de résultats

Si la valeur de stats_flag est définie, cette procédure indique l'action qui a été exécutée, mais ne renvoie pas un ensemble de résultats.

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

Exemples

A. Affichage de l'état actuel de tous les index d'une table

L'exemple suivant affiche l'état statistique actuel de tous les index de la table Product.

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

B. Activation des statistiques automatiques de tous les index d'une table

L'exemple suivant active le paramètre des statistiques automatiques de tous les index de la table Product.

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

C. Désactivation des statistiques automatiques d'un index

L'exemple suivant désactive le paramètre des statistiques automatiques de l'index AK_Product_Name de la table Product.

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

Voir aussi

Référence

Procédures stockées du moteur de base de données (Transact-SQL)
ALTER DATABASE (Transact-SQL)
CREATE INDEX (Transact-SQL)
CREATE STATISTICS (Transact-SQL)
DBCC SHOW_STATISTICS (Transact-SQL)
DROP STATISTICS (Transact-SQL)
sp_createstats (Transact-SQL)
Procédures stockées système (Transact-SQL)
UPDATE STATISTICS (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005