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 Observação 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. EXCLUDE permite ajustar a palavra-chave ALL, excluindo os campos especificados. EXCLUDE deve seguir FIELDS ALL imediatamente ou a última ocorrência da palavra-chave ALL se você estiver incluindo campos de uma ou mais tabelas relacionadas. Por exemplo: FIELDS ALL EXCLUDE campo_1 campo_2 FIELDS ALL nome_tabela_relacionada.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. Observação 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. Observação 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: PRIMEIROiniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado AVANÇARiniciar 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: SCREENexibe 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 o registro ou registros associados na tabela de origem. nome_arquivosalva os resultados em um arquivo Especifique nome_arquivo como uma cadeia entre aspas com a extensão de arquivo apropriada. Por exemplo: TO "Output.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:\Output.TXT" TO "Results\Output.TXT" PRINTenvia 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. Observação 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 caracterecontêm apenas caracteres válidos e que nenhum caractere que não pode ser impresso esteja presente
campos numéricoscontêm 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 de datahoracontêm 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.