Comando VERIFY

Verifica a existência de erros de validade de dados em um ou mais campos em uma tabela do Analytics, confirmando se os dados estão consistentes com as definições do campo no layout da tabela.

Sintaxe

VERIFY {<FIELDS> campo <...n>|<FIELDS> ALL} <IF teste> <WHILE teste> <FIRST range|NEXT intervalo> <ERRORLIMIT n> <TO {SCREEN|nome_arquivo|PRINT}> <APPEND>

Parâmetros

Nome Descrição
FIELDS campo <...n> | FIELDS ALL

As expressões ou campos a serem verificados. Especifique ALL para exportar todos os campos da tabela

Nota

Por definição, campos calculados, juntamente com expressões ad hoc e campos binários, são sempre válidos.

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.

ERRORLIMIT n

opcional

O número de erros permitidos antes de terminar o comando. O valor padrão é 10.

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

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

Nome Contém
WRITEn

O número total de erros de validade de dados identificados pelo comando.

Exemplos

Verificação de dados e especificação de um limite de erro

Verifique todas as colunas em uma tabela e define o limite de erro como 10. O comando interromperá o processamento se 10 erros de validade de dados forem encontrados:

VERIFY ALL ERRORLIMIT 10 TO “ErrosImportação.txt”

Observações

Como funciona?

O comando VERIFY compara os valores em um ou mais campos com o tipo de dados especificado para cada um dos campos no layout da tabela e relata todos os erros. O comando garante que:

  • campos de caracteres contenham apenas caracteres válidos e que nenhum caractere que não pode ser impresso esteja presente
  • campos numéricos contenham apenas dados numéricos válidos. Além de números, os campos numéricos podem conter um sinal positivo ou negativo precedente e um ponto decimal
  • campos datahora contenham datas, datahora ou horas válidas

Para cada erro identificado, o número do registro e o nome do campo são enviados, junto com o valor inválido em formato hexadecimal.