COUNT (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Analytics-Endpunkt in Microsoft FabricWarehouse 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> ] )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) oder früher finden Sie unter Dokumentation zu früheren Versionen.

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_WARNINGSON ist, SQL Server behandelt COUNT-Ausdrücke in Metadaten jedoch immer wie int NULL, sofern sie nicht in ISNULL umschlossen werden.

  • int NULL, wenn ANSI_WARNINGSOFF ist.

Bemerkungen

  • COUNT(*) ohne GROUP BY gibt die Kardinalität (Anzahl der Zeilen) im Resultset zurück. Dies schließt Zeilen ein, die aus ausschließlichen NULL-Werten und Duplikaten bestehen.
  • COUNT(*) mit GROUP BY gibt die Anzahl der Zeilen in jeder Gruppe zurück. Dies schließt NULL-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 ist das Resultset.

-----------
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 ist das Resultset.

-----------
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 ist das Resultset.

----------- ---------------------
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 ist das Resultset.

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 ist das Resultset.

-----------
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 ist das Resultset.

-------------
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 ist das Resultset.

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 ist das Resultset.

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 ist das Resultset.

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

Weitere Informationen