COUNT (Transact-SQL)

Artigo
10/31/2024

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Ponto de extremidade de análise do SQL Warehouse no Microsoft Fabric

Essa função retorna o número de itens encontrados em um grupo. COUNT funciona como a função COUNT_BIG. Essas funções são diferentes apenas nos tipos de dados de 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.

Convenções de sintaxe de Transact-SQL

Sintaxe

Sintaxe da função de agregação

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

Sintaxe da função analítica

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

Argumentos

ALL

Aplica a função de agregação a todos os valores. ALL funciona como o padrão.

DISTINTO

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

expressão

Uma expression de qualquer tipo, exceto image, ntext ou text. COUNT não oferece suporte a funções de agregação ou subconsultas em uma expressão.

*

Especifica que COUNT deve contar todas as linhas para determinar a contagem total de linhas da tabela para retornar. COUNT(*) não usa nenhum parâmetro e não oferece suporte ao uso de 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 e preserva linhas duplicatas. Ele conta cada linha separadamente. Isso inclui linhas que contêm valores nulos.

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

A partition_by_clause divide o conjunto de resultados produzido pela cláusula FROM em partições às quais a função COUNT é aplicada. Se não for especificado, a função tratará todas as linhas do conjunto de resultados da consulta como um único grupo. A order_by_clause determina a ordem lógica da operação. Confira Cláusula OVER (Transact-SQL) para obter mais informações.

Tipos de retorno

int NOT NULL quando ANSI_WARNINGS for ON, no entanto, o SQL Server sempre tratará expressões COUNT como int NULL nos metadados, a menos que seja encapsulada em ISNULL.
int NULL quando ANSI_WARNINGS for OFF.

Comentários

COUNT(*) sem GROUP BY retorna a cardinalidade (número de linhas) no conjunto de resultados. Isso inclui linhas compostas por todos os valores e duplicatas NULL.
COUNT(*) com GROUP BY retorna o número de linhas em cada grupo. Isso inclui valores e duplicatas NULL.
COUNT(ALL <expression>) avalia a expressão de cada linha em um grupo e retorna o número de valores não nulos.
COUNT(DISTINCT *expression*) avalia a expressão de cada linha em um grupo e retorna o número de valores não nulos exclusivos.

COUNT é uma função determinística quando usada sem as cláusulas OVER e ORDER BY. Ela é não determinística quando usada com as cláusulas OVER e ORDER BY. Para obter mais informações, confira Funções determinísticas e não determinísticas.

`ARITHABORT` e `ANSI_WARNINGS`

Quando COUNT tem um valor retornado que excede o valor máximo de int (ou seja, 2³¹-1 ou 2.147.483.647), a função COUNT falhará devido a um estouro de inteiro. Quando COUNT estoura e as opções ARITHABORT e ANSI_WARNINGS são OFF, COUNT retornará NULL. Caso contrário, quando um de ARITHABORT ou ANSI_WARNINGS for ON, a consulta será anulada e o erro Msg 8115, Level 16, State 2; Arithmetic overflow error converting expression to data type int. de estouro aritmético será gerado. Para lidar corretamente com esses resultados grandes, use COUNT_BIG em vez disso, que retorna bigint.

Quando ARITHABORT e ANSI_WARNINGS são ON, você pode encapsular COUNT com segurança em sites de chamada em ISNULL( <count-expr>, 0 ) para forçar o tipo da expressão para int NOT NULL em vez de int NULL. Encapsular COUNT em ISNULL significa que qualquer erro de estouro será suprimido silenciosamente, o que deve ser considerado para correção.

Exemplos

a. Usar COUNT e DISTINCT

Este exemplo retorna o número de cargos diferentes que um funcionário Ciclos da Adventure Works pode ter.

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