Comando STATISTICS

Informações do conceito

Gerar estatísticas

Calcula estatísticas para um ou mais campos numéricos ou datahora em uma tabela do Analytics.

Sintaxe

STATISTICS {<ON> nome_campo <...n>|<ON> ALL <EXCLUDE nome_campo <...n>>} <STD> <MODMEDQ> <NUMBER n> <TO {SCREEN|nome_arquivo|PRINT}> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <APPEND>

Parâmetros

Nome Descrição
ON nome_campo <...n> | ON ALL

Especifique um ou mais campos numéricos ou datahora para gerar as estatísticas, ou especifique ON ALL para gerar estatísticas de todos os campos datahora na tabela do Analytics.

EXCLUDE nome_campo

opcional

Válido apenas ao gerar estatísticas usando ON ALL.

O campo ou os campos a serem excluídos do comando. O EXCLUDE permite ajustar o ON ALL excluindo os campos especificados.

O EXCLUDE deve estar logo após do ON ALL. Por exemplo:

ON ALL EXCLUDE campo_1 campo_2

STD

opcional

Calcula o desvio padrão dos campos especificados, além de outras estatísticas.

MODMEDQ

opcional

Calcula os valores de moda, mediana, primeiro quartil e terceiro quartil dos campos especificados, além de outras estatísticas.

NUMBER n

opcional

O número de valores altos e baixos a reter durante o processamento. O valor padrão é 5.

TO SCREEN | nome_arquivo | PRINT

opcional

A localização para onde enviar os resultados do comando:

  • SCREEN exibe os resultados na área de exibição do Analytics

    Dica

    Você pode clicar em qualquer valor de resultado vinculado na área de exibição para detalhar até o registro ou os registros associados na tabela de origem.

  • nome_arquivo salva os resultados em um arquivo

    Especifique nome_arquivo como uma cadeia entre aspas com uma extensão de arquivo apropriada. Por exemplo: TO "Saída.TXT"

    Por padrão, o arquivo é salvo na pasta que contém o projeto do Analytics.

    Use um caminho de arquivo absoluto ou relativo para salvar o arquivo em uma pasta diferente já existente:

    • TO "C:\Saída.TXT"
    • TO "Resultados\Saída.TXT"
  • PRINT envia os resultados para a impressora padrã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.

APPEND

opcional

Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo.

Nota

Você deve garantir que a estrutura da saída do comando e o arquivo existente são idênticos:

  • os mesmos campos
  • a mesma ordem de campos
  • os campos correspondentes têm o mesmo comprimento
  • os campos correspondentes têm o mesmo tipo de dados

O Analytics anexa a saída a um arquivo existente, seja qual for sua estrutura. Se a estrutura da saída e do arquivo existente não corresponderem, o resultado poderá ser dados misturados, ausentes ou incorretos.

Variáveis de saída do Analytics

Nota

Se você gerar estatísticas para mais de um campo na tabela, as variáveis de saída geradas pelo sistema conterão valores apenas para o primeiro campo listado.

Nome Contém
ABSn

O valor absoluto calculado pelo comando.

AVERAGEn

O valor médio calculado pelo comando.

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.

HIGHn

O quinto valor mais alto identificado pelo comando.

O quinto valor mais alto é a configuração padrão. A configuração pode ser alterada usando o parâmetro NUMBER. Por exemplo, NUMBER 3 especifica o armazenamento do terceiro valor mais alto.

Nota

Quando o Analytics identifica o valor mais alto, valores duplicados não são eliminados. Por exemplo, se os valores em ordem decrescente forem 100, 100, 99 e 98, o terceiro maior valor será 99 e não 98.

LOWn

O quinto valor mais baixo identificado pelo comando.

O quinto valor mais baixo é a configuração padrão. A configuração pode ser alterada usando o parâmetro NUMBER. Por exemplo, NUMBER 3 especifica o armazenamento do terceiro valor mais baixo.

Nota

Quando o Analytics identifica o valor mais baixo, valores duplicados não são eliminados. Por exemplo, se os valores em ordem crescente forem 1, 1, 2 e 3, o terceiro valor mais baixo será 2 e não 3.

MAXn

O valor máximo identificado pelo comando.

MEDIANn

O valor da mediana identificado pelo comando.

MINn O valor mínimo identificado pelo comando.
MODEn O valor que ocorre com maior frequência identificado pelo comando.
Q25n O valor do primeiro quartil (valor do quartil inferior) calculado pelo comando.
Q75n O valor do terceiro quartil (valor do quartil superior) calculado pelo comando.
RANGEn A diferença entre os valores máximo e mínimo calculados pelo comando.
STDDEVn O valor do desvio padrão calculado pelo comando.
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

Geração condicional de estatísticas

Gere estatísticas para o campo Quantidade dos registros onde o ID da classe do produto é 01:

STATISTICS ON Quantidade IF Classe_de_produto = "01"