COUNT_BIG (Transact-SQL)

Aplica-se a: SQL Server (todas as versões com suporte) Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System)

Essa função retorna o número de itens encontrados em um grupo. COUNT_BIG funciona como a função COUNT. Essas funções são diferentes apenas nos tipos de dados de seus valores de retorno. COUNT_BIG sempre retorna um valor do tipo de dados bigint. COUNT sempre retorna um valor do tipo de dados int.

Convenções de sintaxe de Transact-SQL

Sintaxe


-- Aggregation Function Syntax  
COUNT_BIG ( { [ [ ALL | DISTINCT ] expression ] | * } )  
  
-- Analytic Function Syntax  
COUNT_BIG ( [ ALL ] { expression | * } ) OVER ( [ <partition_by_clause> ] )  

Observação

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

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

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

expressão
Uma expression de qualquer tipo. COUNT_BIG não oferece suporte a funções de agregação ou subconsultas em uma expressão.

*
Especifica que COUNT_BIG deve contar todas as linhas para determinar a contagem total de linhas da tabela para retornar. COUNT_BIG(*) não usa nenhum parâmetro e não oferece suporte ao uso de DISTINCT. COUNT_BIG(*) não exige um parâmetro expression porque, por definição, não usa informações sobre nenhuma coluna específica. COUNT_BIG(*) retorna o número de linhas em uma tabela especificada e preserva linhas duplicatas. Ele conta cada linha separadamente, inclusive as linhas que contêm valores nulos.

OVER ( [ partition_by_clause ] [ order_by_clause ] )
A partition_by_clause divide o conjunto de resultados produzido pela cláusula FROM em partições às quais a função COUNT_BIG é 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

bigint

Comentários

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

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

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

COUNT_BIG é uma função determinística quando usada sem as cláusulas OVER e ORDER BY. COUNT_BIG é não determinístico quando especificado com as cláusulas OVER e ORDER BY. Veja Funções determinísticas e não determinísticas para saber mais.

Exemplos

Veja exemplos em COUNT (Transact-SQL).

Confira também

Funções de agregação (Transact-SQL)
COUNT (Transact-SQL)
int, bigint, smallint e tinyint (Transact-SQL)
Cláusula OVER (Transact-SQL)