ipv6_compare()

2つの IPv6 または IPv4 ネットワーク アドレス文字列を比較します。 2つの IPv6 文字列は、引数のプレフィックスから計算された IP プレフィックスの組み合わせと、省略可能な prefix 引数を考慮して、解析と比較が実行されます。

Note

関数は、IPv6 と IPv4 の両方のネットワーク アドレスを表す引数を受け入れて比較できます。 ただし、呼び出し元が引数が IPv4 形式であることを認識している場合は、 ipv4_is_compare () 関数を使用します。 この関数を実行すると、実行時のパフォーマンスが向上します。

構文

ipv6_compare(Ip1,ip2[ ,プレフィックス])

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

パラメーター

名前	型	必須	説明
ip1、 ip2	string	✔️	IPv6 または IPv4 アドレスを表す式。 IPｖ6 および IPv4 文字列は IP プレフィックス表記を使用してマスクできます。
prefix	int		考慮される最上位ビットの数を表す 0 ~ 128 の整数。

IP プレフィックスの表記

IP プレフィックス表記 (CIDR 表記とも呼ばれます) は、IP アドレスとそれに関連付けられているネットワーク マスクを表す簡潔な方法です。 形式は です <base IP>/<prefix length>。プレフィックスの長さは、ネットマスク内の先頭の 1 ビットの数です。 プレフィックスの長さは、ネットワークに属する IP アドレスの範囲を決定します。

IPv4 の場合、プレフィックスの長さは 0 ~ 32 の数値です。 そのため、表記 192.168.2.0/24 は IP アドレス 192.168.2.0 を表し、ネットマスクは 255.255.255.0 です。 このネットマスクの先頭は 24 ビット、プレフィックス長は 24 です。

IPv6 の場合、プレフィックスの長さは 0 ~ 128 の数値です。 そのため、表記 fe80::85d:e82c:9446:7994/120 は、ffff:ffff:ffff:ffff:ff00 のネットマスクを持つ IP アドレス fe80::85d:e82c:9446:7994 を表します。 このネットマスクの先頭は 120 ビット、プレフィックス長は 120 です。

戻り値

• 0: 最初の IPv6 文字列引数の長文表現が 2 番目の IPv6 文字列引数と等しい場合。
• 1: 最初の IPv6 文字列引数の長文表現が 2 番目の IPv6 文字列引数より大きい場合。
• -1: 最初の IPv6 文字列引数の長文表現が 2 番目の IPv6 文字列引数より小さい場合。
• null: 2 つの IPv6 文字列のいずれかの変換が成功しなかった場合。

例: IPv6/IPv4 等値比較の事例

IPv6/IPv4 文字列内で指定された IP プレフィックス表記を使用して、IP を比較します。

クエリを実行する

datatable(ip1_string:string, ip2_string:string)
[
 // IPv4 are compared as IPv6 addresses
 '192.168.1.1',    '192.168.1.1',       // Equal IPs
 '192.168.1.1/24', '192.168.1.255',     // 24 bit IP4-prefix is used for comparison
 '192.168.1.1',    '192.168.1.255/24',  // 24 bit IP4-prefix is used for comparison
 '192.168.1.1/30', '192.168.1.255/24',  // 24 bit IP4-prefix is used for comparison
  // IPv6 cases
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7994',         // Equal IPs
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998',     // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7998/120',     // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998/120', // 120 bit IP6-prefix is used for comparison
 // Mixed case of IPv4 and IPv6
 '192.168.1.1',      '::ffff:c0a8:0101', // Equal IPs
 '192.168.1.1/24',   '::ffff:c0a8:01ff', // 24 bit IP-prefix is used for comparison
 '::ffff:c0a8:0101', '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 = ipv6_compare(ip1_string, ip2_string)

出力

ip1_string	ip2_string	結果
192.168.1.1	192.168.1.1	0
192.168.1.1/24	192.168.1.255	0
192.168.1.1	192.168.1.255/24	0
192.168.1.1/30	192.168.1.255/24	0
fe80::85d:e82c:9446:7994	fe80::85d:e82c:9446:7994	0
fe80::85d:e82c:9446:7994/120	fe80::85d:e82c:9446:7998	0
fe80::85d:e82c:9446:7994	fe80::85d:e82c:9446:7998/120	0
fe80::85d:e82c:9446:7994/120	fe80::85d:e82c:9446:7998/120	0
192.168.1.1	::ffff:c0a8:0101	0
192.168.1.1/24	::ffff:c0a8:01ff	0
::ffff:c0a8:0101	192.168.1.255/24	0
::192.168.1.1/30	192.168.1.255/24	0

IPv6/IPv4 文字列内で指定された IP プレフィックス表記と、ipv6_compare() 関数の追加引数を使用して、IP を比較する

クエリを実行する

datatable(ip1_string:string, ip2_string:string, prefix:long)
[
 // IPv4 are compared as IPv6 addresses 
 '192.168.1.1',    '192.168.1.0',   31, // 31 bit IP4-prefix is used for comparison
 '192.168.1.1/24', '192.168.1.255', 31, // 24 bit IP4-prefix is used for comparison
 '192.168.1.1',    '192.168.1.255', 24, // 24 bit IP4-prefix is used for comparison
   // IPv6 cases
 'fe80::85d:e82c:9446:7994', 'fe80::85d:e82c:9446:7995',     127, // 127 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/127', 'fe80::85d:e82c:9446:7998', 120, // 120 bit IP6-prefix is used for comparison
 'fe80::85d:e82c:9446:7994/120', 'fe80::85d:e82c:9446:7998', 127, // 120 bit IP6-prefix is used for comparison
 // Mixed case of IPv4 and IPv6
 '192.168.1.1/24',   '::ffff:c0a8:01ff', 127, // 127 bit IP6-prefix is used for comparison
 '::ffff:c0a8:0101', '192.168.1.255',    120, // 120 bit IP6-prefix is used for comparison
 '::192.168.1.1/30', '192.168.1.255/24', 127, // 120 bit IP6-prefix is used for comparison
]
| extend result = ipv6_compare(ip1_string, ip2_string, prefix)

出力

ip1_string	ip2_string	prefix	結果
192.168.1.1	192.168.1.0	31	0
192.168.1.1/24	192.168.1.255	31	0
192.168.1.1	192.168.1.255	24	0
fe80::85d:e82c:9446:7994	fe80::85d:e82c:9446:7995	127	0
fe80::85d:e82c:9446:7994/127	fe80::85d:e82c:9446:7998	120	0
fe80::85d:e82c:9446:7994/120	fe80::85d:e82c:9446:7998	127	0
192.168.1.1/24	::ffff:c0a8:01ff	127	0
::ffff:c0a8:0101	192.168.1.255	120	0
::192.168.1.1/30	192.168.1.255/24	127	0

関連コンテンツ

• IPv4/IPv6 関数の概要