Partilhar via

tem_prefixo_ipv4()

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

Retorna um valor que indica 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, endereços IP delimitados corretamente são:

  • "Estes pedidos provieram de: 192.168.1.1, 10.1.1.115 e 10.1.1.201"
  • "05:04:54 127.0.0.1 OBTER /favicon.ico 404"

Sintaxe

has_ipv4_prefix( fonte,ip_address_prefix)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
fonte string ✔️ O texto a pesquisar.
ip_address_prefix string ✔️ O prefixo do endereço IP para o qual pesquisar.

Devoluções

true se 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.

Sugestão

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

Exemplos

O exemplo a seguir mostra como usar a função para procurar um prefixo has_ipv4_prefix de endereço IPv4 específico no 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 é devidamente delimitado por caracteres não alfanumé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 é devidamente delimitado por caracteres não alfanumé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 é indevidamente delimitado por caracteres não alfanuméricos.

Executar a consulta

print result=has_ipv4_prefix('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.')
Resultado
falso
  • Last updated on