COUNT_BIG (Transact-SQL)

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 de SQL no Microsoft Fabric Warehouse no Microsoft Fabric

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 exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) 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)