COUNT (Transact-SQL)
Gilt für: 
SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL Analytics-Endpunkt in Microsoft Fabric Warehouse in Microsoft Fabric
Diese Funktion gibt die Anzahl der in einer Gruppe gefundenen Elemente zurück. COUNT arbeitet wie die COUNT_BIG-Funktion. Diese Funktionen unterscheiden sich nur in den Datentypen ihrer Rückgabewerte. COUNT gibt immer einen Wert vom Datentyp int zurück. COUNT_BIG gibt immer einen Wert vom Datentyp bigint zurück.
Transact-SQL-Syntaxkonventionen
Syntax
Syntax der Aggregationsfunktion
COUNT ( { [ [ ALL | DISTINCT ] expression ] | * } )
Syntax der Analysefunktion
COUNT ( [ ALL ] { expression | * } ) OVER ( [ <partition_by_clause> ] )
Argumente
ALL
Wendet die Aggregatfunktion auf alle Werte an. ALL dient als Standardeinstellung.
DISTINCT
Gibt an, dass COUNT die Anzahl der eindeutigen Werte zurückgibt, die nicht NULL sind.
expression
Eine expression beliebigen Typs mit Ausnahme von image, ntext oder text. COUNT unterstützt keine Aggregatfunktionen oder Unterabfragen in einem Ausdruck.
*
Gibt an, dass COUNT alle Zeilen zählen soll, um die Gesamtzahl der zurückzugebenden Tabellenzeilen zu bestimmen. COUNT(*) nimmt keine Parameter an und unterstützt die Verwendung von DISTINCT nicht. COUNT(*) erfordert keinen expression-Parameter, da definitionsgemäß keine Informationen zu einer bestimmten Spalte verwendet werden. COUNT(*) gibt die Anzahl der Zeilen in einer angegebenen Tabelle zurück. Duplikate werden beibehalten. Dabei werden alle Zeilen einzeln gezählt. Dies schließt Zeilen mit NULL-Werten ein.
OVER ( [ partition_by_clause ] [ order_by_clause ] [ ROW_or_RANGE_clause ] )
Das Argument partition_by_clause unterteilt das von der FROM-Klausel erzeugte Resultset in Partitionen, auf die die COUNT-Funktion angewendet wird. Wird dies nicht angegeben, verarbeitet die Funktion alle Zeilen des Abfrageresultsets als einzelne Gruppe. order_by_clause bestimmt die logische Reihenfolge, in der der Vorgang ausgeführt wird. Weitere Informationen finden Sie unter OVER-Klausel (Transact-SQL).
Rückgabetypen
int NOT NULL, wenn
ANSI_WARNINGSONist, SQL Server behandeltCOUNT-Ausdrücke in Metadaten jedoch immer wieint NULL, sofern sie nicht inISNULLumschlossen werden.int NULL, wenn
ANSI_WARNINGSOFFist.
Bemerkungen
COUNT(*)ohneGROUP BYgibt die Kardinalität (Anzahl der Zeilen) im Resultset zurück. Dies schließt Zeilen ein, die aus ausschließlichenNULL-Werten und Duplikaten bestehen.COUNT(*)mitGROUP BYgibt die Anzahl der Zeilen in jeder Gruppe zurück. Dies schließtNULL-Werte und Duplikate ein.COUNT(ALL <expression>)wertet expression für jede Zeile in einer Gruppe aus und gibt die Anzahl der Werte zurück, die nicht NULL sind.COUNT(DISTINCT *expression*)wertet expression für jede Zeile in einer Gruppe aus und gibt die Anzahl eindeutiger Werte zurück, die nicht NULL sind.
COUNT ist eine deterministische Funktion, wenn sie ohne die OVER- und ORDER BY-Klauseln verwendet wird. Sie ist nicht deterministisch, wenn sie mit den OVER- und ORDER BY-Klauseln verwendet wird. Weitere Informationen finden Sie unter Deterministische und nicht deterministische Funktionen.
ARITHABORT und ANSI_WARNINGS
Wenn der Rückgabewert von COUNT den maximalen Wert von int überschreitet (d. h. 231-1 oder 2.147.483.647), tritt bei der COUNT-Funktion aufgrund eines Ganzzahlüberlaufs ein Fehler auf. Wenn COUNT überläuft und die Optionen ARITHABORT und ANSI_WARNINGSbeideOFF sind, gibt COUNTNULL zurück. Wenn andernfalls eines von ARITHABORT oder ANSI_WARNINGSON ist, wird die Abfrage abgebrochen und der arithmetische Überlauffehler Msg 8115, Level 16, State 2; Arithmetic overflow error converting expression to data type int. ausgelöst. Um diese großen Ergebnisse ordnungsgemäß zu behandeln, verwenden Sie stattdessen COUNT_BIG, was bigint zurückgibt.
Wenn sowohl ARITHABORT als auch ANSI_WARNINGSON ist, können Sie COUNT-Aufrufsites sicher in ISNULL( <count-expr>, 0 ) umschließen, um den Typ des Ausdrucks in int NOT NULL anstelle von int NULL umzuwandeln. Das Umschließen von COUNT in ISNULL bedeutet, dass alle Überlauffehler automatisch unterdrückt werden, was der Richtigkeit willen berücksichtigt werden sollte.
Beispiele
A. Verwenden von COUNT und DISTINCT
Dieses Beispiel gibt die Anzahl der verschiedenen Positionen zurück, die ein Adventure Works Cycles-Mitarbeiter innehaben kann.
SELECT COUNT(DISTINCT Title)
FROM HumanResources.Employee;
GO
Hier sehen Sie das Ergebnis.
-----------
67
(1 row(s) affected)
B. Verwenden von COUNT(*)
Dieses Beispiel gibt die Gesamtzahl der Adventure Works Cycles-Mitarbeiter zurück.
SELECT COUNT(*)
FROM HumanResources.Employee;
GO
Hier sehen Sie das Ergebnis.
-----------
290
(1 row(s) affected)
C. Verwenden von COUNT(*) mit weiteren Aggregaten
Dieses Beispiel zeigt, dass COUNT(*) mit anderen Aggregatfunktionen in der SELECT-Liste funktioniert. Im Beispiel wird die AdventureWorks2022-Datenbank verwendet.
SELECT COUNT(*), AVG(Bonus)
FROM Sales.SalesPerson
WHERE SalesQuota > 25000;
GO
Hier sehen Sie das Ergebnis.
----------- ---------------------
14 3472.1428
(1 row(s) affected)
D: Verwenden der OVER-Klausel
In diesem Beispiel werden die Funktionen MIN, MAX, AVG und COUNT zusammen mit der OVER-Klausel verwendet, um aggregierte Werte für die einzelnen Abteilungen in der Tabelle HumanResources.Department der AdventureWorks2022-Datenbank zurückzugeben.
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;
Hier sehen Sie das Ergebnis.
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)
Beispiele: Azure Synapse Analytics und Analytics-Plattformsystem (PDW)
E. Verwenden von COUNT und DISTINCT
Dieses Beispiel gibt die Anzahl der verschiedenen Positionen zurück, die ein Mitarbeiter eines bestimmten Unternehmens innehaben kann.
USE ssawPDW;
SELECT COUNT(DISTINCT Title)
FROM dbo.DimEmployee;
Hier sehen Sie das Ergebnis.
-----------
67
F. Verwenden von COUNT(*)
In diesem Beispiel wird die Gesamtzahl der Zeilen in der dbo.DimEmployee-Tabelle zurückgegeben.
USE ssawPDW;
SELECT COUNT(*)
FROM dbo.DimEmployee;
Hier sehen Sie das Ergebnis.
-------------
296
G. Verwenden von COUNT(*) mit weiteren Aggregaten
Dieses Beispiel vereint COUNT(*) mit weiteren Aggregatfunktionen in der SELECT-Liste. Es gibt die Anzahl der Vertriebsmitarbeiter mit einer jährlichen Sollvorgabe für den Verkauf von über 500.000 USD und die durchschnittliche Sollvorgabe dieser Vertriebsmitarbeiter für den Verkauf zurück.
USE ssawPDW;
SELECT COUNT(EmployeeKey) AS TotalCount, AVG(SalesAmountQuota) AS [Average Sales Quota]
FROM dbo.FactSalesQuota
WHERE SalesAmountQuota > 500000 AND CalendarYear = 2001;
Hier sehen Sie das Ergebnis.
TotalCount Average Sales Quota
---------- -------------------
10 683800.0000
H. Verwenden von COUNT mit HAVING
Dieses Beispiel verwendet COUNT mit der HAVING-Klausel, um die Abteilungen einer Firma zurückzugeben, von denen jede mehr als 15 Mitarbeiter aufweist.
USE ssawPDW;
SELECT DepartmentName,
COUNT(EmployeeKey)AS EmployeesInDept
FROM dbo.DimEmployee
GROUP BY DepartmentName
HAVING COUNT(EmployeeKey) > 15;
Hier sehen Sie das Ergebnis.
DepartmentName EmployeesInDept
-------------- ---------------
Sales 18
Production 179
I. Verwenden von COUNT mit OVER
In diesem Beispiel wird COUNT mit der OVER-Klausel verwendet, um die Anzahl der enthaltenen Produkte für jeden der angegebenen Verkaufsaufträge zurückzugeben.
USE ssawPDW;
SELECT DISTINCT COUNT(ProductKey) OVER(PARTITION BY SalesOrderNumber) AS ProductCount
, SalesOrderNumber
FROM dbo.FactInternetSales
WHERE SalesOrderNumber IN (N'SO53115',N'SO55981');
Hier sehen Sie das Ergebnis.
ProductCount SalesOrderID
------------ -----------------
3 SO53115
1 SO55981