Comando COUNT

Conta o número total de registros na exibição atual ou apenas os registros que cumprem a condição especificada.

Sintaxe

COUNT <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo>

Parâmetros

Nome	Descrição
IF teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição. Nota O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).
WHILE teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado. Nota Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.
FIRST intervalo \| NEXT intervalo opcional	O número de registros a ser processado: FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado Use intervalo para especificar o número de registros a serem processados. Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.

Nome

Descrição

IF teste

opcional

Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição.

Nota

O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).

WHILE teste

opcional

Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado.

Nota

Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.

FIRST intervalo | NEXT intervalo

opcional

O número de registros a ser processado:

FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado
NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado

Use intervalo para especificar o número de registros a serem processados.

Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.

Variáveis de saída do Analytics

Nome	Contém
COUNTn	A contagem de registros calculada pelo comando. Se o nome da variável é COUNT1, ele está armazenando a contagem de registros do comando executado mais recentemente. Se o nome da variável é COUNTn, onde n é maior que 1, a variável está armazenando a contagem de registros de um comando executado dentro de um comando GROUP. O valor de n é atribuído baseado no número da linha do comando no GROUP. Por exemplo, se o comando estiver uma linha abaixo do comando GROUP, será atribuído o valor COUNT2. Se o comando estiver quatro linhas abaixo do comando GROUP, será atribuído o valor COUNT5.

Nome

Contém

COUNTn

A contagem de registros calculada pelo comando.

Se o nome da variável é COUNT1, ele está armazenando a contagem de registros do comando executado mais recentemente.
Se o nome da variável é COUNTn, onde n é maior que 1, a variável está armazenando a contagem de registros de um comando executado dentro de um comando GROUP.
O valor de n é atribuído baseado no número da linha do comando no GROUP. Por exemplo, se o comando estiver uma linha abaixo do comando GROUP, será atribuído o valor COUNT2. Se o comando estiver quatro linhas abaixo do comando GROUP, será atribuído o valor COUNT5.

Exemplos

Armazenar COUNT1

O resultado do comando COUNT é armazenado na variável de saída COUNT1. Você pode recuperar e armazenar esse valor em uma variável definida pelo usuário.

O comando COUNT sobrescreve a variável COUNT1 a cada vez que é executado. Portanto, o valor precisa ser armazenado em uma variável definida pelo usuário antes da execução do comando pela segunda vez após a aplicação do filtro à tabela:

OPEN EndereçoCliente 
COUNT 
TotalReg = COUNT1 
SET FILTER TO DataModificação > '20100101' 
COUNT 
TotalRegFiltrados = COUNT1

Observações

Quando usar COUNT

Use o comando COUNT para contar o número de registros em uma tabela do Analytics ou para contar o número de registros que cumprem uma determinada condição de teste. Se nenhum teste for especificado, o número total de registros na tabela do Analytics será exibido.

Como os filtros afetam COUNT

Se um filtro tiver sido aplicado a uma exibição, o comando contará o número de registros restantes na exibição após a condição de filtragem ter sido aplicada.

[ Voltar ao início ]

Guia de scripting do ACL 14.1