Comando BENFORD

Informações do conceito

Efetuar análise de Benford

Conta o número de vezes que cada dígito (1 a 9) ou combinação de dígitos à esquerda ocorre em um campo e compara a contagem real à contagem esperada. O resultado esperado é calculado usando a fórmula de Benford.

Sintaxe

BENFORD <ON> campo_numérico <LEADING n> <IF teste> <BOUNDS> <TO {SCREEN|nome_tabela|GRAPH|PRINT}> <LOCAL> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <WHILE teste> <FIRST intervalo|NEXT intervalo> <APPEND> <OPEN>

Parâmetros

Nome Descrição
ON campo_numérico

O campo numérico a ser analisado.

Nota

Selecione um campo que contém "números que ocorrem naturalmente", como valores de transação. A análise de Benford não é adequada a dados numéricos restritos de qualquer forma.

Para obter mais informações, consulte Quais dados posso testar usando a análise de Benford?

LEADING n

opcional

O número de dígitos à esquerda a serem analisados. O valor de n deve ser de 1 a 6.

Se LEADING for omitido, será usado o valor padrão 1.

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).

BOUNDS

opcional

Inclui os valores calculados dos limites superior e inferior que devem ser incluídos na saída.

Se duas ou mais contagens nos resultados excederem um dos limites, os dados podem ter sido manipulados e devem ser investigados.

TO SCREEN | nome_tabela | GRAPH | 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_tabela salva os resultados em uma tabela do Analytics

    Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. For exemplo: TO "Saída.FIL"

    Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics.

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

    • TO "C:\Saída.FIL"
    • TO "Resultados\Saída.FIL"

    Nota

    Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

  • GRAPH exibe os resultados em um gráfico na área de exibição do Analytics
  • PRINT envia os resultados para a impressora padrão

LOCAL

opcional

Salva o arquivo de saída no mesmo local que o projeto do Analytics.

Nota

Aplicável apenas na execução de um comando em uma tabela de servidor com um campo de saída que é uma tabela do Analytics.

O parâmetro LOCAL deve seguir imediatamente o parâmetro TO.

HEADER texto_cabeçalho

opcional

O texto a ser inserido na parte superior de cada página de um relatório.

texto_cabeçalho deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema HEADER do Analytics.

FOOTER texto_rodapé

opcional

O texto a ser inserido na parte inferior de cada página de um relatório.

texto_rodapé deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema FOOTER do Analytics.

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.

OPEN

opcional

Abre a tabela criada pelo comando após a execução do comando. Válido apenas se o comando criar uma tabela de saída.

Exemplos

Enviar resultados para gráficos

Execute o comando BENFORD para o campo Valor e envia os resultados para um gráfico:

BENFORD ON Valor LEADING 2 BOUNDS TO GRAPH

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Efetuar análise de Benford.

Quais dados posso testar usando a análise de Benford?

Use a análise de Benford apenas para testar dados numéricos que consistem em "números que ocorrem naturalmente" como valores contábeis, valores de transações, despesas ou números de endereços. A análise de Benford não é adequada a dados numéricos restritos de qualquer forma.

Siga as diretrizes a seguir para identificar dados numéricos adequados à análise de Benford:

  • Tamanho do conjunto de dados O conjunto de dados deve ser grande o suficiente para oferecer suporte a uma distribuição válida. A análise de Benford pode não fornecer resultados confiáveis para menos de 500 registros.
  • Requisito de dígito à esquerda É necessário que todos os números de 1 a 9 possam ocorrer como dígito à esquerda.
  • Requisito de combinação de dígito à esquerda É necessário que todos os números de 0 a 9 possam ocorrer como o segundo dígito à esquerda e como qualquer dígito sendo analisado.
  • Dados restritos Dados numéricos atribuídos ou gerados de acordo com um padrão pré-ordenado não são adequados para a análise de Benford. Por exemplo, não utilize a análise de Benford para analisar:
    • números sequenciais de cheques ou faturas
    • números de previdência social ou de telefone mapeados a um padrão específico
    • qualquer esquema de numeração com um intervalo que evita que certos números sejam exibidos
  • Números randômicos Números gerados por um gerador de números randômicos não são adequados para a análise de Benford.