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.
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 requer 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 AdventureWorks2008R2;
GO
SELECT COUNT(DISTINCT JobTitle)
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 AdventureWorks2008R2;
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 AdventureWorks2008R2;
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)
Consulte também