Comando TOTAL
Informações do conceito
Calcula o valor total de um ou mais campos em uma tabela do Analytics.
Sintaxe
TOTAL {<FIELDS> campo_numérico <...n>|<FIELDS> ALL <EXCLUDE campo_numérico <...n>>} <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo>
Parâmetros
| Nome | Descrição |
|---|---|
| FIELDS campo_numérico <...n> | FIELDS ALL |
O campo ou os campos numéricos a serem totalizados. Especifique ALL para totalizar cada um dos campos numéricos na tabela. |
| EXCLUDE campo_numérico opcional |
Válido apenas ao totalizar usando FIELDS ALL. O campo ou os campos a serem excluídos do comando. EXCLUDE permite ajustar a palavra-chave ALL, excluindo os campos especificados. EXCLUDE deve seguir FIELDS ALL imediatamente ou a última ocorrência da palavra-chave ALL se você estiver incluindo campos de uma ou mais tabelas relacionadas. Por exemplo: FIELDS ALL EXCLUDE campo_1 campo_2 FIELDS ALL nome_tabela_relacionada.ALL EXCLUDE campo_1 campo_2 |
|
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:
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
Nota
Se você totalizar mais de um campo em uma tabela, a variável de saída gerada pelo sistema conterá apenas o total do primeiro campo listado.
| Nome | Contém |
|---|---|
| TOTALn |
O valor total calculado pelo comando. O valor de n é 1, a menos que o comando TOTAL esteja dentro de um comando GROUP. Nesse caso, o valor de n corresponde ao número de linha do comando TOTAL no comando GROUP. Para obter mais informações, consulte Comando GROUP. |
Exemplos
Totalização dos primeiros 25 registros
Calcule o valor total do campo VLRMERC dos primeiros 25 registros na tabela:
TOTAL FIELDS VLRMERC FIRST 25
Observações
Quando usar TOTAL
Use TOTAL para verificar a totalidade e precisão dos dados de origem e para produzir totais de controle. O comando calcula a soma aritmética dos campos ou expressões especificadas.
