Commande VERIFY

Information de concept

Vérification des données

Recherche des erreurs de validité de données dans un ou plusieurs champs d'une table Analytics, en vérifiant que les données sont cohérentes avec les définitions de champ dans le format de table.

Syntaxe

VERIFY {<FIELDS> nom_champ <...n>|<FIELDS> ALL <EXCLUDE nom_champ <...n>>} <IF test> <WHILE test> <FIRST plage|NEXT plage> <ERRORLIMIT n> <TO {SCREEN|nom_fichier|PRINT}> <APPEND>

Paramètres

Nom Description
FIELDS nom_champ <...n> | FIELDS ALL

Champs ou expressions à vérifier. Spécifiez ALL pour vérifier tous les champs dans la table.

Remarque

Par définition, les champs calculés, les expressions ad hoc et les champs binaires sont toujours valides.
EXCLUDE nom_champ

optionnel

Valide uniquement dans le cas d'une vérification à l'aide de FIELDS ALL.

Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser le mot-clé ALL, en excluant les champs spécifiés.

EXCLUDE doit suivre immédiatement FIELDS ALL, ou la dernière occurrence du mot-clé ALL si vous incluez des champs d'une ou de plusieurs tables associées. Par exemple :

FIELDS ALL EXCLUDE champ_1 champ_2
FIELDS ALL nom_table_associée.ALL EXCLUDE champ_1 champ_2

IF test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée uniquement sur les enregistrements remplissant la condition.

Remarque

La condition IF est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (WHILE, FIRST, NEXT).
WHILE test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée jusqu'à ce que la condition soit évaluée comme fausse ou lorsque la fin de la table est atteinte.

Remarque

Si vous utilisez WHILE conjointement avec FIRST ou NEXT, le traitement des enregistrements s'arrête dès qu'une limite est atteinte.
FIRST plage | NEXT plage

optionnel

Le nombre d'enregistrements à traiter :

  • FIRST pour commencer le traitement à partir du premier enregistrement jusqu'à ce que le nombre d'enregistrements spécifié soit atteint
  • NEXT pour commencer le traitement à partir de l'enregistrement actuellement sélectionné jusqu'à ce que le nombre d'enregistrements spécifié soit atteint

Utilisez plage pour indiquer le nombre d'enregistrements à traiter.

Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut.

ERRORLIMIT n

optionnel

Le nombre d'erreurs toléré avant la fin de la commande. La valeur par défaut est 10.

TO SCREEN | nom_fichier | PRINT

optionnel

Emplacement vers lequel envoyer les résultats de la commande :

  • SCREEN : affiche les résultats dans la zone d'affichage d'Analytics

    Astuce

    Vous pouvez cliquer sur n'importe quelle valeur de résultat liée dans la zone d'affichage pour explorer jusqu'à l'enregistrement ou aux enregistrements associés dans la table source.

  • nom_fichier enregistre les résultats dans un fichier

    Indiquez nom_fichier sous forme de chaîne entre guillemets avec l'extension de fichier appropriée. Par exemple : TO "Sortie.TXT"

    Par défaut, le fichier est enregistré dans le dossier contenant le projet Analytics.

    Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier dans un autre dossier existant :

    • TO "C:\Sortie.TXT"
    • TO "Résultats\Sortie.TXT"
  • PRINT envoie les résultats vers l'imprimante par défaut

APPEND

optionnel

Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier.

Remarque

Vous devez vous assurer que la structure de la sortie de la commande et du fichier existant est identique :

  • les mêmes champs
  • le même ordre des champs
  • les champs correspondants ont la même longueur
  • les champs correspondants ont le même type de données

Analytics ajoute la sortie à un fichier existant sans tenir compte de sa structure, ce qui peut désordonner les données si la structure de la sortie et du fichier existant ne correspond pas.

Variables de sortie Analytics

Nom Contient
WRITEn

Nombre total d'erreurs de validité des données dans tous les champs vérifiés par la commande.

Exemples

Vérification des données et spécification d'une limite d'erreur

Vous vérifiez toutes les colonnes dans une table et définissez la limite d'erreur sur 10. La commande arrête le traitement si 10 erreurs de validité des données sont détectées :

VERIFY ALL ERRORLIMIT 10 TO "ImporterErreurs.txt"

Remarques

Fonctionnement

VERIFY compare les valeurs d'un ou plusieurs champs au type de données spécifié pour chaque champ dans le format de table, et renvoie toutes les erreurs. La commande vérifie les points suivants :

  • Les champs de type caractère contiennent uniquement des caractères valides et aucun caractère non imprimable
  • Les champs numériques contiennent uniquement des données numériques valides. En plus de chiffres, les champs numériques peuvent être précédées d'un signe plus ou d'un signe moins et contenir une virgule comme séparateur décimal
  • Les champs de type dateheure contiennent des valeurs de date, dateheure ou heure valides

Pour chaque erreur identifiée, le numéro d'enregistrement et le nom de champ sont renvoyés, avec la valeur erronée au format hexadécimal.