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 retourne toujours une valeur de données de type int. COUNT_BIG retourne toujours une valeur de données de type bigint. Cette fonction peut être suivie par la clause OVER.

Icône Lien de rubrique Conventions de la syntaxe 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.

Types de retour

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 AdventureWorks2012;
GO
SELECT COUNT(DISTINCT Title)
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 AdventureWorks2012;
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 AdventureWorks2012;
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)

C.Utilisation de la clause OVER

L'exemple suivant utilise les fonctions MIN, MAX, AVG et COUNT avec la clause OVER pour fournir des valeurs de synthèse pour chaque service dans la table HumanResources.Department.

USE AdventureWorks2012; 
GO
SELECT DISTINCT Name
       , MIN(Rate) OVER (PARTITION BY edh.DepartmentID) AS MinSalary
       , MAX(Rate) OVER (PARTITION BY edh.DepartmentID) AS MaxSalary
       , AVG(Rate) OVER (PARTITION BY edh.DepartmentID) AS AvgSalary
       ,COUNT(edh.BusinessEntityID) OVER (PARTITION BY edh.DepartmentID) AS EmployeesPerDept
FROM HumanResources.EmployeePayHistory AS eph
JOIN HumanResources.EmployeeDepartmentHistory AS edh
     ON eph.BusinessEntityID = edh.BusinessEntityID
JOIN HumanResources.Department AS d
 ON d.DepartmentID = edh.DepartmentID
WHERE edh.EndDate IS NULL
ORDER BY Name;

Voici l'ensemble des résultats.

Name                          MinSalary             MaxSalary             AvgSalary             EmployeesPerDept
----------------------------- --------------------- --------------------- --------------------- ----------------
Document Control              10.25                 17.7885               14.3884               5
Engineering                   32.6923               63.4615               40.1442               6
Executive                     39.06                 125.50                68.3034               4
Facilities and Maintenance    9.25                  24.0385               13.0316               7
Finance                       13.4615               43.2692               23.935                10
Human Resources               13.9423               27.1394               18.0248               6
Information Services          27.4038               50.4808               34.1586               10
Marketing                     13.4615               37.50                 18.4318               11
Production                    6.50                  84.1346               13.5537               195
Production Control            8.62                  24.5192               16.7746               8
Purchasing                    9.86                  30.00                 18.0202               14
Quality Assurance             10.5769               28.8462               15.4647               6
Research and Development      40.8654               50.4808               43.6731               4
Sales                         23.0769               72.1154               29.9719               18
Shipping and Receiving        9.00                  19.2308               10.8718               6
Tool Design                   8.62                  29.8462               23.5054               6

 (16 row(s) affected)

Voir aussi

Référence

Fonctions d'agrégation (Transact-SQL)

COUNT_BIG (Transact-SQL)

Clause OVER (Transact-SQL)