Instrucciones de cálculo SQL para datos estructurados - Simple Log Service

Use las instrucciones SPL extend y where para ejecutar cálculos SQL sobre datos estructurados.

extend

Crea un campo nuevo al evaluar una expresión SQL. Las funciones compatibles se enumeran en SQL functions supported by SPL.

Sintaxis

| extend <output>=<sql-expr>, ...

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
output	Field	Sí	Nombre del campo de destino. Varias expresiones no pueden enviar su resultado al mismo campo. Importante Si ya existe un campo con este nombre en los datos de entrada, se sobrescribe.
sql-expr	SQLExpr	Sí	Expresión de procesamiento de datos. Importante Handle null values in SPL expressions.

Ejemplos

Ejemplo 1: use una expresión de cálculo.
```
* | extend Duration = EndTime - StartTime
```

Ejemplo 2: use una expresión regular.

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

Ejemplo 3: extraiga datos desde una ruta JSON y convierta el tipo de un campo.

Instrucción SPL

*
| extend a=json_extract(content, '$.body.a'), b=json_extract(content, '$.body.b')
| extend b=cast(b as BIGINT)

Datos de entrada
```
content: '{"body": {"a": 1, "b": 2}}'
```

Resultado de salida

content: '{"body": {"a": 1, "b": 2}}'
a: '1'
b: 2

where

Filtra los datos con base en una expresión SQL booleana. Solo se conservan las entradas que se evalúan como true. Las funciones compatibles se enumeran en SQL functions supported by SPL.

Sintaxis

| where <sql-expr>

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
sql-expr	SQLExp	Sí	Expresión SQL. Se conservan las entradas que coinciden. Importante Handle null values in SPL expressions.

Ejemplos

Ejemplo 1: filtre por el valor de un campo.
```
* | where userId='123'
```

Ejemplo 2: filtre con una expresión regular.

* | where regexp_like(server_protocol, '\d+')

Ejemplo 3: convierta un tipo de dato y filtre errores del servidor.
```
* | where cast(status as BIGINT) >= 500
```

Funciones SQL compatibles con SPL

Categoría	Descripción	Funciones comunes
Aggregation functions	Calcula un único valor estadístico a partir de un conjunto de datos.	avg function count function max function min function sum function
String functions	Busca, reemplaza, extrae, concatena y da formato a datos de texto.	concat function length function position function replace function split function
Date and time functions	Convierte, agrupa y agrega fechas y horas en los registros.	current_date function date function day function date_trunc function time_series function
JSON functions	Extrae datos de objetos JSON, los convierte o calcula sus estadísticas.	json_array_contains function json_array_get function json_array_length function json_extract function json_extract_scalar function
Regular expression functions	Hace coincidir patrones y procesa texto.	regexp_extract_all function regexp_extract function regexp_extract_bool function regexp_replace function regexp_split function
Year-over-year and period-over-period functions	Calcula el cambio relativo en datos de series temporales.	compare function ts_compare function
Array functions and operators	Crea, manipula, recorre y transforma arreglos.	Subscript operator array_distinct function array_intersect function array_join function reverse function
Map functions and operators	Trabaja con pares clave-valor.	cardinality function element_at function histogram function histogram_u function map function
Mathematical functions	Ejecuta cálculos numéricos, redondeo, generación de números aleatorios y cálculos trigonométricos.	abs function ceil function log function mod function random function
Statistical functions	Analiza la distribución de datos y ejecuta cálculos numéricos.	corr function covar_pop function regr_intercept function beta_cdf function inverse_chi_squared_cdf function
Type conversion functions	Convierte valores entre distintos tipos de datos.	cast function try_cast function typeof function
Window functions	Agrega u ordena datos dentro de una ventana.	Aggregation functions dense_rank function lag function
IP functions	Analiza sintácticamente y calcula direcciones IP.	ip_to_city function ip_prefix function ipv6_to_city function
URL functions	Analiza sintácticamente estructuras URL.	url_encode function url_decode function url_extract_fragment function url_extract_path function url_extract_query function
Approximation functions	Ejecuta agregaciones aproximadas en conjuntos de datos grandes y prioriza el rendimiento sobre la precisión.	approx_distinct function approx_percentile function numeric_histogram function numeric_histogram_u function
Binary functions	Opera con datos binarios.	from_base64 function from_big_endian_64 function from_hex function to_hex function sha256 function
Bitwise functions	Manipula bits binarios directamente.	bit_count function bitwise_and function bitwise_not function bitwise_or function bitwise_xor function
Spatial functions	Opera con datos de geometría espacial.	ST_AsText function ST_GeometryFromText function ST_Boundary function ST_Buffer function ST_Contains function
Geographic functions	Analiza ubicaciones geográficas y ejecuta cálculos cartográficos.	geohash function
Color functions	Representa y convierte colores.	bar function color function render function rgb function
HyperLogLog functions	Procesa estadísticamente conjuntos de datos grandes y prioriza la eficiencia de memoria sobre la precisión.	approx_set function cardinality function empty_approx_set function merge function
Comparison operators	Compara valores entre tipos comparables: double, bigint, varchar, timestamp y date.	Basic operators ALL operator ANY operator BETWEEN operator DISTINCT operator
Logical operators	Combina varias condiciones booleanas para controlar el flujo lógico.	AND operator OR operator NOT operator
Unit conversion functions	Convierte unidades de tamaño de datos o intervalos de tiempo.	convert_data_size function format_duration function
Window funnel functions	Analiza datos como el comportamiento de usuarios, el tráfico de aplicaciones y la conversión de objetivos de productos.	window_funnel function
Lambda expressions	Permite definir expresiones lambda en instrucciones SQL y SPL, así como pasarlas a otras funciones para mayor flexibilidad.	filter function reduce function transform function
Conditional expressions	Devuelve un valor según una condición especificada.	CASE WHEN expression IF expression COALESCE expression NULLIF expression TRY expression