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 type de données int. COUNT_BIG retourne toujours une valeur de type de données bigint.
S'applique à : SQL Server (SQL Server 2008 jusqu'à la version actuelle), Base de données SQL Windows Azure (version initiale jusqu'à la version actuelle). |
.gif "Icône Lien de rubrique")
Conventions de la syntaxe Transact-SQL
Syntaxe
COUNT ( { [ [ ALL | DISTINCT ] expression ] | * } )
OVER ( [ partition_by_clause ] order_by_clause )
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 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 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 dans lequel l'opération est effectuée. order_by_clause est requis. Pour plus d'informations, consultez Clause OVER (Transact-SQL).
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.
COUNT est une fonction déterministe lorsqu'elle est utilisée sans les clauses OVER et ORDER BY. Elle n'est pas déterministe avec les clauses OVER et ORDER BY. Pour plus d'informations, consultez Fonctions déterministes et non déterministes.
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.
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.
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. L'exemple utilise la base de données AdventureWorks2012.
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 agrégées pour chaque service dans la table HumanResources.Department de la base de données AdventureWorks2012.
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)