STATS_DATE (Transact-SQL)

Retourne la date de la mise à jour la plus récente des statistiques pour une table ou vue indexée.

Pour plus d'informations sur la mise à jour des statistiques, consultez Utilisation des statistiques pour améliorer les performances des requêtes.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

STATS_DATE ( object_id , stats_id )

Arguments

  • object_id
    ID de la table ou vue indexée avec les statistiques.

  • stats_id
    ID de l'objet de statistiques.

Types de retour

Retourne datetime en cas de réussite. Retourne NULL en cas d'erreur.

Notes

Les fonctions système peuvent être utilisées dans la liste de sélection, dans la clause WHERE et partout où une expression peut être utilisée.

Autorisations

Requiert l'appartenance au rôle de base de données fixe db_owner ou l'autorisation d'afficher les métadonnées pour la table ou vue indexée. Pour plus d'informations, consultez Dépannage de la visibilité des métadonnées.

Exemples

A. Retourner les dates des statistiques les plus récentes pour une table

L'exemple suivant retourne la date de la mise à jour la plus récente de chaque objet de statistiques dans la table Person.Address.

USE AdventureWorks;
GO
SELECT name AS stats_name, 
    STATS_DATE(object_id, stats_id) AS statistics_update_date
FROM sys.stats 
WHERE object_id = OBJECT_ID('Person.Address');
GO

Si les statistiques correspondent à un index, la valeur stats_id dans l'affichage catalogue sys.stats est identique à la valeur index_id dans l'affichage catalogue sys.indexes ; par ailleurs, la requête suivante retourne les mêmes résultats que la requête précédente. Si les statistiques ne correspondent pas à un index, elles figurent dans les résultats sys.stats mais pas dans les résultats sys.indexes.

USE AdventureWorks;
GO
SELECT name AS index_name, 
    STATS_DATE(object_id, index_id) AS statistics_update_date
FROM sys.indexes 
WHERE object_id = OBJECT_ID('Person.Address');
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.