Поделиться через

ipv4_is_match()

  • Статья

Область применения: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Соответствует двум строкам IPv4. Две строки IPv4 анализируются и сравниваются при учете объединенной маски IP-префикса, вычисляемой из префиксов аргументов, и необязательный prefix аргумент.

Синтаксис

ipv4_is_match(Префикс ip1,ip2[ ,])

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
ip1, ip2 string ✔️ Выражение, представляющее IPv4-адрес. Строки IPv4 можно маскировать с помощью нотации IP-префикса.
prefix int Целое число от 0 до 32, представляющее число наиболее значимых битов, которые учитываются.

Нотация IP-префикса

Нотация IP-префикса (также известная как нотация CIDR) — это краткий способ представления IP-адреса и связанной с ней сетевой маски. Формат: <base IP>/<prefix length>длина префикса — это число ведущих 1 битов в netmask. Длина префикса определяет диапазон IP-адресов, принадлежащих сети.

Для IPv4 длина префикса составляет от 0 до 32. Поэтому нотация 192.168.2.0/24 представляет IP-адрес 192.168.2.0 с netmask 255.255.255.0. Эта netmask имеет 24 ведущих 1 бита или длину префикса 24.

Для IPv6 длина префикса составляет от 0 до 128. Поэтому нотация fe80::85d:e82c:9446:7994/120 представляет IP-адрес fe80::85d:e85d:9446:7994 с netmask ffff:ffff:ffff. Эта netmask имеет 120 ведущих 1 битов или длину префикса 120.

Возвраты

  • true: если длинное представление первого строкового аргумента IPv4 равно второму аргументу строки IPv4.
  • false:Иначе.
  • null: если преобразование для одной из двух строк IPv4 не выполнено.

Примечание.

При сопоставлении с IPv4-адресом, который не является диапазоном, рекомендуется использовать оператор equals (==), чтобы повысить производительность.

Примеры

Простой пример

print ipv4_is_match('192.168.1.1/24', '192.168.1.255')

Выходные данные

print_0
true

Равенство сравнения IPv4 — нотация IP-префикса, указанная внутри строк IPv4

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 result
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 — нотация IP-префикса, указанная внутри строк IPv4 и дополнительный аргумент 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 result
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

Связанный контент