Comando STATISTICS
Informações do conceito
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:
|
|
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. |
|
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:
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.
|
| 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 |
|
|
| Negativo |
|
Não aplicável, não gerado |
| Zeros | Número de valores zero | Número de datas vazias |
| Totais |
|
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
|
Data mediana
|
| Q25 (opcional) | O valor do primeiro quartil (valor do quartil inferior)
|
A data do primeiro quartil (data do quartil inferior)
|
| Q75 (opcional) | O valor do terceiro quartil (valor do quartil superior)
|
A data do terceiro quartil (data do quartil superior)
|
| Moda (opcional) | O valor que ocorre com maior frequência
|
A data que ocorre com maior frequência
|
| 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. |