COUNTY (Transact-SQL)

S’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Point de terminaison d’analytique SQL dans Microsoft Fabric Entrepôt dans Microsoft Fabric Base de données SQL dans 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 de la fonction d’agrégation :

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

Syntaxe de la fonction analytique :

COUNT ( { [ ALL ] expression | * } ) OVER ( [ <partition_by_clause> ] )

Les arguments

Tous

Applique la fonction d'agrégation à toutes les valeurs. ALL sert de valeur par défaut.

DISTINCTIF

Spécifie que COUNT retourne le nombre de valeurs non null 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(*) ne prend aucun paramètre et ne prend pas en charge l’utilisation de DISTINCT. Le paramètre COUNT(*) n’est pas requis par 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, y compris les lignes qui contiennent des valeurs null.

TERMINÉ ( [ 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 la clause OVER.

Types de retour

Retourne int NOT NULL quand ANSI_WARNINGS est ON. Toutefois, SQL Server traite toujours les expressions comme étant int NULL dans les COUNT métadonnées, sauf si elles sont encapsuléesISNULL.
Retourne int NULL quand ANSI_WARNINGS est OFF.

Notes

COUNT(*) sans GROUP BY renvoyer la cardinalité (nombre de lignes) dans le jeu de résultats. Ce nombre inclut les lignes qui ont toutes les NULL valeurs et les doublons.

COUNT(*) avec GROUP BY retourne le nombre de lignes de chaque groupe. Ce nombre inclut des NULL valeurs et des doublons.

COUNT(ALL <expression>) évalue l’expression pour chaque ligne d’un groupe et retourne le nombre de valeurs non null.

COUNT(DISTINCT <expression>) évalue l’expression pour chaque ligne d’un groupe et retourne le nombre de valeurs uniques et non null.

Utilisation déterministe et non déterministe

COUNT_BIGest une fonction déterministe lorsqu’elle est utilisée sans les clauses et ORDER BY les OVER clauses.

COUNT_BIGn’est pas déterministe lorsqu’il est utilisé avec les clauses et ORDER BY les OVER clauses.

Utilisations `OVER` et `ORDER BY` clauses	Déterministe
Non	Oui
Oui	Non

Pour plus d’informations, consultez Fonctions déterministes et non déterministes.

ARITHABORT et ANSI_WARNINGS

Lorsque COUNT retourne une valeur qui dépasse la valeur maximale d’int (2^31-1 ou 2 147 483 647), la fonction échoue en raison d’un dépassement d’entier.
Si COUNT les dépassements de capacité et lesARITHABORT options sont ANSI_WARNINGSOFF, COUNT retourne NULL. Sinon, si l’unARITHABORT ou l’autre ANSI_WARNINGS est ON, la requête abandonne et déclenche l’erreur de dépassement arithmétique :
```
Msg 8115, Level 16, State 2; Arithmetic overflow error converting expression to data type int.
```
Pour gérer correctement ces résultats volumineux, utilisez COUNT_BIG à la place, qui retourne bigint.
Quand les deux et ANSI_WARNINGS les ONdeux ARITHABORT sont, vous pouvez inclure COUNT en toute sécurité des sites ISNULL( <count-expr>, 0) d’appel pour forcer le type de l’expression à int NOT NULL au lieu d’int NULL. COUNT ISNULL L’habillage signifie que toute erreur de dépassement de capacité est supprimée en mode silencieux, ce qui doit être considéré comme correct.

Exemples

Les exemples de code de cet article utilisent les bases de données d'exemple AdventureWorks2025 ou AdventureWorksDW2025, que vous pouvez télécharger à partir de la page d'accueil Microsoft SQL Server Samples and Community Projects.

R. Utilisation de COUNT et de DISTINCT

Cet exemple retourne le nombre de titres de travail différents dans la HumanResources.Employee table qu’un employé peut contenir.

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

Voici le jeu de résultats.

-----------
67

B. Utilisation de COUNT(*)

Cet exemple retourne le nombre total d’employés dans la HumanResources.Employee table.

SELECT COUNT(*)
FROM HumanResources.Employee;
GO

Voici le jeu de résultats.

-----------
290

Chapitre 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.

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

Voici le jeu de résultats.

------ ---------------------
14     3472.1428

D. Utiliser la clause OVER

Cet exemple utilise les fonctions , et AVGCOUNTMAXles MINfonctions avec la OVER clause pour retourner des valeurs agrégées pour chaque service de la HumanResources.Department table.

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

Voici le jeu de 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

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.

-----------
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.

-------------
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.

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.

DepartmentName  EmployeesInDept
--------------  ---------------
Sales           18
Production      179

Je. 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.

ProductCount   SalesOrderID
------------   -----------------
3              SO53115
1              SO55981

Rétroaction

Cette page a-t-elle été utile ?

Last updated on 2026-01-20

Partager via

COUNTY (Transact-SQL)

Syntaxe

Les arguments

Tous

DISTINCTIF

expression

*

TERMINÉ ( [ partition_by_clause ] [ order_by_clause ] [ ROW_or_RANGE_clause ] )

Types de retour

Notes

Utilisation déterministe et non déterministe

ARITHABORT et ANSI_WARNINGS

Exemples

R. Utilisation de COUNT et de DISTINCT

B. Utilisation de COUNT(*)

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

D. Utiliser la clause OVER

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

E. Utilisation de COUNT et de DISTINCT

F. Utilisation de COUNT(*)

G. Utilisation de COUNT(*) avec d’autres fonctions d’agrégation

H. Utilisation de COUNT avec HAVING

Je. Utilisation de COUNT avec OVER

Contenu connexe

Rétroaction

Ressources additionnelles