COUNT_BIG (Transact-SQL)
Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse 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)
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de