Partager via

  • Article

COUNT (Transact-SQL)

Retourne le nombre d'éléments dans un groupe. COUNT fonctionne comme la fonction COUNT_BIG. Ces deux fonctions diffèrent uniquement au niveau des valeurs renvoyées : COUNT renvoie toujours une valeur de données de type int. COUNT_BIG renvoie toujours une valeur de données de type bigint. Cette fonction peut être suivie par la clause OVER.

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

Syntaxe

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

Arguments

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

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

  • expression
    Expression de tout type excepté text, image ou ntext. 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(*) ne requiert aucun paramètre et ne peut pas être utilisée avec la fonction DISTINCT. COUNT(*) ne nécessite pas de paramètre expression puisque, par définition, elle n'utilise les données d'aucune colonne en particulier. COUNT(*) calcule le nombre de lignes de la table spécifiée sans supprimer les doublons. Il compte chaque ligne séparément. Cela comprend les lignes qui contiennent des valeurs NULL.

Type des valeurs renvoyées

int

Notes

COUNT(*) renvoie le nombre d'éléments figurant dans un groupe. Cela inclut les valeurs NULL et les doublons.

COUNT(ALL expression) évalue l'argument expression pour chaque ligne d'un groupe et renvoie le nombre de valeurs non NULL.

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

Pour des valeurs renvoyées supérieures à 2^31-1, COUNT produit une erreur. Utilisez COUNT_BIG à la place.

Exemples

A. Utilisation de COUNT et DISTINCT

L'exemple suivant liste le nombre de titres différents qu'un employé qui travaille à Adventure Works Cycles peut porter.

USE AdventureWorks2008R2;
GO
SELECT COUNT(DISTINCT JobTitle)
FROM HumanResources.Employee;
GO

Voici l'ensemble des résultats.

-----------

67

(1 row(s) affected)

B. Utilisation de COUNT(*)

L'exemple suivant recherche le nombre total d'employés travaillant à Adventure Works Cycles.

USE AdventureWorks2008R2;
GO
SELECT COUNT(*)
FROM HumanResources.Employee;
GO

Voici l'ensemble des résultats.

-----------

290

(1 row(s) affected)

C. Utilisation de COUNT(*) avec d'autres fonctions d'agrégation

L'exemple suivant illustre l'utilisation simultanée de COUNT(*) et d'autres fonctions d'agrégation dans la liste de sélection.

USE AdventureWorks2008R2;
GO
SELECT COUNT(*), AVG(Bonus)
FROM Sales.SalesPerson
WHERE SalesQuota > 25000;
GO

Voici l'ensemble des résultats.

----------- ---------------------

14 3472.1428

(1 row(s) affected)