COUNT_BIG (Transact-SQL)

Article
10/16/2024

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric

Cette fonction retourne le nombre d’éléments figurant dans un groupe. COUNT_BIG est similaire à la fonction COUNT. Ces fonctions diffèrent uniquement par les types de données des valeurs qu’elles retournent. COUNT_BIG retourne toujours une valeur de type de données bigint. COUNT retourne toujours une valeur de type de données int.

Conventions de la syntaxe Transact-SQL

Syntaxe


-- Aggregation Function Syntax  
COUNT_BIG ( { [ [ ALL | DISTINCT ] expression ] | * } )  
  
-- Analytic Function Syntax  
COUNT_BIG ( [ ALL ] { expression | * } ) OVER ( [ <partition_by_clause> ] )

Arguments

ALL
Applique la fonction d'agrégation à toutes les valeurs. La valeur ALL est utilisée par défaut.

DISTINCT
Précise que la fonction COUNT_BIG doit renvoyer le nombre de valeurs non nulles uniques.

expression
Expression de tout type. COUNT_BIG ne prend pas en charge les fonctions d’agrégation ou sous-requêtes dans une expression.

*
Spécifie que COUNT_BIG doit compter toutes les lignes pour déterminer le nombre total de lignes de la table à retourner. COUNT_BIG(*) ne sélectionne aucun paramètre et ne prend pas en charge l’utilisation de DISTINCT. COUNT_BIG(*) ne nécessite pas de paramètre expression puisque, par définition, elle n’utilise les données d’aucune colonne en particulier. COUNT_BIG(*) retourne le nombre de lignes de la table spécifiée et conserve les doublons. Il compte chaque ligne, y compris les lignes qui contiennent des valeurs null.

OVER ( [ partition_by_clause ] [ order_by_clause ] )
partition_by_clause divise le jeu de résultats généré par la clause FROM en partitions auxquelles la fonction COUNT_BIG est appliquée. S'il n'est pas spécifié, la fonction gère toutes les lignes du jeu de résultats de la requête en un seul groupe. order_by_clause détermine l’ordre logique de l’opération. Pour plus d’informations, consultez Clause OVER (Transact-SQL).

Types de retour

bigint

Notes

COUNT_BIG(*) renvoie le nombre d'éléments figurant dans un groupe, y compris les valeurs NULL et les doublons.

COUNT_BIG(ALL expression) évalue l’argument expression pour chaque ligne d’un groupe et retourne le nombre de valeurs non-NULL.

COUNT_BIG (DISTINCT expression) évalue l’argument expression pour chaque ligne d’un groupe et retourne le nombre de valeurs non-NULL uniques.

COUNT_BIG est une fonction déterministe quand elle est utilisée sans les clauses OVER et ORDER BY. COUNT_BIG n’est pas déterministe quand elle est utilisée avec les clauses OVER et ORDER BY. Consultez Fonctions déterministes et non déterministes pour plus d’informations.

Exemples

Pour obtenir des exemples, consultez COUNT (Transact-SQL).

Voir aussi

Fonctions d'agrégation (Transact-SQL)
COUNT (Transact-SQL)
int, bigint, smallint et tinyint (Transact-SQL)
OVER Clause (Transact-SQL)

Partage via