COUNT_BIG (Transact-SQL)

Renvoie le nombre d'éléments figurant dans un groupe. COUNT_BIG est similaire à la fonction COUNT. Elles diffèrent uniquement au niveau des valeurs renvoyées : COUNT_BIG renvoie toujours une valeur de type bigint. COUNT renvoie toujours une valeur de type int. Cette fonction peut être suivie par la Clause OVER (Transact-SQL).

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

COUNT_BIG ( { [ ALL | DISTINCT ] expression } | * ) 

Arguments

  • ALL
    Applique la fonction d'agrégation à toutes les valeurs. ALL est l'argument par défaut.

  • DISTINCT
    Spécifie que la fonction COUNT_BIG doit renvoyer le nombre de valeurs non NULL uniques.

  • expression
    Expression de tout type. Les fonctions d'agrégation et les sous-requêtes ne sont pas autorisées.

  • *
    Spécifie que toutes les lignes doivent être comptées pour renvoyer le nombre total de lignes de la table. La fonction COUNT_BIG(*) ne requiert aucun paramètre et ne peut pas s'utiliser avec la fonction DISTINCT. COUNT_BIG(*) ne nécessite pas de paramètre expression puisque, par définition, il n'utilise les données d'aucune colonne en particulier. COUNT_BIG(*) renvoie le nombre de lignes de la table spécifiée sans supprimer les doublons. Il compte chaque ligne séparément, y compris les lignes qui contiennent des valeurs NULL.

Types renvoyés

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 renvoie le nombre de valeurs non NULL.

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