ipv4_is_match()
適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
2 つの IPv4 文字列を照合します。 2 つの IPv4 文字列では、引数のプレフィックスおよび省略可能な引数 prefix から計算された IP プレフィックス マスクの組み合わせの構成時に、解析と比較が実行されます。
構文
ipv4_is_match(ip1,ip2[ ,prefix])
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| ip1、 ip2 | string |
✔️ | IPv4 アドレスを表す式。 IPv4 文字列は、IP プレフィックス表記 を使用してマスクできます。 |
| prefix | int |
考慮される最上位ビットの数を表す 0 ~ 32 の整数。 |
IP - プレフィックスの表記
IP プレフィックス表記 (CIDR 表記とも呼ばれます) は、IP アドレスとそれに関連付けられているネットワーク マスクを表す簡潔な方法です。 形式は <base IP>/<prefix length>で、プレフィックスの長さはネットマスク内の先頭の 1 ビットの数です。 プレフィックスの長さは、ネットワークに属する IP アドレスの範囲を決定します。
IPv4 の場合、プレフィックスの長さは 0 から 32 までの数値です。 したがって、表記 192.168.2.0/24 は、255.255.255.0 のネットマスクを持つ IP アドレス 192.168.2.0 を表します。 このネットマスクには、先頭に 1 ビットが 24 個、プレフィックスの長さが 24 個あります。
IPv6 の場合、プレフィックスの長さは 0 から 128 までの数値です。 そのため、表記 fe80::85d:e82c:9446:7994/120 は、ip アドレス fe80::85d:e82c:9446:7994 を ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00 のネットマスクで表します。 このネットマスクの先頭は 120 ビット、プレフィックス長は 120 です。
返品
true: 最初の IPv4 文字列引数の長い表記が 2 番目の IPv4 文字列引数と等しい場合false: それ以外の場合。null: 2 つの IPv4 文字列のいずれかの変換が成功しなかった場合。
Note
範囲ではない IPv4 アドレスと照合する場合は、パフォーマンスを向上させるために等号演算子 (==) を使用することをお勧めします。
例
簡単な例
print ipv4_is_match('192.168.1.1/24', '192.168.1.255')
出力
| print_0 |
|---|
| true |
IPv4 等値比較のケース - IPv4 文字列内で指定された IP プレフィックス表記
datatable(ip1_string:string, ip2_string:string)
[
'192.168.1.0', '192.168.1.0', // Equal IPs
'192.168.1.1/24', '192.168.1.255', // 24 bit IP-prefix is used for comparison
'192.168.1.1', '192.168.1.255/24', // 24 bit IP-prefix is used for comparison
'192.168.1.1/30', '192.168.1.255/24', // 24 bit IP-prefix is used for comparison
]
| extend result = ipv4_is_match(ip1_string, ip2_string)
出力
| ip1_string | ip2_string | 結果 |
|---|---|---|
| 192.168.1.0 | 192.168.1.0 | true |
| 192.168.1.1/24 | 192.168.1.255 | true |
| 192.168.1.1 | 192.168.1.255/24 | true |
| 192.168.1.1/30 | 192.168.1.255/24 | true |
IPv4 等価比較のケース - IPv4 文字列内で指定された IP プレフィックス表記と、ipv4_is_match() 関数の追加引数を使用
datatable(ip1_string:string, ip2_string:string, prefix:long)
[
'192.168.1.1', '192.168.1.0', 31, // 31 bit IP-prefix is used for comparison
'192.168.1.1/24', '192.168.1.255', 31, // 24 bit IP-prefix is used for comparison
'192.168.1.1', '192.168.1.255', 24, // 24 bit IP-prefix is used for comparison
]
| extend result = ipv4_is_match(ip1_string, ip2_string, prefix)
出力
| ip1_string | ip2_string | prefix | 結果 |
|---|---|---|---|
| 192.168.1.1 | 192.168.1.0 | 31 | true |
| 192.168.1.1/24 | 192.168.1.255 | 31 | true |
| 192.168.1.1 | 192.168.1.255 | 24 | true |