• Artigo

COUNT (Transact-SQL)

Retorna o número de itens de um grupo. COUNT funciona como a 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ópicoConvençõ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 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 Adventure Works Cycles pode ocupar.

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

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 Adventure Works Cycles.

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

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 AdventureWorks;
GO
SELECT COUNT(*), AVG(Bonus)
FROM Sales.SalesPerson
WHERE SalesQuota > 25000;
GO

Conjunto de resultados.

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