VERIFY コマンド

Analytics テーブル中のデータがテーブル レイアウトのフィールド定義と一致していることを確認することにより、1 つ以上の Analytics テーブルのデータの妥当性エラーをチェックします。

構文

VERIFY {<FIELDS> フィールド <...n>|<FIELDS> ALL} <IF テスト> <WHILE テスト> <FIRST 範囲|NEXT 範囲> <ERRORLIMIT n> <TO {SCREEN|ファイル名|PRINT}> <APPEND>

パラメーター

名前 説明
FIELDS フィールド <...n> | FIELDS ALL

検証するフィールドまたは式。ALL を指定すると、テーブルのすべてのフィールドを検証します。

メモ

定義では、演算フィールド、アドホック式、およびバイナリ フィールドは常に有効です。

IF テスト

省略可能

各レコードを処理するために真である必要がある条件式。コマンドは、その条件を満たすレコードに対してのみ実行されます。

メモ

IF パラメーターは、任意の範囲パラメーター(WHILE、FIRST、NEXT)が適用された後に、テーブルに残るレコードに対してのみ評価されます。

WHILE テスト

省略可能

各レコードを処理するために真である必要がある条件式。条件が false と評価するか、テーブルの最後に達したら、コマンドは実行を中止します。

メモ

WHILE を FIRST または NEXT とともに使用する場合は、1 つの制限に達するとすぐに、レコードの処理が停止します。

FIRST 範囲 | NEXT 範囲

省略可能

処理するレコード数:

  • FIRST 指定されたレコード数に達するまで、最初のレコードから処理を開始します
  • NEXT 指定されたレコード数に達するまで、現在選択されているレコードから処理を開始します

範囲は処理するレコード数を指定します。

FIRST と NEXT を省略すると、すべてのレコードがデフォルトで処理されます。

ERRORLIMIT n

省略可能

コマンドが停止するまでに許容されるエラー数。デフォルト値は 10 です。

TO SCREEN | ファイル名 | PRINT

省略可能

コマンドの結果を送信する場所:

  • SCREEN は Analytics の表示領域に結果を表示します
  • ファイル名は結果の保存先となるファイルです。

    ファイル名には、適切なファイル拡張子を付けた文字列を引用符で囲んで指定します。例:TO "Output.TXT"

    デフォルトでは、テーブル ファイルは、Analytics プロジェクトが入っているフォルダーに保存されます。

    既存の異なるフォルダーにファイルを保存するには、絶対または相対ファイル パスを指定します。

    • TO "C:\Output.TXT"
    • TO "Results\Output.TXT"
  • 印刷 – 通常使うプリンターに結果を送信します

APPEND

省略可能

コマンドの出力を既存ファイルに上書きしないで、そのファイルの末尾に追加します。

メモ

コマンドの出力と既存のファイルの構造が同一であるようにする必要があります。

  • 同じフィールド
  • 同じフィールド順序
  • 一致するフィールドが同じ長さ
  • 一致するフィールドが同じデータ型

出力は、既存ファイルとの間でファイル構造が違っている場合でも、Analytics によって既存ファイルに追加されます。出力と既存のファイルの構造が一致しない場合は、データが混在、不足、不正確になります。

Analytics の出力変数

名前 含む
WRITEn

コマンドによって確認された妥当性エラーの合計数。

データの検証と誤謬限度の指定

テーブル内のすべての列を検証し、誤謬上限を 10 に設定するとします。次のコマンドは、10 個のデータ検証エラーが検出されると処理を停止します。

VERIFY ALL ERRORLIMIT 10 TO "ImportErrors.txt"

備考

機能の仕組み

VERIFY は、1 つ以上のフィールドの値をテーブル レイアウトの各フィールドに指定されているデータ型と比較し、エラーを報告します。このコマンドは、次のことを確認します。

  • 文字フィールドが有効な文字だけを含んでおり、印刷できない文字を含んでいない。
  • 数値フィールドが有効な数字データだけを含んでいる。数値フィールドは、数字のほかに、数字の前に 1 つのプラス記号またはマイナス記号を含んでいたり、1 つの小数点を含んでいたりしても構いません。
  • 日付時刻フィールドが、有効な日付、日付時刻、または時刻を含んでいる。

識別される各エラーについては、レコード番号とフィールド名が、16 進形式の無効な値と共に出力されます。

ACL のスクリプト作成ガイド 14.1