Comando VERIFY

Informações do conceito

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> nome_campo <...n>|<FIELDS> ALL <EXCLUDE nome_campo <...n>>} <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <ERRORLIMIT n> <TO {SCREEN|nome_arquivo|PRINT}> <APPEND>

Parâmetros

Nome	Descrição
FIELDS nome_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.
EXCLUDE nome_campo opcional	Válido apenas ao verificar usando FIELDS ALL. O campo ou os campos a serem excluídos do comando. O EXCLUDE permite ajustar o FIELDS ALL excluindo os campos especificados. O EXCLUDE deve estar logo após do FIELDS ALL. Por exemplo: FIELDS ALL EXCLUDE campo_1 campo_2
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 em todos os campos verificados 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.