has_any_ipv4()

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel

指定した IPv4 アドレスのいずれかがテキストに出現するかどうかを示す値を返します。

テキスト メッセージにおける IP アドレスの入力は、英数字以外の文字で適切に区切る必要があります。 たとえば、適切に区切られた IP アドレスは次のとおりです。

• 「これらの要求が、192.168.1.1、10.1.1.115、10.1.1.201 からありました」
• 「05:04:54 127.0.0.1 GET /favicon.ico 404」

パフォーマンスに関するヒント

Note

128 を超える検索用語を使用すると、テキスト インデックス検索の最適化が無効になり、クエリのパフォーマンスが低下する可能性があります。

構文

has_any_ipv4(source , ip_address [, ip_address_2, ...] )

構文規則について詳しく知る。

パラメーター

件名	タイプ	Required	説明
ソース	string	✔️	検索する値。
ip_address	文字列または動的	✔️	検索する IP アドレス、または IP アドレスの配列。

返品

true 指定された IP アドレスのいずれかが有効な IPv4 アドレスであり、 source で見つかった場合。 それ以外の場合、関数は false を返します。

例

文字列の一覧としての IP アドレス

クエリを実行する

print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '127.0.0.2')

結果
true

動的配列としての IP アドレス

クエリを実行する

print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', dynamic(['127.0.0.1', '127.0.0.2']))

結果
true

IPv4 アドレスが無効です

クエリを実行する

print result=has_any_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', dynamic(["127.0.0.256", "192.168.1.1"]))

結果
false

不適切に区切られた IP アドレス

クエリを実行する

print result=has_any_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '192.168.1.1') // false, improperly delimited IP address

結果
false