isNull、isEmpty、isBlank

isNull オペレータ

isNull オペレータは、1 つのパラメータを取ってブール値を返します。変数が null であれば true を返し、null 以外の値が変数に格納されていれば false を返しms合う。

isNull に加えて、isEmpty では文字や空白スペースが一切入っていない文字列を検索することができ、isBlank では空白スペースのみ (または空もしくは null) の文字列を検索することができます。これらのオペレータの用途は限定されており、非常に密接に関連しているため、まとめて説明します。

フィールドが null である理由

フィールドに null 値が格納される理由は次の通りです。

• ルックアップ オペレータのクエリで不一致があった場合。
• ジオ ルックアップ オペレータのクエリでフィールドが欠落していた場合。
• トランスポーズ オペレータのクエリでフィールドが欠落していた場合。

isNull、isEmpty、isBlank を使用するケース

isNull(str): フィールド値が「null」であるかどうかをチェックします。

isNull(null) = true

isNull("") = false

isNull(" ") = false

isNull("bob") = false

isNull(" bob ") = false

パラメータ:

str: チェックする文字列。null も可。

結果:

文字列が null であれば true。

 

isEmpty(str): フィールド値が文字も空白スペースも含まない空の文字列であるかどうかをチェックします。

isEmpty(null) = true

isEmpty("") = true

isEmpty(" ") = false

isEmpty("bob") = false

isEmpty(" bob ") = false

パラメータ:

str: チェックする文字列。null も可。

結果:

文字列が null または空であれば true。

 

isBlank(str): フィールド値が null、空文字列、または空白スペースのみの文字列であるかどうかをチェックします。

isBlank(null) = true

isBlank("") = true

isBlank(" ") = true

isBlank("bob") = false

isBlank(" bob ") = false

パラメータ:

str: チェックする文字列。null も可。

結果:

文字列が null、空、または空白スペースであれば true。

例

isNull: ジオ ルックアップ クエリを実行し、ジオ データベースに格納されていないリモート IP アドレスを検索。

この例では、country_code が関連付けられていない (このフィールドが null である) IP アドレスを探します。

次のようなクエリを実行した場合:

| parse "remote_ip=*]" as remote_ip
| lookup country_code from geo://location on ip = remote_ip
| if (isNull(country_code), "unknown", country_code) as country_code

次のような結果が返されます。

where を使用して null 値をチェックします。

ルックアップ オペレーションで返される null 値を探すには、次のようなクエリを実行します。

| parse "example_ip=*]" as ip
| lookup country_name, city from geo://location on ip = ip
| where isNull(country_name)