Função COUNTA

Gera a contagem de linhas não nulas em uma coluna especificada, que pode ser contada por grupo. O valor gerado é de tipo Inteiro.

OBSERVAÇÃO: valores vazios de string são contados. Valores nulos não são contados.

OBSERVAÇÃO: quando adicionada a uma transformação, a função COUNTA calcula o número de valores na coluna especificada, conforme exibido na amostra atual. As contagens não são aplicadas ao conjunto inteiro de dados até você executar o job. Se você alterar a amostra ou executar o job, os valores calculados para essa função serão atualizados. As transformações que alteram o número de linhas nas etapas seguintes da receita não afetam o valor da instância de COUNTA já calculada.

Para uma versão dessa função, calculada em uma janela contínua de linhas, consulte Função ROLLINGCOUNTA.

Uso básico

pivot value: COUNTA(name) group:postal_code limit:1

Saída: gera uma tabela de duas colunas contendo os valores exclusivos para postal_code e a contagem de valores não vazios na coluna name para esse valor postal_code. O parâmetro limit define o número máximo de colunas de resultado.

Sintaxe

pivot value:COUNTA(function_col_ref) [group:group_col_ref] [limit:limit_count]

ArgumentoObrigatório?Tipo de dadosDescrição
function_col_refSstringNome da coluna à qual aplicar a função

Para mais informações sobre o parâmetro group, consulte Transformação Pivot.

function_col_ref

Nome da coluna da qual contar os valores com base no agrupamento.

  • Valores literais não são aceitos como entradas.
  • Não há compatibilidade com várias colunas e caracteres curinga.

Notas de uso:

Obrigatório?Tipo de dadosValor de exemplo
SimString (referência de coluna)myValues

Exemplos

Exemplo: contagem simples de linhas

Nesta seção, apresentamos exemplos simples de como usar as funções COUNTA e COUNTDISTINCT. Essas funções incluem os seguintes itens:

  • COUNTA: contagem do número de valores em um grupo que atende a uma condição específica. Consulte a função COUNTA.
  • COUNTDISTINCT: contagem do número de valores não nulos em um grupo que atendem a uma condição específica. Consulte a função COUNTDISTINCT.

Origem:

No exemplo a seguir, a sétima linha é uma string vazia, e a oitava linha é um valor nulo.

rowIdVal
r001val1
r002val1
r003val1
r004val2
r005val2
r006val3
r007(vazio)
r008(nulo)

Transformação:

Aplique uma função COUNTA à coluna de origem:

derive type:single value:COUNTA(Val) as:'fctnCounta'

Aplique uma função COUNTDISTINCT à origem:

derive type:single value:COUNTDISTINCT(Val) as:'fctnCountdistinct'

Resultados:

A seguir, as duas funções contam o número de valores na coluna, com o COUNTDISTINCT contando apenas valores distintos. O valor vazio de r007 é contado pelas duas funções.

rowIdValfctnCountdistinctfctnCounta
r001val147
r002val147
r003val147
r004val247
r005val247
r006val347
r007(vazio)47
r008(nulo)47

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Google Cloud Dataprep
Precisa de ajuda? Acesse nossa página de suporte.