COUNT (Transact-SQL)
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
fonctionne comme la fonction COUNT_BIG. Ces fonctions diffèrent uniquement par les types de données des valeurs qu’elles retournent. COUNT
retourne toujours une valeur de type de données int. COUNT_BIG
retourne toujours une valeur de type de données bigint.
Conventions de la syntaxe Transact-SQL
Syntaxe
Syntaxe des fonctions d’agrégation
COUNT ( { [ [ ALL | DISTINCT ] expression ] | * } )
Syntaxe des fonctions analytiques
COUNT ( [ 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
doit renvoyer le nombre de valeurs non nulles uniques.
expression
Expression de tout type, sauf image, ntext ou text. COUNT
ne prend pas en charge les fonctions d’agrégation ni les sous-requêtes dans une expression.
*
Spécifie que COUNT
doit compter toutes les lignes pour déterminer le nombre total de lignes de la table à retourner. COUNT(*)
n’accepte aucun paramètre et ne prend pas en charge DISTINCT. Le paramètre expression n’est pas requis par COUNT(*)
qui, par définition, n’utilise les données d’aucune colonne en particulier. COUNT(*)
retourne le nombre de lignes de la table spécifiée et conserve 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 ] [ ROW_or_RANGE_clause ] )
partition_by_clause divise le jeu de résultats généré par la clause FROM
en partitions auxquelles la fonction COUNT
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
int NOT NULL quand
ANSI_WARNINGS
estON
. Cependant, SQL Server traite toujours les expressionsCOUNT
commeint NULL
dans les métadonnées, sauf s’ils sont encapsulés dansISNULL
.int NULL quand
ANSI_WARNINGS
estOFF
.
Notes
COUNT(*)
sansGROUP BY
retourne la cardinalité (nombre de lignes) du jeu de résultats. Sont incluses les lignes composées de valeurs toutesNULL
et de doublons.COUNT(*)
avecGROUP BY
retourne le nombre de lignes de chaque groupe. Sont comprises les valeursNULL
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.
COUNT
est une fonction déterministe lorsqu'elle est utilisée sans les clauses OVER et ORDER BY. Elle n’est pas déterministe quand elle est utilisée avec les clauses OVER et ORDER BY. Pour plus d’informations, consultez Fonctions déterministes et non déterministes.
ARITHABORT
et ANSI_WARNINGS
Lorsque la valeur de retour de COUNT
dépasse la valeur maximale de int (c’est-à-dire 231-1 ou 2 147 483 647), la fonction COUNT
échoue en raison d’un dépassement de capacité d’entier. Lorsque les dépassements de capacité de COUNT
et les options ARITHABORT
etANSI_WARNINGS
sont OFF
, COUNT
retourne NULL
. Sinon, lorsque ARITHABORT
ouANSI_WARNINGS
sont ON
, la requête est abandonnée, et l’erreur de débordement arithmétique Msg 8115, Level 16, State 2; Arithmetic overflow error converting expression to data type int.
déclenchée. Pour gérer correctement ces résultats volumineux, utilisez plutôt COUNT_BIG
, qui retourne bigint.
Lorsque ARITHABORT
et ANSI_WARNINGS
sont ON
, vous pouvez sans risque encapsuler les sites d’appel de COUNT
dans ISNULL( <count-expr>, 0 )
pour forcer le type de l’expression int NOT NULL
au lieu de int NULL
. En cas d’encapsulation de COUNT
dans ISNULL
, toute erreur de dépassement de capacité est supprimée en mode silencieux, ce qui doit être pris en compte pour l’exactitude.
Exemples
R. Utilisation de COUNT et de DISTINCT
Cet exemple retourne le nombre de titres différents qu’un employé Adventure Works Cycles peut porter.
SELECT COUNT(DISTINCT Title)
FROM HumanResources.Employee;
GO
Voici le jeu de résultats obtenu.
-----------
67
(1 row(s) affected)
B. Utilisation de COUNT(*)
Cet exemple retourne le nombre total d’employés Adventure Works Cycles.
SELECT COUNT(*)
FROM HumanResources.Employee;
GO
Voici le jeu de résultats obtenu.
-----------
290
(1 row(s) affected)
C. Utilisation de COUNT(*) avec d’autres fonctions d’agrégation
Cet exemple montre que COUNT(*)
fonctionne avec d’autres fonctions d’agrégation dans la liste SELECT
. L’exemple utilise la base de données AdventureWorks2022.
SELECT COUNT(*), AVG(Bonus)
FROM Sales.SalesPerson
WHERE SalesQuota > 25000;
GO
Voici le jeu de résultats obtenu.
----------- ---------------------
14 3472.1428
(1 row(s) affected)
D. Utiliser la clause OVER
Cet exemple utilise les fonctions MIN
, MAX
, AVG
et COUNT
avec la clause OVER
afin de retourner des valeurs agrégées pour chaque département dans la table HumanResources.Department
de la base de données AdventureWorks2022.
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 le jeu de résultats obtenu.
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)
Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)
E. Utilisation de COUNT et de DISTINCT
Cet exemple retourne le nombre de titres différents qu’un employé d’une société spécifique peut porter.
USE ssawPDW;
SELECT COUNT(DISTINCT Title)
FROM dbo.DimEmployee;
Voici le jeu de résultats obtenu.
-----------
67
F. Utilisation de COUNT(*)
Cet exemple renvoie le nombre total de lignes dans la table dbo.DimEmployee
.
USE ssawPDW;
SELECT COUNT(*)
FROM dbo.DimEmployee;
Voici le jeu de résultats obtenu.
-------------
296
G. Utilisation de COUNT(*) avec d’autres fonctions d’agrégation
Cet exemple associe COUNT(*)
et d’autres fonctions d’agrégation dans la liste SELECT
. Il renvoie le nombre de représentants commerciaux avec un quota de ventes annuel supérieur à 500 000 $ et le quota de ventes moyen.
USE ssawPDW;
SELECT COUNT(EmployeeKey) AS TotalCount, AVG(SalesAmountQuota) AS [Average Sales Quota]
FROM dbo.FactSalesQuota
WHERE SalesAmountQuota > 500000 AND CalendarYear = 2001;
Voici le jeu de résultats obtenu.
TotalCount Average Sales Quota
---------- -------------------
10 683800.0000
H. Utilisation de COUNT avec HAVING
Cet exemple utilise COUNT
avec la clause HAVING
pour retourner les services d’une société, chacun d’eux employant plus de 15 personnes.
USE ssawPDW;
SELECT DepartmentName,
COUNT(EmployeeKey)AS EmployeesInDept
FROM dbo.DimEmployee
GROUP BY DepartmentName
HAVING COUNT(EmployeeKey) > 15;
Voici le jeu de résultats obtenu.
DepartmentName EmployeesInDept
-------------- ---------------
Sales 18
Production 179
I. Utilisation de COUNT avec OVER
Cet exemple suivant utilise COUNT
avec la clause OVER
pour renvoyer le nombre de produits contenus dans chacune des commandes client spécifiées.
USE ssawPDW;
SELECT DISTINCT COUNT(ProductKey) OVER(PARTITION BY SalesOrderNumber) AS ProductCount
, SalesOrderNumber
FROM dbo.FactInternetSales
WHERE SalesOrderNumber IN (N'SO53115',N'SO55981');
Voici le jeu de résultats obtenu.
ProductCount SalesOrderID
------------ -----------------
3 SO53115
1 SO55981