Sdílet prostřednictvím

ipv4_is_in_any_range()

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Zkontroluje, jestli je řetězcová adresa IPv4 v některém ze zadaných rozsahů adres IPv4.

Tipy týkající se výkonu

Poznámka:

Pokud se používá více než 128 hledaných termínů, je optimalizace vyhledávání v textovém indexu zakázaná, což může vést ke snížení výkonu dotazů.

Syntaxe

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

ipv4_is_in_any_range(Ipv4Address , Ipv4Ranges )

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Type Požadováno Popis
Ipv4Address string ✔️ Výraz představující adresu IPv4.
Ipv4Range string ✔️ Rozsah IPv4 nebo seznam rozsahů IPv4 napsaných zápisem předpon IP.
Ipv4Ranges dynamic ✔️ Dynamické pole obsahující rozsahy IPv4 napsané zápisem předpony IP.

Poznámka:

Vyžaduje se jeden nebo více řetězců IPv4Range nebo dynamické pole IPv4Ranges .

Notace předpon IP adres

Notace předpon IP (označovaná také jako zápis CIDR) je stručný způsob reprezentace IP adresy a přidružené síťové masky. Formát je <base IP>/<prefix length>, kde délka předpony je počet úvodních 1 bitů v maskách sítě. Délka předpony určuje rozsah IP adres, které patří do sítě.

U protokolu IPv4 je délka předpony číslo od 0 do 32. Zápis 192.168.2.0/24 tedy představuje IP adresu 192.168.2.0 s maskou sítě 255.255.255.255.0. Tato maska sítě má 24 úvodních 1 bitů nebo délku předpony 24.

U protokolu IPv6 je délka předpony číslo od 0 do 128. Zápis fe80::85d:e82c:9446:7994/120 představuje IP adresu fe80::85d:e82c:9446:7994 s netmask ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00. Tato maska sítě má 120 úvodních 1 bitů nebo délku předpony 120.

Návraty

  • true: Pokud je adresa IPv4 v rozsahu některé ze zadaných sítí IPv4.
  • false:Jinak.
  • null: Pokud převod jednoho ze dvou řetězců IPv4 nebyl úspěšný.

Příklady

Syntaxe pomocí seznamu řetězců

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')

Výstup

Výsledek
true

Syntaxe s využitím dynamického pole

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

Výstup

Výsledek
true

Rozšíření tabulky s kontrolou rozsahu 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)

Výstup

IP IsLocal
10.1.2.3 true
192.168.1.5 true
123.1.11.21 false (nepravda)
1.1.1.1 false (nepravda)

Související obsah