ipv4_compare() (функция для сравнения IPv4)

Переключение служб с помощью раскрывающегося списка версий . Дополнительные сведения о навигации.
Область применения: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

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

Синтаксис

ipv4_compare( Expr1,Expr2[ ,ПрефиксMask])

Параметры

Имя Тип Обязательно Description
Expr1, Expr2 string ✔️ Строковое выражение, представляющее IPv4-адрес. Строки IPv4 можно маскировать с помощью нотации IP-префикса.
ПрефиксMask 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.

Возвраты

  • 0: если длинное представление первого строкового аргумента IPv4 равно второму аргументу строки IPv4
  • 1: если длинное представление первого строкового аргумента IPv4 больше второго аргумента строки IPv4
  • -1: если длинное представление первого строкового аргумента IPv4 меньше второго аргумента строки IPv4
  • null: если преобразование для одной из двух строк IPv4 не выполнено.

Примеры: случаи равенства для сравнения IPv4

Сравнение IP-адресов с использованием нотации 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_compare(ip1_string, ip2_string)

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

ip1_string ip2_string результат
192.168.1.0 192.168.1.0 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

Сравнение IP-адресов с использованием нотации IP-префикса, указанной внутри строк IPv4 и в качестве дополнительного аргумента ipv4_compare() функции

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_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 двадцать четыре 0