has_ipv4_prefix()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Retorna um valor indicando se um prefixo de endereço IPv4 especificado aparece em um texto.

Um prefixo de endereço IP válido é um endereço IPv4 completo (192.168.1.11) ou seu prefixo terminado com um ponto (192., 192.168. ou 192.168.1.).

As entradas de endereço IP em um texto devem ser delimitadas corretamente com caracteres não alfanuméricos. Por exemplo, os endereços IP delimitados corretamente são:

• "Essas solicitações vieram de: 192.168.1.1, 10.1.1.115 e 10.1.1.201"
• "05:04:54 127.0.0.1 GET /favicon.ico 404"

Sintaxe

has_ipv4_prefix( fonte,ip_address_prefix)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
origem	string	✔️	O texto a ser pesquisado.
ip_address_prefix	string	✔️	O prefixo do endereço IP para o qual pesquisar.

Devoluções

truese o ip_address_prefix for um prefixo de endereço IPv4 válido e tiver sido encontrado na origem. Caso contrário, a função retorna false.

Dica

Para pesquisar muitos prefixos IPv4 de uma só vez, use a função has_any_ipv4_prefix( ).

Exemplos

O exemplo a seguir mostra como usar a has_ipv4_prefix função para pesquisar um prefixo de endereço IPv4 específico dentro do texto.

Executar a consulta

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

resultado
verdadeiro

O exemplo a seguir demonstra o uso has_ipv4_prefix com um prefixo de endereço IP inválido. O endereço IP no texto é delimitado corretamente por caracteres não numéricos.

Executar a consulta

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

resultado
falso

O exemplo a seguir demonstra o uso has_ipv4_prefix com um endereço IP inválido. O endereço IP no texto é delimitado corretamente por caracteres não numéricos.

Executar a consulta

print result=has_ipv4_prefix('05:04:54 127.0.0.256 GET /favicon.ico 404', '127.0.')

resultado
falso

O exemplo a seguir demonstra o uso has_ipv4_prefix com um endereço IP delimitado incorretamente. O endereço IP no texto é delimitado incorretamente por caracteres não numéricos.

Executar a consulta

print result=has_ipv4_prefix('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.')

resultado
falso