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

ipv4_is_in_any_range()

  • Статья

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

Проверяет, находится ли адрес строки IPv4 в любом из указанных диапазонов адресов IPv4.

Советы по производительности

Примечание.

Если используются более 128 терминов поиска, оптимизация поиска текстовых индексов отключена, что может привести к снижению производительности запросов.

Синтаксис

ipv4_is_in_any_range(Ipv4Address , Ipv4Range [ , Ipv4Range ...])

ipv4_is_in_any_range(Ipv4Address , Ipv4Ranges )

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

Параметры

Имя (название) Type Обязательно Описание
Ipv4Address string ✔️ Выражение, представляющее IPv4-адрес.
Ipv4Range string ✔️ Диапазон IPv4 или список диапазонов IPv4, написанных с нотацией IP-префикса.
Ipv4Ranges dynamic ✔️ Динамический массив, содержащий диапазоны IPv4, записанные с нотацией IP-префикса.

Примечание.

Требуется либо одна или несколько строк IPv4Range , либо динамический массив IPv4Ranges .

Нотация 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 не выполнено.

Примеры

Синтаксис с помощью списка строк

print Result=ipv4_is_in_any_range('192.168.1.6', '192.168.1.1/24', '10.0.0.1/8', '127.1.0.1/16')

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

Результат
true

Синтаксис с помощью динамического массива

print Result=ipv4_is_in_any_range("127.0.0.1", dynamic(["127.0.0.1", "192.168.1.1"]))

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

Результат
true

Расширение таблицы с проверкой диапазона IPv4

let LocalNetworks=dynamic([
    "192.168.1.1/16",
    "127.0.0.1/8",
    "10.0.0.1/8"
]);
let IPs=datatable(IP:string) [
    "10.1.2.3",
    "192.168.1.5",
    "123.1.11.21",
    "1.1.1.1"
];
IPs
| extend IsLocal=ipv4_is_in_any_range(IP, LocalNetworks)

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

IP-адрес IsLocal
10.1.2.3 true
192.168.1.5 true
123.1.11.21 false
1.1.1.1 false

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