Simple Log Service:Funciones de expresiones regulares

Funciones de expresiones regulares

SLS admite las siguientes funciones de expresiones regulares, todas basadas en la sintaxis RE2.

Función regexp_extract_all

Extrae todas las subcadenas que coinciden con una expresión regular de una cadena de origen.

Sintaxis

• Devuelve todas las subcadenas coincidentes como un arreglo.

  regexp_extract_all(x, regular expression)

• Devuelve todas las coincidencias de un grupo de captura especificado como un arreglo.

  regexp_extract_all(x, regular expression, n)

Parámetros

Valor devuelto

ARRAY

Ejemplos

• Ejemplo 1: Extraer todos los dígitos del campo server_protocol.

  • Campo de muestra

    server_protocol:HTTP/2.0

  • Instrucción de consulta y análisis (Probar)

    *| SELECT regexp_extract_all(server_protocol, '\d+')

  • Resultados de la consulta y el análisis: La consulta devuelve ["2","0"] en la columna _col0, que corresponden a todas las subcadenas numéricas extraídas de HTTP/2.0.

• Ejemplo 2: Extraer la subcadena 'Chrome' del campo http_user_agent y contar las solicitudes de Chrome.

  • Campo de muestra

    http_user_agent:Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/535.1 (KHTML, like Gecko) Chrome/14.0.803.0 Safari/535.1

  • Instrucción de consulta y análisis (Probar)

    *| SELECT regexp_extract_all(http_user_agent, '(Chrome)',1) AS Chrome, count(*) AS count GROUP BY Chrome

  • Resultados de la consulta y el análisis: La columna Chrome devuelve ["Chrome"] y la columna count devuelve 103440.

Función regexp_extract

Extrae la primera subcadena que coincide con una expresión regular de una cadena de origen.

Sintaxis

• Devuelve la primera subcadena que coincide con una expresión regular.

  regexp_extract(x, regular expression)

• Devuelve la subcadena que coincide con el n-ésimo grupo de captura.

  regexp_extract(x, regular expression, n)

Parámetros

Valor devuelto

Devuelve una cadena VARCHAR.

Ejemplos

server_protocol:HTTP/2.0

* | extend a = regexp_extract(server_protocol, '\d+')

a:  2

request_uri:/request/path-3/file-5

* | extend a = regexp_extract(request_uri, '.*\/(file.*)',1)

message:error'1232

