COUNT (Transact-SQL)

Retorna o número de itens de um grupo. COUNT funciona de modo semelhante à função COUNT_BIG. A única diferença entre as duas funções são seus valores de retorno. COUNT sempre retorna um valor do tipo de dados int. COUNT_BIG sempre retorna um valor do tipo de dados bigint. Pode ser seguido pela cláusula OVER.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • ALL
    Aplica a função de agregação a todos os valores. ALL é o padrão.

  • DISTINCT
    Especifica que COUNT retorna o número de valores não nulos exclusivos.

  • expression
    É uma expressão de qualquer tipo, com exceção de text, image ou ntext. Funções de agregação e subconsultas não são permitidas.

  • *
    Especifica que todas as linhas devem ser contadas para retornar o número total de linhas em uma tabela. COUNT(*) não usa nenhum parâmetro e não pode ser usado com DISTINCT. COUNT(*) não exige um parâmetro expression porque, por definição, não usa informações sobre nenhuma coluna específica. COUNT(*) retorna o número de linhas em uma tabela especificada sem descartar duplicatas. Ele conta cada linha separadamente. Isso inclui linhas que contêm valores nulos.

Tipos de retorno

int

Comentários

COUNT(*) retorna o número de itens de um grupo. Isso inclui valores NULL e duplicatas.

COUNT(ALL expression) avalia a expression para cada linha em um grupo e retorna o número de valores não nulos.

COUNT(DISTINCT expression) avalia a expression para cada linha em um grupo e retorna o número de valores não nulos exclusivos.

Para valores de retorno maiores que 2^31-1, COUNT produz um erro. Use COUNT_BIG em seu lugar.

Exemplos

A.Usando COUNT e DISTINCT

O exemplo a seguir lista o número de cargos diferentes que um funcionário que trabalha na Ciclos da Adventure Works pode ocupar.

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

Aqui está o conjunto de resultados.

-----------

67

(1 row(s) affected)

B.Usando COUNT(*)

O exemplo a seguir localiza o número total de funcionários que trabalham na Ciclos da Adventure Works.

USE AdventureWorks2012;
GO
SELECT COUNT(*)
FROM HumanResources.Employee;
GO

Aqui está o conjunto de resultados.

-----------

290

(1 row(s) affected)

C.Usando COUNT(*) com outras agregações

O exemplo a seguir mostra que COUNT(*) pode ser combinado com outras funções de agregação na lista de seleção.

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

Aqui está o conjunto de resultados.

----------- ---------------------

14 3472.1428

(1 row(s) affected)

C.Usando a cláusula OVER

O exemplo a seguir usa as funções MIN, MAX, AVG e COUNT com a cláusula OVER para fornecer valores agregados para cada departamento na tabela HumanResources.Department.

USE AdventureWorks2012; 
GO
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;

Aqui está o conjunto de resultados.

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)

Consulte também

Referência

Funções de agregação (Transact-SQL)

COUNT_BIG (Transact-SQL)

Cláusula OVER (Transact-SQL)