COUNT_BIG (Transact-SQL)

Retorna o número de itens de um grupo. COUNT_BIG funciona como a função COUNT. A única diferença entre as duas funções são 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.

Aplica-se a: SQL Server (do SQL Server 2008 à versão atual), Banco de dados SQL do Windows Azure (da versão inicial até a versão atual).

Convenções da sintaxe Transact-SQL

Sintaxe

COUNT_BIG ( { [ ALL | DISTINCT ] expression } | * )
   OVER ( [ partition_by_clause ] order_by_clause )

Argumentos

• ALL
  Aplica a função de agregação a todos os valores. ALL é o padrão.

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

• expression
  É uma expressão de qualquer tipo. 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_BIG(*) não usa nenhum parâmetro e não pode ser usado com DISTINCT. COUNT_BIG(*) não requer 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 sem descartar duplicatas. Ele conta cada linha separadamente. Isso inclui linhas que contêm valores nulos.

• ALL
  Aplica a função de agregação a todos os valores. ALL é o padrão.

• DISTINCT
  Especifica que AVG será executado apenas uma vez em cada instância exclusiva de um valor, por mais que esse valor ocorra.

• expression
  É uma expressão da categoria de tipo de dados numéricos exatos ou aproximados, com exceção do tipo de dados bit. Funções de agregação e subconsultas não são permitidas.

• OVER ( [ partition_by_clause ] order_by_clause**)**
  partition_by_clause divide o conjunto de resultados produzido pela cláusula FROM em partições nas quais a função é aplicada. Se não for especificado, a função tratará todas as linhas do conjunto de resultados da consulta como um único grupo. order_by_clause determina a ordem lógica na qual a operação é executada. order_by_clause é obrigatório. Para obter mais informações, consulte Cláusula OVER (Transact-SQL).

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 para cada linha em um grupo e retorna o número de valores não nulos.

COUNT_BIG (DISTINCT expression) avalia a expression para 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. É não determinística quando especificada com as cláusulas OVER e ORDER BY. Para obter mais informações, consulte Funções determinísticas e não determinísticas.

Consulte também

Referência

Funções de agregação (Transact-SQL)

COUNT (Transact-SQL)

int, bigint, smallint e tinyint (Transact-SQL)

Cláusula OVER (Transact-SQL)