テスト演算の条件

Compare、Not Empty、Range、Regular Expression、String Match など、テスト演算の条件について取り上げます。

Compare

Compare は、文字列値または数値を比較する条件です。文字列値を比較する場合、大文字と小文字を区別するかどうかを指定できます。

Compare 条件のパラメーターについて次の表で説明します。

パラメーター	説明	デフォルト
Case Sensitive	true または false。Type が LEXICAL の場合にのみ使用されます。false に設定した場合、大文字と小文字は区別されません。	true
コメント	（オプション）条件についてのメモ。	コメント
Input A	比較対象となる 2 つの値の 1 つ目。この値は、条件の左辺オペランドを表します。
Input B	比較対象となる 2 つの値の 2 つ目。この値は、条件の右辺オペランドを表します。
操作	比較演算。利用可能な演算（とその意味）を次に示します。 = または ==（Input A と Input B が等しい） <> or !=（Input A は Input B と等しくない） <（Input A は Input B より小さい） <=（Input A は Input B 以下） >（Input A は Input B より大きい） >=（Input A は Input B 以上）	=
タイプ	実行する比較のタイプ。LEXICAL、NUMERIC、DATETIME のいずれかを選択できます。これらのタイプの説明は、「テスト演算のテストタイプ」を参照してください。	LEXICAL

This example uses a Compare condition to define the Log Entry Condition. Data Workbench サーバーは、各イベントデータレコードを読み取る際、数値である x-age と 55 を比較します。特定のログエントリについて、x-age が 55 以下である場合、そのログエントリはデータセットの構築プロセスに含められます。

Not Empty

Not Empty は、フィールドに値が格納されているかどうかをチェックする条件です。Input フィールドの値が空以外であれば、ログエントリがこの条件を満たしていると見なされます。

Not Empty 条件のパラメーターについて次の表で説明します。

パラメーター	説明	デフォルト
コメント	（オプション）条件についてのメモ。	コメント
Input	特定のログエントリに関して、値が格納されているかどうかのチェック対象となるフィールドの名前。

この例では、x-some-field を入力として受け取り、そのフィールドに値が格納されている（空でない）かどうかをテストします。フィールドに値が格納されていれば、条件を満たしたことになります。

範囲

Range は、入力フィールドを受け取り、その値が、指定された下限値（Min）パラメーターと上限値（Max）パラメーターの範囲（両端の値を含む）に含まれているかどうかを判断する条件です。

Range 条件のパラメーターについて次の表で説明します。

パラメーター	説明	デフォルト
Case Sensitive	true または false。Type が LEXICAL の場合にのみ使用されます。false に設定した場合、大文字と小文字は区別されません。	true
コメント	（オプション）条件についてのメモ。	コメント
Input	ログエントリからの入力として使用するフィールドの名前。
Min	範囲の下限。このパラメーターの値は、リテラル値または文字列（つまりフィールド名以外）であることが必要です。このフィールドの日付を使用する場合、タイムゾーンを指定する必要があります。サポートされているタイムゾーンの略称一覧については、タイムゾーンのコード.
Max	範囲の上限。注意：このパラメーターの値は、リテラル値または文字列（つまりフィールド名以外）であることが必要です。このフィールドの日付を使用する場合、タイムゾーンを指定する必要があります。サポートされているタイムゾーンの略称一覧については、タイムゾーンのコード.
タイプ	実行する比較のタイプ。LEXICAL、NUMERIC、DATETIME のいずれかを選択できます。これらのタイプの説明は、「テスト演算のテストタイプ」を参照してください。

This example uses a Range condition to define the Log Entry Condition. As the data workbench server reads each event data record, it compares the numeric values x-age and 55. 特定のログエントリについて、x-age が 55 以上である場合、そのログエントリはデータセットの構築プロセスに含められます。この例で実行される機能は、Compare 条件で取り上げた例と同じです。Compare を参照してください。

メモ

MinまたはMaxパラメーターを空白のままにした場合、使用可能な最小または最大の整数値が代わりに使用されます。最小値はゼロ（0）で、最大値は無限です。

正規表現

この Regular Expression 条件テストでは、正規式のパターンマッチング( 正規式を参照)を使用して、Matchesパラメーターで指定されたパターンのいずれかに一致する文字列が、指定された入力フィールドの値に含まれているかどうかを判断します。

入力データが文字列ベクトルである場合、ベクトル内の 1 つ目の値だけがテストに使用されます。The Regular Expression condition performs full string comparisons. 文字列を部分的に識別する必要がある場合は、文字列の前後に「.*」を付加する必要があります。

Regular Expression 条件のパラメーターについて次の表で説明します。

パラメーター	説明	デフォルト
Case Sensitive	true または false。false に設定した場合、大文字と小文字は区別されません。	true
コメント	（オプション）条件についてのメモ。	コメント
Input	ログエントリからの入力として使用するフィールドの名前。
一致	入力フィールドの値と突き合わせる正規表現パターン（複数可）。正規表現パターンを追加するには Matches を右クリックします。新規追加／Regular Expression をクリックします。目的の正規表現をテキストボックスに入力します。

以下に示したのは、Web サイトトラフィックから収集したデータのフィールドに、Regular Expression 条件を適用して、一致しているかどうかを判断する例です。The condition returns true only if the cs(referrer-query) field contains a string matching the regular expression campaign=C[1-9][0-9]{4}. This regular expression matches any string containing campaign=C12345. However, the pattern would not match the string campaign=C0123& because the first character after the C is not in the range 1-9.

String Match

The String Match condition tests for string equality. 指定されたフィールドを入力として受け取り、各ログエントリ内のフィールドの値と、この条件演算の Matches パラメーターに指定された文字列とを比較します。Matches に指定されたいずれかの文字列が、指定された入力フィールドの値と同じ（大文字と小文字が区別されます）である場合、true を返します。StringCondition に一致文字列が存在しない場合は、false を返します。入力データが文字列ベクトルである場合、ベクトル内の 1 つ目の値（文字列）だけがテストに使用されます。

パラメーター	説明	デフォルト
Case Sensitive	true または false。false に設定した場合、大文字と小文字は区別されません。	true
コメント	（オプション）条件についてのメモ。	コメント
Input	ログエントリからの入力として使用するフィールドの名前。
一致	入力フィールドの値と突き合わせる文字列（複数可）。文字列を追加するには Matches を右クリックします。新規追加／String をクリックします。目的の文字列をテキストボックスに入力します。

以下に示したのは、Web サイトトラフィックから収集したデータに String Match 条件を適用する例です。The condition tests whether the input field (cs-uri-stem) matches either of the two strings specified in the Matches parameter, and it succeeds if the field cs-uri-stem is either the exact string /navigation/footer.asp or the exact string /navigation/header.asp.