CONTE (Transact-SQL)

Si applica a:SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di analisi (PDW)Endpoint di analisi SQL in Microsoft FabricMagazzino in Microsoft FabricDatabase SQL 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 relative alla sintassi Transact-SQL

Sintassi

Sintassi della funzione di aggregazione:

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

Sintassi della funzione analitica:

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

Argomenti

Tutti

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

distinto

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

di espressione

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. Conteggia ogni riga separatamente, incluse le righe che contengono valori Null.

CAMBIO ( [ 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.

Tipi restituiti

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

• Restituisce int NULL quando ANSI_WARNINGS è OFF.

Osservazioni:

COUNT(*) senza GROUP BY restituisce la cardinalità (numero di righe) nel set di risultati. Questo conteggio include righe con tutti i NULL valori e duplicati.

COUNT(*) con GROUP BY restituisce il numero di righe in ogni gruppo. Questo conteggio include 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.

Utilizzo deterministico e non deterministico

COUNT_BIG è una funzione deterministica se utilizzata senza le OVER clausole e ORDER BY .

COUNT_BIG è non deterministico quando viene usato con le OVER clausole e ORDER BY .

Usa e OVERORDER BY clausole	Deterministico
NO	Yes
Yes	NO

Per altre informazioni, vedere Funzioni deterministiche e non deterministiche.

ARITHABORT e ANSI_WARNINGS

• Quando COUNT restituisce un valore che supera il valore massimo di int (2^31-1 o 2.147.483.647), la funzione ha esito negativo a causa di un overflow intero.

• Se COUNT l'overflow e entrambe le ARITHABORT opzioni e ANSI_WARNINGS sono OFF, COUNT restituisce NULL. In caso contrario, se oARITHABORTANSI_WARNINGS è ON, la query interrompe e genera l'errore di overflow aritmetico:

  Msg 8115, Level 16, State 2; Arithmetic overflow error converting expression to data type int.
  

  Per gestire correttamente questi risultati di grandi dimensioni, usare invece COUNT_BIG , che restituisce bigint.

• ARITHABORT Quando e ANSI_WARNINGS sono ON, è possibile eseguire il wrapping COUNT sicuro dei siti di chiamata in ISNULL( <count-expr>, 0) per forzare il tipo dell'espressione int NOT NULL anziché int NULL. Il wrapping COUNT in ISNULL indica che qualsiasi errore di overflow viene eliminato automaticamente, che deve essere considerato per la correttezza.

Esempi

Gli esempi di codice in questo articolo usano il database di esempio AdventureWorks2025 o AdventureWorksDW2025, che è possibile scaricare dalla home page Microsoft SQL Server Samples and Community Projects.

R. Usare COUNT e DISTINCT

In questo esempio viene restituito il numero di diversi titoli di lavoro nella HumanResources.Employee tabella che un dipendente può contenere.

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

Il set di risultati è il seguente.

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

B. Usare COUNT(*)

In questo esempio viene restituito il numero totale di dipendenti nella HumanResources.Employee tabella.

SELECT COUNT(*)
FROM HumanResources.Employee;
GO

Il set di risultati è il seguente.

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

C. Usare COUNT(*) con altre aggregazioni

Questo esempio illustra che COUNT(*) può essere usata con altre funzioni di aggregazione nell'elenco SELECT.

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

Il set di risultati è il seguente.

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

D. Usare la clausola OVER

In questo esempio vengono utilizzate le MINfunzioni , AVGMAX, e COUNT con la OVER clausola per restituire valori aggregati per ogni reparto della HumanResources.Department tabella.

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;

Il set di risultati è il seguente.

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

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;

Il set di risultati è il seguente.

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

F. Usare COUNT(*)

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

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

Il set di risultati è il seguente.

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

Il set di risultati è il seguente.

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;

Il set di risultati è il seguente.

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

Io. 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');

Il set di risultati è il seguente.

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

Contenuti correlati

• Funzioni di aggregazione (Transact-SQL)
• COUNT_BIG (Transact-SQL)
• Clausola SELECT - OVER (Transact-SQL)