has_any_ipv4()

S’applique à : ✅Microsoft Fabric

Retourne une valeur indiquant si l’une des adresses IPv4 spécifiées apparaît dans un texte.

Les entrées d’adresse IP dans un texte doivent être correctement délimitées par des caractères non alphanumériques. Par exemple, les adresses IP correctement délimitées sont les suivantes :

• « Ces demandes proviennent de : 192.168.1.1, 10.1.1.115 et 10.1.1.201 »
• « 05:04:54 127.0.0.1 GET /favicon.ico 404 »

Conseils sur les performances

Remarque

Lorsque plus de 128 termes de recherche sont utilisés, l’optimisation de la recherche d’index de texte est désactivée, ce qui peut entraîner une réduction des performances des requêtes.

Syntaxe

has_any_ipv4( source, ip_address [,ip_address_2, ...])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Catégorie	Requise	Descriptif
source	string	✔️	Valeur à rechercher.
ip_address	chaîne ou dynamique	✔️	Une adresse IP, ou un tableau d’adresses IP, pour lesquelles effectuer une recherche.

Retours

true si l’une des adresses IP spécifiées est une adresse IPv4 valide et qu’elle a été trouvée dans la source. Sinon, la fonction retourne false.

Exemples

L’exemple suivant illustre l’utilisation has_any_ipv4 avec plusieurs valeurs scalaires, où chaque adresse IP est fournie en tant qu’argument de chaîne distinct. Les adresses IP du texte sont correctement délimitées par des caractères non alphanumériques.

Exécuter la requête

print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '127.0.0.2')

résultat
vrai

L’exemple suivant illustre l’utilisation has_any_ipv4 avec un tableau dynamique d’adresses IP. Les adresses IP du texte sont correctement délimitées par des caractères non alphanumériques.

Exécuter la requête

print result=has_any_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', dynamic(['127.0.0.1', '127.0.0.2']))

résultat
vrai

L’exemple suivant illustre l’utilisation has_any_ipv4 avec une adresse IPv4 non valide. Les adresses IP du texte sont correctement délimitées par des caractères non alphanumériques.

Exécuter la requête

print result=has_any_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', dynamic(["127.0.0.256", "192.168.1.1"]))

résultat
faux

L’exemple suivant illustre l’utilisation has_any_ipv4 avec une adresse IP incorrectement délimitée. Les adresses IP du texte ne sont pas correctement délimitées par des caractères non alphanumériques.

Exécuter la requête

print result=has_any_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1', '192.168.1.1') // false, improperly delimited IP address

résultat
faux