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:

  • A TELA 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.

Não é calculado para campos de datahora.

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, ou a quinta data mais recente.

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, ou a quinta data mais antiga.

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, ou a data mais recente.

MEDIANn

O valor da mediana identificado pelo comando.

Uma data mediana é exibida como um valor de datahora serial.

MINn O valor mínimo identificado pelo comando, ou a data mais antiga.
MODEn

O valor que ocorre com maior frequência identificado pelo comando.

Uma data modal é exibida como um valor de datahora serial.

Q25n

O valor do primeiro quartil (valor do quartil inferior) calculado pelo comando.

Uma data do primeiro quartil é exibida como um valor de datahora serial.

Q75n

O valor do terceiro quartil (valor do quartil superior) calculado pelo comando.

Uma data do terceiro quartil é exibida como um valor de datahora serial.

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.

Para campos de datahora, o total de todos os valores de datahora serial no campo.

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"

Observações

Todas as estatísticas são geradas para campos numéricos. Apenas um pequeno subconjunto de estatísticas é gerado para campos datahora.

Várias das estatísticas de datahora são exibidas como valores seriais de datahora. Você pode usar uma função de conversão para converter um valor serial de datahora em um valor de datahora regular legível por seres humanos. Para obter mais informações, consulte Datahoras seriais.

Nome da estatística Campo numérico Campo de datahora
Intervalo A diferença entre o valor mais alto e o mais baixo O número de dias entre a data mais recente e a mais antiga
Positivos
  • Número de valores positivos

  • Total de todos os valores positivos

  • Valor positivo médio

  • O número de valores de datahora

  • O total de todos os valores de datahora serial

    Não é significativo para datas ou valores de hora que representam pontos no tempo. Significativo para valores de tempo que representam quantidades de tempo.

    Para obter mais informações, consulte Uma quantidade de tempo em relação a um ponto no tempo.

  • O valor médio de datahora

Negativo
  • Número de valores negativos

  • Total de todos os valores negativos

  • Valor negativo médio

Não aplicável, não gerado
Zeros Número de valores zero Número de datas vazias
Totais
  • Número total de valores positivos, negativos e zero.

  • Total de todos os valores positivos, negativos e zero.

  • Média de todos os valores positivos, negativos e zero.

Não aplicável, não gerado
Valor abs. O total de todos os valores sem levar em consideração os sinais dos números. Não aplicável, não gerado
Desv. padrão (opcional) O desvio padrão para o valor médio

O desvio padrão do valor médio de datahora

Não é exibido ao apresentar estatísticas na tela, mas capturado na variável de saída STDDEVn gerada pelo sistema.

Mediana (opcional) Valor de mediana
  • Conjuntos ímpares de valores: o valor do meio

  • Conjuntos pares de valores: a média dos dois valores do meio

Data mediana
  • Conjuntos ímpares de datas: a data do meio

  • Conjuntos pares de datas: a média das duas datas do meio

Q25 (opcional) O valor do primeiro quartil (valor do quartil inferior)
  • O resultado é um valor interpolado com base em um algoritmo do Analytics

  • Gera o mesmo resultado que as funções QUARTILE e QUARTILE.INC no Microsoft Excel

A data do primeiro quartil (data do quartil inferior)
  • O resultado é um valor interpolado com base em um algoritmo do Analytics

  • Deslocado em 1 dia em relação ao resultado das funções QUARTILE e QUARTILE.INC no Microsoft Excel

    Para obter mais informações, consulte Datahoras seriais.

Q75 (opcional) O valor do terceiro quartil (valor do quartil superior)
  • O resultado é um valor interpolado com base em um algoritmo do Analytics

  • Gera o mesmo resultado que as funções QUARTILE e QUARTILE.INC no Microsoft Excel

A data do terceiro quartil (data do quartil superior)
  • O resultado é um valor interpolado com base em um algoritmo do Analytics

  • Deslocado em 1 dia em relação ao resultado das funções QUARTILE e QUARTILE.INC no Microsoft Excel

    Para obter mais informações, consulte Datahoras seriais.

Moda (opcional) O valor que ocorre com maior frequência
  • Exibe "N/A" se nenhum valor ocorrer mais de uma vez

  • Em caso de valores que ocorrem o mesmo número de vezes, exibe o valor mais baixo

A data que ocorre com maior frequência
  • Exibe "N/A" se nenhuma data ocorrer mais de uma vez

  • Em caso de valores que ocorrem o mesmo número de vezes, exibe a data mais antiga

Mais alto

Os cinco maiores valores

Você pode alterar o número de valores altos com a configuração Número de maiores/menores na guia Mais na caixa de diálogo Estatísticas.

As cinco datas mais recentes

Você pode alterar o número de datas recentes com a configuração Número de maiores/menores na guia Mais na caixa de diálogo Estatísticas.

Mais baixo

Os cinco menores valores

Você pode alterar o número de valores baixos com a configuração Número de maiores/menores na guia Mais na caixa de diálogo Estatísticas.

As cinco datas mais antigas

Você pode alterar o número de datas mais antigas com a configuração Número de maiores/menores na guia Mais na caixa de diálogo Estatísticas.