COUNTROWS

A função COUNTROWS conta o número de linhas na tabela especificada ou em uma tabela definida por uma expressão.

Sintaxe

COUNTROWS([<table>])  

Parâmetros

Termo Definição
tabela (Opcional) O nome da tabela que contém as linhas a serem contadas ou uma expressão que retorna uma tabela. Quando não fornecido, o valor padrão é a tabela inicial da expressão atual.

Valor retornado

Um número inteiro.

Comentários

  • Essa função pode ser usada para contar o número de linhas em uma tabela base, mas com mais frequência é usada para contar o número de linhas que resultam da filtragem de uma tabela ou da aplicação de contexto a uma tabela.

  • Sempre que não houver linhas para agregação, a função retornará um valor em branco. No entanto, se houver linhas, mas nenhuma delas atender aos critérios especificados, a função retornará 0. O Microsoft Excel também retornará um zero se não for encontrada nenhuma linha que atenda às condições.

  • Para saber mais sobre as melhores práticas ao usar COUNT e COUNTROWS, confira Use COUNTROWS em vez de COUNT no DAX.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplo 1

O exemplo a seguir mostra como contar o número de linhas da tabela Orders. O resultado esperado é 52761.

= COUNTROWS('Orders')  

Exemplo 2

O exemplo a seguir demonstra como usar COUNTROWS com um contexto de linha. Nesse cenário, há dois conjuntos de dados relacionados por número de pedido. A tabela Reseller contém uma linha para cada revendedor; a tabela ResellerSales contém várias linhas para cada pedido, cada linha contendo um pedido para um revendedor específico. As tabelas são conectadas por uma relação na coluna ResellerKey.

A fórmula obtém o valor de ResellerKey e, em seguida, conta o número de linhas da tabela relacionada que têm a mesma ID de revendedor. O resultado é a saída na coluna, CalculatedColumn1.

= COUNTROWS(RELATEDTABLE(ResellerSales))  

A seguinte tabela mostra uma parte dos resultados esperados:

ResellerKey CalculatedColumn1
1 73
2 70
3 394

Consulte também

Função COUNT
Função COUNTA
Função COUNTAX
função COUNTX
Funções estatísticas