CREATE STATISTICS (Transact-SQL)
S’applique à : point de terminaison d’analytique SQL Azure SQL Database Azure SQL Database
Azure Synapse
Analytics
dans Microsoft Fabric Warehouse
Crée des statistiques d’optimisation de requête sur une ou plusieurs colonnes d’une table, d’une vue indexée ou d’une table externe. Pour la plupart des requêtes, l’optimiseur de requête génère déjà les statistiques nécessaires pour un plan de requête de haute qualité ; dans quelques cas, vous devez créer des statistiques supplémentaires avec CREATE STATISTICS
ou modifier la conception de requête pour améliorer les performances des requêtes.
Pour plus d’informations, consultez Statistiques.
Remarque
Pour plus d’informations sur les statistiques dans Microsoft Fabric, consultez Statistiques dans l’entreposage de données Fabric.
Conventions de la syntaxe Transact-SQL
Syntaxe
Syntaxe pour SQL Server, Azure SQL Database et Azure SQL Managed Instance.
-- Create statistics on an external table
CREATE STATISTICS statistics_name
ON { table_or_indexed_view_name } ( column [ , ...n ] )
[ WITH FULLSCAN ] ;
-- Create statistics on a regular table or indexed view
CREATE STATISTICS statistics_name
ON { table_or_indexed_view_name } ( column [ , ...n ] )
[ WHERE <filter_predicate> ]
[ WITH
[ FULLSCAN
[ [ , ] PERSIST_SAMPLE_PERCENT = { ON | OFF } ]
| SAMPLE number { PERCENT | ROWS }
[ [ , ] PERSIST_SAMPLE_PERCENT = { ON | OFF } ]
| <update_stats_stream_option> [ , ...n ]
[ [ , ] NORECOMPUTE ]
[ [ , ] INCREMENTAL = { ON | OFF } ]
[ [ , ] MAXDOP = max_degree_of_parallelism ]
[ [ , ] AUTO_DROP = { ON | OFF } ]
]
];
<filter_predicate> ::=
<conjunct> [ AND <conjunct> ]
<conjunct> ::=
<disjunct> | <comparison>
<disjunct> ::=
column_name IN (constant , ...)
<comparison> ::=
column_name <comparison_op> constant
<comparison_op> ::=
IS | IS NOT | = | <> | != | > | >= | !> | < | <= | !<
<update_stats_stream_option> ::=
[ STATS_STREAM = stats_stream ]
[ ROWCOUNT = numeric_constant ]
[ PAGECOUNT = numeric_contant ]
Syntaxe pour Azure Synapse Analytics and Analytics Platform System (PDW).
CREATE STATISTICS statistics_name
ON { database_name.schema_name.table_name | schema_name.table_name | table_name }
( column_name [ , ...n ] )
[ WHERE <filter_predicate> ]
[ WITH {
FULLSCAN
| SAMPLE number PERCENT
}
]
[ ; ]
<filter_predicate> ::=
<conjunct> [ AND <conjunct> ]
<conjunct> ::=
<disjunct> | <comparison>
<disjunct> ::=
column_name IN (constant , ...)
<comparison> ::=
column_name <comparison_op> constant
<comparison_op> ::=
IS | IS NOT | = | <> | != | > | >= | !> | < | <= | !<
Syntaxe de Microsoft Fabric.
CREATE STATISTICS statistics_name
ON { database_name.schema_name.table_name | schema_name.table_name | table_name }
( column_name )
[ WITH {
FULLSCAN
| SAMPLE number PERCENT
}
]
[ ; ]
Remarque
Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.
Arguments
statistics_name
Nom des statistiques à créer.
table_or_indexed_view_name
Nom de la table, de la vue indexée ou de la table externe sur laquelle créer les statistiques. Pour créer des statistiques sur une autre base de données, spécifiez un nom de table qualifié.
column [ ,...n]
Une ou plusieurs colonnes à inclure dans les statistiques. Les colonnes doivent être spécifiées par ordre de priorité de gauche à droite. Seule la première colonne est utilisée pour la création de l’histogramme. Toutes les colonnes sont utilisées pour les statistiques de corrélation entre les colonnes appelées densités.
Vous pouvez indiquer comme base de calcul des statistiques toute colonne pouvant être spécifiée en tant que colonne de clé d'index, sauf pour les exceptions suivantes :
Les colonnes xml, de texte intégral et FILESTREAM ne peuvent pas être spécifiées.
Les colonnes calculées ne peuvent être spécifiées que si les
ARITHABORT
paramètres de base de données sontQUOTED_IDENTIFIER
ON
.Toute colonne de type CLR définie par l'utilisateur peut être spécifiée si son type prend en charge l'ordre de tri binaire. Les colonnes calculées définies en tant qu'appels à des méthodes d'une colonne de type défini par l'utilisateur peuvent être précisées si les méthodes en question sont marquées comme étant déterministes.
WHERE <filter_predicate>
Spécifie une expression permettant de sélectionner un sous-ensemble des lignes à inclure lors de la création de l'objet de statistiques. Les statistiques créées avec un prédicat de filtre sont appelées des statistiques filtrées. Le prédicat de filtre utilise une logique de comparaison simple et ne peut pas référencer une colonne calculée, une colonne UDT, une colonne de type de données spatiales ou une colonne de type de données hierarchyID . Les comparaisons utilisant NULL
des littéraux ne sont pas autorisées avec les opérateurs de comparaison. L’utilisation des opérateurs IS NULL
et IS NOT NULL
est préférable.
Voici quelques exemples de prédicats de filtre pour la table Production.BillOfMaterials
:
WHERE StartDate > '20000101' AND EndDate <= '20000630'
WHERE ComponentID IN (533, 324, 753)
WHERE StartDate IN ('20000404', '20000905') AND EndDate IS NOT NULL
Pour plus d’informations sur les prédicats de filtre, consultez Créer des index filtrés.
FULLSCAN
S’applique à : SQL Server 2016 (13.x) SP 1 CU 4, SQL Server 2017 (14.x) CU 1 et versions ultérieures
Calcule les statistiques en analysant toutes les lignes. FULLSCAN
et SAMPLE 100 PERCENT
ont les mêmes résultats. FULLSCAN
ne peut pas être utilisé avec l’option SAMPLE
.
Si elle est omise, SQL Server utilise l’échantillonnage pour créer les statistiques, et détermine la taille d’échantillon nécessaire pour créer un plan de requête de haute qualité.
Dans Warehouse dans Microsoft Fabric, seules les statistiques à colonne FULLSCAN
unique et à colonne unique SAMPLE
sont prises en charge. Quand aucune option n’est incluse, SAMPLE
les statistiques sont créées.
SAMPLE number { PERCENT | ROWS }
Spécifie le pourcentage approximatif, ou le nombre de lignes, dans la table ou l’affichage indexé de l’optimiseur de requête à utiliser lorsqu’il crée des statistiques. Pour PERCENT
, le nombre peut être compris entre 0 et 100 et pour ROWS
, le nombre peut être compris entre 0 et le nombre total de lignes. Le pourcentage ou nombre de lignes réel échantillonné par l'optimiseur de requête peut ne pas correspondre au pourcentage ou nombre spécifié. Par exemple, l'optimiseur de requête analyse toutes les lignes d'une page de données.
SAMPLE
est utile pour les cas spéciaux dans lesquels le plan de requête, basé sur l’échantillonnage par défaut, n’est pas optimal. Dans la plupart des cas, il n’est pas nécessaire de spécifier SAMPLE
, car l’optimiseur de requête utilise déjà l’échantillonnage et détermine la taille d’échantillon statistiquement significative par défaut, comme nécessaire pour créer des plans de requête de haute qualité.
SAMPLE
ne peut pas être utilisé avec l’option FULLSCAN. Quand SAMPLE
ou FULLSCAN
n’est pas spécifié, l’optimiseur de requête utilise des données échantillonné et calcule par défaut la taille de l’échantillon.
Nous recommandons de ne pas spécifier 0 PERCENT
ou 0 ROWS
. Quand 0 PERCENT
ou 0 ROWS
est spécifié, l’objet de statistiques est créé, mais ne contient pas de données de statistiques.
Dans Warehouse dans Microsoft Fabric, seules les statistiques à colonne FULLSCAN
unique et à colonne unique SAMPLE
sont prises en charge. Quand aucune option n’est incluse, FULLSCAN
les statistiques sont créées.
PERSIST_SAMPLE_PERCENT = { ON | OFF }
Lorsque ON
, les statistiques conservent le pourcentage d’échantillonnage de création pour les mises à jour suivantes qui ne spécifient pas explicitement un pourcentage d’échantillonnage. Quand OFF
, le pourcentage d’échantillonnage des statistiques est réinitialisé à l’échantillonnage par défaut dans les mises à jour suivantes qui ne spécifient pas explicitement un pourcentage d’échantillonnage. Par défaut, il s’agit de OFF
.
Remarque
Si la table est tronquée, toutes les statistiques générées sur le HoBT tronqué sont rétablies à l’aide du pourcentage d’échantillonnage par défaut.
STATS_STREAM = flux_statistiques
Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
NORECOMPUTE
Désactivez l’option de mise à jour automatique des statistiques, AUTO_STATISTICS_UPDATE
pour statistics_name. Si cette option est spécifiée, l’optimiseur de requête effectue les mises à jour des statistiques en cours d’exécution pour statistics_name et désactive les mises à jour ultérieures.
Pour réactiver les mises à jour des statistiques, supprimez les statistiques avec DROP STATISTICS , puis exécutez CREATE STATISTICS
sans l’option NORECOMPUTE
.
Avertissement
Si vous désactivez la mise à jour automatique des statistiques, cela peut empêcher l’optimiseur de requête de choisir des plans d’exécution optimaux pour les requêtes qui impliquent la table. Vous devez utiliser cette option avec parcimonie et uniquement par un administrateur de base de données qualifié.
Pour plus d’informations sur l’option AUTO_STATISTICS_UPDATE
, consultez les options ALTER DATABASE SET. Pour plus d’informations sur la désactivation et la réactivation des mises à jour des statistiques, consultez Statistiques.
INCREMENTAL = { ON | OFF }
S’applique à : SQL Server 2014 (12.x) et ultérieur
Quand ON
, les statistiques créées sont par statistiques de partition. Quand OFF
, les statistiques sont combinées pour toutes les partitions. Par défaut, il s’agit de OFF
.
Si les statistiques par partition ne sont pas prises en charge, une erreur est générée. Les statistiques incrémentielles ne sont pas prises en charge pour les types de statistique suivants :
- Statistiques créées à partir d’index qui n’ont pas d’alignement de partition avec la table de base.
- statistiques créées sur les bases de données secondaires lisibles Always On ;
- statistiques créées sur les bases de données en lecture seule ;
- statistiques créées sur les index filtrés ;
- statistiques créées sur les vues ;
- statistiques créées sur les tables internes ;
- Statistiques créées avec les index spatiaux ou les index XML.
MAXDOP = max_degree_of_parallelism
S’applique à : SQL Server 2016 (13.x) SP 2, SQL Server 2017 (14.x) CU 3 et versions ultérieures
Remplace l’option de configuration max degree of parallelism pendant l’opération statistique. Pour plus d’informations, consultez Configurer le degré maximal de parallélisme (option de configuration de serveur). Permet MAXDOP
de limiter le nombre de processeurs utilisés dans une exécution de plan parallèle. Le nombre maximal de processeurs est égal à 64.
max_degree_of_parallelism peut avoir la valeur :
1
: supprime la génération de plan parallèle.>1
: limite le nombre maximal de processeurs utilisés dans une opération d’index parallèle au nombre spécifié.0
(par défaut) : utilise le nombre réel de processeurs ou moins en fonction de la charge de travail système actuelle.
update_stats_stream_option
Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
AUTO_DROP = { ON | OFF }
S’applique à : SQL Server 2022 (16.x) et versions ultérieures, et Azure SQL Database, Azure SQL Managed Instance
Avant SQL Server 2022 (16.x), si les statistiques sont créées manuellement par un utilisateur ou un outil tiers sur une base de données utilisateur, ces objets de statistiques peuvent bloquer ou interférer avec les modifications de schéma souhaitées par le client.
À compter de SQL Server 2022 (16.x), l’option AUTO_DROP
est activée par défaut sur toutes les bases de données nouvelles et migrées. La AUTO_DROP
propriété permet la création d’objets de statistiques dans un mode de sorte qu’une modification de schéma suivante n’est pas bloquée par l’objet statistique, mais que les statistiques sont supprimées si nécessaire. De cette façon, créez manuellement des statistiques avec activé, AUTO_DROP
comme les statistiques autocréées.
Remarque
Une tentative de définition ou de suppression de la propriété Auto_Drop sur les statistiques créées automatiquement peut générer des erreurs. Les statistiques créées automatiquement utilisent toujours la suppression automatique. Certaines sauvegardes, lors de la restauration, peuvent avoir cette propriété définie de manière incorrecte jusqu’à la prochaine mise à jour de l’objet de statistiques (manuellement ou automatiquement). Cependant, les statistiques créées automatiquement se comportent toujours comme des statistiques avec suppression automatique. Lors de la restauration d’une base de données vers SQL Server 2022 (16.x) à partir d’une version précédente, il est recommandé d’exécuter sp_updatestats
sur la base de données, en définissant les métadonnées appropriées pour la fonctionnalité de statistiques AUTO_DROP
.
Pour plus d’informations, consultez Option AUTO_DROP.
Autorisations
Nécessite l’une de ces autorisations :
ALTER TABLE
- L’utilisateur est le propriétaire de la table
- L’appartenance au rôle de base de données fixe db_ddladmin
Remarques
SQL Server peut utiliser tempdb
pour trier les lignes échantillonnées avant de générer des statistiques.
Statistiques pour les tables externes
Lors de la création de statistiques de table externe, SQL Server importe la table externe dans une table SQL Server temporaire, puis crée les statistiques. Pour les échantillons de statistiques, seules les lignes échantillonnées sont importées. Si vous avez une table externe volumineuse, il est plus rapide d’utiliser l’échantillonnage par défaut au lieu de l’option d’analyse complète.
Lorsque la table externe utilise DELIMITEDTEXT
, CSV
, PARQUET
ou DELTA
en tant que types de données, les tables externes prennent uniquement en charge les statistiques d’une colonne par commande CREATE STATISTICS
.
Statistiques avec une condition filtrée
Les statistiques filtrées peuvent améliorer les performances des requêtes qui effectuent des sélections dans des sous-ensembles bien définis de données. Elles utilisent un prédicat de filtre dans la clause WHERE pour sélectionner le sous-ensemble de données qui est inclus dans les statistiques.
Quand utiliser CREATE STATISTICS
Pour plus d’informations sur les cas où utiliser CREATE STATISTICS
, consultez Statistiques.
Référencer les dépendances pour les statistiques filtrées
La vue de catalogue sys.sql_expression_dependencies suit chaque colonne du prédicat de statistiques filtrées en tant que dépendance de référence. Tenez compte des opérations que vous effectuez sur les colonnes de table avant de créer des statistiques filtrées. Vous ne pouvez pas supprimer, renommer ou modifier la définition d’une colonne de table définie dans un prédicat de statistiques filtrés.
Limites
- La mise à jour des statistiques n’est pas prise en charge sur les tables externes. Pour mettre à jour des statistiques sur une table externe, supprimez et recréez les statistiques.
- Vous pouvez afficher jusqu’à 64 colonnes par objet de statistiques.
- L’option
MAXDOP
n’est pas compatible avecSTATS_STREAM
,ROWCOUNT
etPAGECOUNT
les options. - L’option
MAXDOP
est limitée par le paramètreMAX_DOP
du groupe de charge de travail de Resource Governor, s’il est utilisé. CREATE
etDROP STATISTICS
sur les tables externes ne sont pas prises en charge dans Azure SQL Database.
Exemples
Les exemples de code Transact-SQL de cet article sont fondés sur l’échantillon de base de données AdventureWorks2022
ou AdventureWorksDW2022
fourni, que vous pouvez télécharger à partir de la page d’accueil Échantillons et projets communautaires Microsoft SQL Server.
A. Utiliser CREATE STATISTICS avec SAMPLE nombre PERCENT
L’exemple suivant crée les statistiques ContactMail1
, à l’aide d’un exemple aléatoire de 5 % des colonnes BusinessEntityID
et EmailPromotion
de la table Person
de la base de données AdventureWorks2022.
CREATE STATISTICS ContactMail1
ON Person.Person (BusinessEntityID, EmailPromotion)
WITH SAMPLE 5 PERCENT;
B. Utiliser CREATE STATISTICS avec FULLSCAN et NORECOMPUTE
L'exemple suivant crée les statistiques NamePurchase
pour toutes les lignes des colonnes BusinessEntityID
et EmailPromotion
de la table Person
et désactive le recalcul automatique des statistiques.
CREATE STATISTICS NamePurchase
ON AdventureWorks2022.Person.Person (BusinessEntityID, EmailPromotion)
WITH FULLSCAN, NORECOMPUTE;
C. Utiliser CREATE STATISTICS pour créer des statistiques filtrées
L'exemple suivant crée les statistiques filtrées ContactPromotion1
. Le Moteur de base de données échantillonne 50 % des données, puis sélectionne toutes les lignes pour lesquelles EmailPromotion
est égal à 2.
CREATE STATISTICS ContactPromotion1
ON Person.Person (BusinessEntityID, LastName, EmailPromotion)
WHERE EmailPromotion = 2
WITH SAMPLE 50 PERCENT;
GO
D. Créer des statistiques sur une table externe
La seule décision que vous devez prendre quand vous créez des statistiques sur une table externe, en plus de fournir la liste des colonnes, est de savoir si vous allez créer les statistiques en échantillonnant les lignes ou en analysant toutes les lignes. CREATE
et DROP STATISTICS
sur les tables externes ne sont pas prises en charge dans Azure SQL Database.
Étant donné que SQL Server importe les données de la table externe vers une table temporaire pour créer les statistiques, l’option d’analyse complète prend beaucoup plus de temps. Pour une table volumineuse, la méthode d’échantillonnage par défaut est généralement suffisante.
--Create statistics on an external table and use default sampling.
CREATE STATISTICS CustomerStats1 ON DimCustomer (CustomerKey, EmailAddress);
--Create statistics on an external table and scan all the rows
CREATE STATISTICS CustomerStats1 ON DimCustomer (CustomerKey, EmailAddress) WITH FULLSCAN;
E. Utiliser CREATE STATISTICS avec FULLSCAN et PERSIST_SAMPLE_PERCENT
L’exemple suivant crée les NamePurchase
statistiques de toutes les lignes de la BusinessEntityID
Person
table et EmailPromotion
définit un pourcentage d’échantillonnage de 100 % pour toutes les mises à jour suivantes qui ne spécifient pas explicitement un pourcentage d’échantillonnage.
CREATE STATISTICS NamePurchase
ON AdventureWorks2022.Person.Person (BusinessEntityID, EmailPromotion)
WITH FULLSCAN, PERSIST_SAMPLE_PERCENT = ON;
Exemples avec la base de données AdventureWorksDW
F. Créer des statistiques sur deux colonnes
L’exemple suivant crée les statistiques CustomerStats1
, en fonction des colonnes CustomerKey
et EmailAddress
de la table DimCustomer
. Les statistiques sont créées d’après un échantillon statistiquement significatif des lignes dans la table Customer
.
CREATE STATISTICS CustomerStats1 ON DimCustomer (CustomerKey, EmailAddress);
G. Créer des statistiques à l’aide d’une analyse complète
L’exemple suivant crée les statistiques CustomerStatsFullScan
, en fonction de l’analyse de toutes les lignes dans la table DimCustomer
.
CREATE STATISTICS CustomerStatsFullScan
ON DimCustomer (CustomerKey, EmailAddress) WITH FULLSCAN;
H. Créer des statistiques en spécifiant le pourcentage d’échantillonnage
L’exemple suivant crée les statistiques CustomerStatsSampleScan
, en fonction de l’analyse de 50 pour cent des lignes dans la table DimCustomer
.
CREATE STATISTICS CustomerStatsSampleScan
ON DimCustomer (CustomerKey, EmailAddress) WITH SAMPLE 50 PERCENT;
I. Utiliser CREATE STATISTICS avec AUTO_DROP
Pour utiliser des statistiques avec suppression automatique, ajoutez simplement le code suivant à la clause « WITH » de la création ou de la mise à jour des statistiques.
CREATE STATISTICS CustomerStats1 ON DimCustomer (CustomerKey, EmailAddress) WITH AUTO_DROP = ON
Pour évaluer le paramètre de suppression automatique sur les statistiques existantes, utilisez la colonne auto_drop
de sys.stats :
SELECT object_id, [name], auto_drop
FROM sys.stats;