COUNT (Transact-SQL)

  • Articolo

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)SQL analytics endpoint in Microsoft FabricWarehouse in Microsoft Fabric

Questa funzione restituisce il numero di elementi presenti in un gruppo. Il funzionamento di COUNT è analogo a quello della funzione COUNT_BIG. Queste funzioni differiscono solo per i tipi di dati dei valori restituiti. COUNT restituisce sempre un valore con tipo di dati int. COUNT_BIG restituisce sempre un valore con tipo di dati bigint.

Convenzioni di sintassi Transact-SQL

Sintassi

Sintassi della funzione di aggregazione

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

Sintassi della funzione analitica

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

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

ALL

Applica la funzione di aggregazione a tutti i valori. ALL funge da valore predefinito.

DISTINCT

Specifica che COUNT restituisce il numero di valori univoci non Null.

expression

Espressione di qualsiasi tipo, a eccezione di image, ntext o text. COUNT non supporta funzioni di aggregazione o sottoquery in un'espressione.

*

Specifica che COUNT deve conteggiare tutte le righe per determinare il numero totale delle righe della tabella da restituire. COUNT(*) non accetta parametri e non supporta l'uso di DISTINCT. COUNT(*) non richiede un parametro di espressione perché per definizione non usa informazioni su una determinata colonna. COUNT(*) restituisce il numero di righe di una tabella specificata e mantiene le righe duplicate. Ogni riga viene contata separatamente, incluse le righe contenenti valori Null.

OVER ( [ partition_by_clause ] [ order_by_clause ] [ ROW_or_RANGE_clause ] )

partition_by_clause divide il set di risultati generato dalla clausola FROM in partizioni alle quali viene applicata la funzione COUNT. Se non specificato, la funzione tratta tutte le righe del set di risultati della query come un unico gruppo. order_by_clause determina l'ordine logico dell'operazione. Per altre informazioni, vedere clausola OVER (Transact-SQL).

Tipi restituiti

  • int NOT NULL quando ANSI_WARNINGS è ON, tuttavia SQL Server considererà COUNT sempre le espressioni come int NULL nei metadati, a meno che non venga eseguito il wrapping in ISNULL.

  • int NULL quando ANSI_WARNINGS è OFF.

Osservazioni:

  • COUNT(*) senza GROUP BY restituisce la cardinalità (numero di righe) nel set di risultati. Sono incluse le righe costituite da tutti iNULL valori e duplicati.
  • COUNT(*) con GROUP BY restituisce il numero di righe in ogni gruppo. Sono inclusi NULL valori e duplicati.
  • COUNT(ALL <expression>)valuta l'espressione per ogni riga di un gruppo e restituisce il numero di valori non null.
  • COUNT(DISTINCT *expression*)valuta l'espressione per ogni riga di un gruppo e restituisce il numero di valori univoci e non null.

COUNT è una funzione deterministica quando viene usata senza le clausole ORDER BY e OVER. Non è deterministica quando viene usata con le clausole ORDER BY e OVER. Per altre informazioni, vedere Funzioni deterministiche e non deterministiche.

ARITHABORT e ANSI_WARNINGS

Quando COUNT ha un valore restituito che supera il valore massimo di int (ovvero 231-1 o 2.147.483.647), la COUNT funzione avrà esito negativo a causa di un overflow intero. Quando COUNT l'overflow e entrambe le ARITHABORT opzioni e ANSI_WARNINGS sono OFF, COUNT restituirà NULL. In caso contrario, quando uno di ARITHABORT o ANSI_WARNINGS è ON, la query interromperà e verrà generato l'errore Msg 8115, Level 16, State 2; Arithmetic overflow error converting expression to data type int. di overflow aritmetico. Per gestire correttamente questi risultati di grandi dimensioni, usare COUNT_BIG invece , che restituisce bigint.

Quando e ARITHABORT sono , è possibile eseguire il wrapping COUNT sicuro dei siti di chiamata in ISNULL( <count-expr>, 0 ) per coercire il tipo dell'espressione in anziché int NULLsu int NOT NULL .ONANSI_WARNINGS Se si esegue il wrapping COUNT , ISNULL qualsiasi errore di overflow verrà eliminato automaticamente, che deve essere considerato per la correttezza.

Esempi

R. Usare COUNT e DISTINCT

Questo esempio restituisce il numero di titoli diversi che può avere un dipendente di Adventure Works Cycles.

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

Questo è il set di risultati.

-----------
67
  
(1 row(s) affected)

B. Usare COUNT(*)

Questo esempio restituisce il numero totale di dipendenti di Adventure Works Cycles.

SELECT COUNT(*)
FROM HumanResources.Employee;
GO

Questo è il set di risultati.

-----------
290
  
(1 row(s) affected)

C. Usare COUNT(*) con altre aggregazioni

Questo esempio illustra che COUNT(*) può essere usata con altre funzioni di aggregazione nell'elenco SELECT. Nell'esempio viene utilizzato il database AdventureWorks2022.

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

Questo è il set di risultati.

----------- ---------------------
14            3472.1428
  
(1 row(s) affected)

D. Usare la clausola OVER

In questo esempio vengono utilizzate le MINfunzioni , MAXAVG e COUNT con la OVER clausola , per restituire valori aggregati per ogni reparto nella tabella di database HumanResources.Department 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;

Questo è il set di risultati.

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)

Esempi: Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW)

E. Usare COUNT e DISTINCT

Questo esempio restituisce il numero di titoli diversi che può avere un dipendente di una specifica società.

USE ssawPDW;
  
SELECT COUNT(DISTINCT Title)
FROM dbo.DimEmployee;

Questo è il set di risultati.

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

F. Usare COUNT(*)

Questo esempio restituisce il numero totale di righe della tabella dbo.DimEmployee.

USE ssawPDW;
  
SELECT COUNT(*)
FROM dbo.DimEmployee;

Questo è il set di risultati.

-------------
296

G. Usare COUNT(*) con altre aggregazioni

Questo esempio combina COUNT(*) con altre funzioni di aggregazione nell'elenco SELECT. Restituisce il numero di agenti di vendita con una quota di vendite annua maggiore di $ 500.000 e la quota di vendite media di tali agenti di vendita.

USE ssawPDW;
  
SELECT COUNT(EmployeeKey) AS TotalCount, AVG(SalesAmountQuota) AS [Average Sales Quota]
FROM dbo.FactSalesQuota
WHERE SalesAmountQuota > 500000 AND CalendarYear = 2001;

Questo è il set di risultati.

TotalCount  Average Sales Quota
----------  -------------------
10          683800.0000

H. Usare COUNT con HAVING

Questo esempio usa COUNT con la clausola HAVING per restituire i reparti di una società, ognuno dei quali ha più di 15 dipendenti.

USE ssawPDW;
  
SELECT DepartmentName,
    COUNT(EmployeeKey)AS EmployeesInDept
FROM dbo.DimEmployee
GROUP BY DepartmentName
HAVING COUNT(EmployeeKey) > 15;

Questo è il set di risultati.

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

I. Usare COUNT con OVER

Questo esempio usa COUNT con la clausola OVER per restituire il numero di prodotti presenti in ognuno degli ordini di vendita specificati.

USE ssawPDW;
  
SELECT DISTINCT COUNT(ProductKey) OVER(PARTITION BY SalesOrderNumber) AS ProductCount
    , SalesOrderNumber
FROM dbo.FactInternetSales
WHERE SalesOrderNumber IN (N'SO53115',N'SO55981');

Questo è il set di risultati.

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

Vedi anche