sys.stats (Transact-SQL)

S’applique à : SQL Server (toutes les versions prises en charge) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Contient une ligne pour chaque objet de statistiques qui existe pour les tables, les index et les vues indexées dans la base de données dans SQL Server. Chaque index aura une ligne de statistiques correspondante avec le même nom et le même ID (index_id = stats_id), mais toutes les lignes de statistiques n’ont pas d’index correspondant.

La vue catalogue sys.stats_columns fournit des informations statistiques pour chaque colonne de la base de données. Pour plus d’informations sur les statistiques, consultez Statistiques.

Nom de la colonne Type de données Description
object_id int ID de l'objet auquel ces statistiques appartiennent.
name sysname Nom des statistiques. Unique dans l'objet.
stats_id int ID des statistiques. Unique dans l'objet.

Si les statistiques correspondent à un index, la valeur stats_id est identique à la valeur index_id dans la vue catalogue sys.indexes .
auto_created bit Indique si les statistiques ont été créées automatiquement par SQL Server.

0 = Les statistiques n’ont pas été créées automatiquement par SQL Server.

1 = Les statistiques ont été créées automatiquement par SQL Server.
user_created bit Indique si les statistiques ont été créées par un utilisateur.

0 = Les statistiques n'ont pas été créées par un utilisateur.

1 = Les statistiques ont été créées par un utilisateur.
no_recompute bit Indique si les statistiques ont été créées avec l’option NORECOMPUTE .

0 = Les statistiques n’ont pas été créées avec l’option NORECOMPUTE .

1 = Les statistiques ont été créées avec l’option NORECOMPUTE .
has_filter bit 0 = Les statistiques n'ont pas de filtre et sont calculées sur toutes les lignes.

1 = Les statistiques ont un filtre et sont calculées uniquement sur les lignes qui satisfont la définition de filtre.
filter_definition nvarchar(max) Expression pour le sous-ensemble de lignes inclus dans les statistiques filtrées.

NULL = Statistiques non filtrées.
is_temporary bit Indique si les statistiques sont temporaires. Les statistiques temporaires prennent en charge les bases de données secondaires des groupes de disponibilité Always On qui sont activées pour l’accès en lecture seule.

0 = Les statistiques ne sont pas temporaires.

1 = Les statistiques sont temporaires.

S’applique à : SQL Server (à compter de SQL Server 2012 (11.x))
is_incremental bit Indiquez si les statistiques sont créées comme statistiques incrémentielles.

0 = Les statistiques ne sont pas incrémentielles.

1 = Les statistiques sont incrémentielles.

S’applique à : SQL Server (à compter de SQL Server 2014 (12.x))
has_persisted_sample bit Indique si les statistiques ont été créées ou mises à jour avec l’option PERSIST_SAMPLE_PERCENT.

0 = Les statistiques ne conservent pas le pourcentage d’échantillon.

1 = Les statistiques ont été créées ou mises à jour avec l’option PERSIST_SAMPLE_PERCENT.

S’applique à : SQL Server (à compter de SQL Server 2019 (15.x))
stats_generation_method int Indique la méthode par laquelle les statistiques sont créées.

0 = Trier les statistiques basées sur le tri

1 = Utilisation interne uniquement

S’applique à : SQL Server (à compter de SQL Server 2019 (15.x))
stats_generation_method_desc varchar(255) Description textuelle de la méthode de création des statistiques.

Trier les statistiques basées sur le tri

À usage interne uniquement

S’applique à : SQL Server (à compter de SQL Server 2019 (15.x))
auto_drop bit Indique si la fonctionnalité de suppression automatique est activée pour cet objet de statistiques. La propriété AUTO_DROP permet de créer des objets de statistiques de sorte qu’une modification ultérieure de schéma ne soit pas bloquée par l’objet de statistiques mais qu’au lieu de cela, ces dernières soient supprimées si nécessaire. De cette façon, les statistiques créées manuellement avec AUTO_DROP activé se comportent comme des statistiques créées automatiquement. Pour plus d’informations, consultez Option AUTO_DROP.

S’applique à : Azure SQL Database, Azure SQL Managed Instance et à compter de SQL Server 2022 (16.x).

Autorisations

La visibilité des métadonnées dans les affichages catalogue est limitée aux éléments sécurisables qu'un utilisateur détient ou pour lesquels des autorisations lui ont été accordées. Pour plus d'informations, consultez Metadata Visibility Configuration.

Exemples

Les exemples suivants retournent toutes les statistiques et les colonnes de statistiques de la HumanResources.Employee table.

USE AdventureWorks2019;
GO
SELECT s.name AS statistics_name
      ,c.name AS column_name
      ,sc.stats_column_id
FROM sys.stats AS s
INNER JOIN sys.stats_columns AS sc
    ON s.object_id = sc.object_id AND s.stats_id = sc.stats_id
INNER JOIN sys.columns AS c
    ON sc.object_id = c.object_id AND c.column_id = sc.column_id
WHERE s.object_id = OBJECT_ID('HumanResources.Employee');

Voir aussi

Étapes suivantes