テスト演算の条件

重要

Data Workbench 提供終了のお知らせ.

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

比較

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

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

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

この例では、 Compare 定義する条件 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 条件のパラメーターについて次の表で説明します。

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

この例では、 Range 定義する条件 Log Entry Condition. Data Workbench サーバーが event data を使用する場合、数値 x-age と 55 を比較します。特定のログエントリについて、x-age が 55 以上である場合、そのログエントリはデータセットの構築プロセスに含められます。この例で実行される機能は、Compare 条件で取り上げた例と同じです。Compare を参照してください。

メモ

Min パラメーターまたは Max パラメーターを空白のままにした場合、Data Workbench サーバーは使用可能な最小または最大の整数値を置き換えます。最小値はゼロ（0）で、最大値は無限です。

正規表現

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

入力データが文字列ベクトルである場合、ベクトル内の 1 つ目の値だけがテストに使用されます。この Regular Expression 条件は完全な文字列の比較を実行します。文字列を部分的に識別する必要がある場合は、文字列の前後に「.*」を文字列に追加します。

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

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

以下に示したのは、Web サイトトラフィックから収集したデータのフィールドに、Regular Expression 条件を適用して、一致しているかどうかを判断する例です。この条件は、cs(referrer-query) フィールドに正規表現と一致する文字列が含まれている場合にのみ true を返します campaign=C[1-9][0-9]{4}. この正規表現は、 campaign=C12345. ただし、このパターンは文字列と一致しません campaign=C0123& これは、 C が範囲内にない 1-9.

文字列の一致

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

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

以下に示したのは、Web サイトトラフィックから収集したデータに String Match 条件を適用する例です。この条件は、入力フィールド (cs-uri-stem) が Matches パラメーターで指定された 2 つの文字列のいずれかと一致するかどうかをテストし、フィールド cs-uri-stem が正確な文字列である場合に成功します /navigation/footer.asp または正確な文字列 /navigation/header.asp.