* | extend a = regexp_extract(message, '''\d+') 

1  12-19 10:39:33
   a: '1232

Función regexp_extract_bool

Extrae la primera subcadena coincidente y la convierte a BOOLEAN ("true"/"false", sin distinción entre mayúsculas y minúsculas). Devuelve null si la conversión falla.

Sintaxis

• Convierte la primera coincidencia a BOOLEAN. Devuelve null si falla.

  regexp_extract_bool(x, regular expression)

• Convierte el grupo de captura especificado de la primera coincidencia a BOOLEAN. Devuelve null si falla.

  regexp_extract_bool(x, regular expression, n)

Parámetros

Tipo de valor devuelto

Tipo BOOLEAN.

Ejemplos

• Extraer un valor booleano de un campo.

  • Campo de muestra

    false 

  • Instrucción de consulta y análisis (Probar)

    *| select regexp_extract_bool('false', '[a-zA-Z]+')

  • Resultados de la consulta y el análisis

    Devuelve una única columna _col0 con una fila de datos. El valor es false.

Función regexp_extract_long

Extrae una subcadena que coincide con una expresión regular y la convierte a BIGINT. Devuelve null si la conversión falla.

Sintaxis

• Extrae la primera coincidencia y la convierte a BIGINT.

  regexp_extract_long(x, regular expression)

• Convierte el grupo de captura especificado de la primera coincidencia a BIGINT.

  regexp_extract_long(x, regular expression, n)

Parámetros

Tipo de valor devuelto

BIGINT

Ejemplos

• Extraer el número del campo time.

  • Campo de muestra

    time:19/Dec/2024:06:16:06

  • Instrucción de consulta (Probar)

    *|SELECT regexp_extract_long(time, '(\d{2})/', 1) 

  • Resultados de la consulta y el análisis

    Devuelve una columna llamada _col0 que contiene dos filas, cada una con el valor 19.

Función regexp_extract_double

Extrae una subcadena que coincide con una expresión regular y la convierte a DOUBLE. Devuelve null si la conversión falla.

Sintaxis

• Convierte la primera coincidencia a DOUBLE. Devuelve null si falla.

  regexp_extract_double(x, regular expression)

• Convierte el grupo de captura especificado de la primera coincidencia a DOUBLE. Devuelve null si falla.

  regexp_extract_double(x, regular expression, n)

Parámetros

Tipo de valor devuelto

double

Ejemplos

• Extraer el número de punto flotante del campo server_protocol.

  • Campo de muestra

    server_protocol:HTTP/1.1

  • Instrucción de consulta y análisis (Probar)

    *|SELECT regexp_extract_double(server_protocol, '\d+\.\d+') 

  • Resultados de la consulta y el análisis

    Devuelve una columna llamada _col0. Esta columna contiene dos filas, cada una con el valor 1.1.

Función regexp_extract_map

Extrae subcadenas que coinciden con grupos de captura en una expresión regular y las devuelve como un mapa de clave-valor.

Sintaxis

• Crea un mapa al emparejar las claves proporcionadas con las subcadenas coincidentes de los grupos de captura correspondientes.

regexp_extract_map(x, regular expression, keys)

• Crea un mapa mediante una expresión regular con dos grupos de captura que coinciden con las claves y los valores, respectivamente.

regexp_extract_map(x, regular expression)

Parámetros

Tipo de valor devuelto

MAP(VARCHAR, VARCHAR)

Ejemplos

• Ejemplo 1: Extraer el nombre del protocolo y la versión del campo server_protocol.

  • Campo de muestra

    server_protocol: 'HTTP/2.0'

  • Instrucción de consulta

    select regexp_extract_map(server_protocol, '(\w+)/([\d\.]+)', array['name', 'version']) as protocol

  • Resultados de la consulta y el análisis

    La consulta devuelve el siguiente mapa en la columna protocol: {"name":"HTTP","version":"2.0"}.

• Ejemplo 2: Extraer todos los pares clave-valor del campo content.

  • Campo de muestra

    content: 'verb="GET" URI="/healthz" latency="45.911µs" userAgent="kube-probe/1.30+"'

  • Instrucción de consulta

    select regexp_extract_map(content, '(\w+)="([^"]*)"') as args

  • Datos de salida

    {"latency":"45.911µs","verb":"GET","userAgent":"kube-probe/1.30+","URI":"/healthz"}

Función regexp_like

Comprueba si una cadena coincide con una expresión regular.

Sintaxis

regexp_like(x, regular expression)

Parámetros

Tipo de valor devuelto

BOOLEAN

Ejemplos

server_protocol:HTTP/2.0

* |extend a = regexp_like(server_protocol, '\d+')

1  12-18 19:34:20  1.2.3.4
        a: true

Función regexp_replace

Elimina o reemplaza subcadenas que coinciden con una expresión regular.

Sintaxis

• Elimina todas las subcadenas de una cadena de origen que coinciden con una expresión regular.

  regexp_replace(x, regular expression)

• Reemplaza todas las subcadenas que coinciden con una expresión regular por una cadena de reemplazo.

  regexp_replace(x, regular expression, replace string)

Parámetros

Tipo de valor devuelto

VARCHAR

Ejemplos

region:cn-shanghai

* | extend a = regexp_replace(region, 'cn.*','China')

server_protocol:HTTP/2.0

* | extend a = regexp_replace(server_protocol, '.\d+')

Función regexp_split

Divide una cadena de origen en un arreglo de subcadenas mediante una expresión regular como delimitador.

Sintaxis

regexp_split(x, regular expression)

Parámetros

Tipo de valor devuelto

array

Ejemplo

Utilice una barra diagonal (/) para dividir el valor del campo request_uri.

• Campo de muestra

  request_uri:/request/path-0/file-7

• Instrucción de consulta y análisis (Test)

  * | SELECT regexp_split(request_uri,'/')

• Los resultados de la consulta y el análisis son ["","request","path-0","file-7"].