Compartilhar via

Função Count (Microsoft Access SQL)

  • Artigo

Aplica-se ao: Access 2013 | Access 2016

Calcula o número de registros retornados por uma consulta.

Sintaxe

Count(expr)

O espaço reservado expr representa uma expressão de sequência que identifica o campo que contém os dados que deseja contar ou uma expressão que executa um cálculo utilizando os dados no campo. Os operandos em expr podem incluir o nome de um campo da tabela ou uma função (que pode ser intrínseca ou definida pelo usuário, mas não outras funções agregadas do SQL). É possível contar qualquer tipo de dados, inclusive texto.

Comentários

Utilize Contar para contar o número de registos numa consulta subjacente. Por exemplo, pode utilizar Contar para contar o número de encomendas enviadas para um determinado país ou região.

Embora o expr possa efetuar um cálculo num campo, a Contagem simplesmente contabiliza o número de registos. Não importa que valores são armazenados nos registos.

A função Count não conta registros que têm campos Null, a menos que expr seja o caractere curinga asterisco (*). Se você usar um asterisco, Count calculará o número total de registros, inclusive aqueles que contêm campos Null. Count( * ) é consideravelmente mais rápido do que Count( [ Nome da Coluna ] ). Não coloque o asterisco entre aspas (' ').

O exemplo a seguir calcula o número de registros na tabela Pedidos:

SELECT Count(*) 
AS TotalOrders FROM Orders;

Se expr identificar vários campos, a função Count contará um registro somente se, pelo menos, um dos campos não for Null. Se todos os campos especificados forem Null, o registro não será contado. Separe os nomes dos campos com um E comercial (&). O exemplo a seguir mostra como você pode limitar a contagem dos registros nos quais ShippedDate ou Freight não é Null:

SELECT 
Count('ShippedDate & Freight') 
AS [Not Null] FROM Orders;

Utilize Contagem numa expressão de consulta. Também é possível usar essa expressão na propriedade SQL de um objeto QueryDef ou ao criar um objeto Recordset com base em uma consulta SQL.

Exemplo

Este exemplo utiliza a tabela Pedidos para calcular o número de pedidos enviados ao Reino Unido.

Este exemplo chama o procedimento EnumFields, que você pode encontrar no exemplo de instrução SELECT.

Sub CountX() 
 
    Dim dbs As Database, rst As Recordset 
 
    ' Modify this line to include the path to Northwind 
    ' on your computer. 
    Set dbs = OpenDatabase("Northwind.mdb") 
    
    ' Calculate the number of orders shipped  
    ' to the United Kingdom. 
    Set rst = dbs.OpenRecordset("SELECT" _ 
        & " Count (ShipCountry)" _ 
        & " AS [UK Orders] FROM Orders" _ 
        & " WHERE ShipCountry = 'UK';") 
     
    ' Populate the Recordset. 
    rst.MoveLast 
     
    ' Call EnumFields to print the contents of the  
    ' Recordset. Pass the Recordset object and desired 
    ' field width. 
    EnumFields rst, 25 
 
    dbs.Close 
 
End Sub

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.