適用対象: ✅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」
パフォーマンスに関するヒント
注
128 を超える検索用語を使用すると、テキスト インデックス検索の最適化が無効になり、クエリのパフォーマンスが低下する可能性があります。
構文
has_any_ipv4(
source,
ip_address [,
ip_address_2,
...] )
構文規則について詳しく知る。
パラメーター
件名 | タイプ | 必須 | 説明 |
---|---|---|---|
ソース | string |
✔️ | 検索する値。 |
ip_address | 文字列または動的 | ✔️ | 検索する IP アドレス、または IP アドレスの配列。 |
返品
true
指定された IP アドレスのいずれかが有効な IPv4 アドレスであり、 source で見つかった場合。 それ以外の場合、関数は false
を返します。
例
次の例では、複数のスカラー値を持つ has_any_ipv4
を使用して、各 IP アドレスを個別の文字列引数として指定する方法を示します。 テキスト内の 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')
結果 |
---|
ほんとう |
次の例では、IP アドレスの動的配列で has_any_ipv4
を使用する方法を示します。 テキスト内の 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']))
結果 |
---|
ほんとう |
次の例では、無効な IPv4 アドレスで has_any_ipv4
を使用する方法を示します。 テキスト内の IP アドレスは、英数字以外の文字で適切に区切られます。
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"]))
結果 |
---|
偽り |
次の例では、不適切に区切られた IP アドレスで has_any_ipv4
を使用する方法を示します。 テキスト内の 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
結果 |
---|
偽り |