Cálculos SQL para dados estruturados - Simple Log Service: Central de Documentação do Alibaba Cloud

Use as instruções SPL extend e where para executar cálculos SQL em dados estruturados.

extend

Cria um novo campo ao avaliar uma expressão SQL. As funções compatíveis estão listadas em Funções SQL compatíveis com SPL.

Sintaxe

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
output	Campo	Sim	Nome do campo de destino. Várias expressões não podem gerar saída no mesmo campo. Importante Se já existir um campo com esse nome nos dados de entrada, ele será sobrescrito.
sql-expr	SQLExpr	Sim	Expressão de processamento de dados. Importante Tratamento de valores nulos em expressões SPL.

Exemplos

Exemplo 1: Uso de uma expressão de cálculo.
```
* | extend Duration = EndTime - StartTime
```

Exemplo 2: Aplicação de uma expressão regular.

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

Exemplo 3: Extração de um caminho JSON e conversão de tipo de campo.

Instrução SPL

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

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

Resultado da saída

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

where

Filtra dados com base em uma expressão booleana SQL. Apenas as entradas avaliadas como true são mantidas. As funções compatíveis estão listadas em Funções SQL compatíveis com SPL.

Sintaxe

| where <sql-expr>

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
sql-expr	SQLExp	Sim	Expressão SQL. As entradas correspondentes são mantidas. Importante Tratamento de valores nulos em expressões SPL.

Exemplos

Exemplo 1: Filtragem por valor de campo.
```
* | where userId='123'
```

Exemplo 2: Filtragem com expressão regular.

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

Exemplo 3: Conversão de tipo de dado e filtragem de erros no servidor.
```
* | where cast(status as BIGINT) >= 500
```

Funções SQL compatíveis com SPL

Categoria	Descrição	Funções comuns
Funções de agregação	Calcula um único valor estatístico a partir de um conjunto de dados.	Função avg Função count Função max Função min Função sum
Funções de string	Localiza, substitui, extrai, concatena e formata dados de texto.	Função concat Função length Função position Função replace Função split
Funções de data e hora	Converte, agrupa e agrega datas e horas em logs.	Função current_date Função date Função day Função date_trunc Função time_series
Funções JSON	Extrai dados de objetos JSON, converte-os ou calcula estatísticas sobre eles.	Função json_array_contains Função json_array_get Função json_array_length Função json_extract Função json_extract_scalar
Funções de expressão regular	Executa correspondência de padrões e processamento de texto.	Função regexp_extract_all Função regexp_extract Função regexp_extract_bool Função regexp_replace Função regexp_split
Funções de comparação ano a ano e período a período	Calcula a variação relativa em dados de séries temporais.	Função compare Função ts_compare
Funções e operadores de array	Cria, manipula, percorre e transforma arrays.	Operador de subscrito Função array_distinct Função array_intersect Função array_join Função reverse
Funções e operadores de mapa	Opera com pares chave-valor.	Função cardinality Função element_at Função histogram Função histogram_u Função map
Funções matemáticas	Realiza cálculos numéricos, arredondamentos, geração de números aleatórios e cálculos trigonométricos.	Função abs Função ceil Função log Função mod Função random
Funções estatísticas	Executa análise de distribuição de dados e cálculos numéricos.	Função corr Função covar_pop Função regr_intercept Função beta_cdf Função inverse_chi_squared_cdf
Funções de conversão de tipos	Converte valores entre diferentes tipos de dados.	Função cast Função try_cast Função typeof
Funções de janela	Agrega ou ordena dados em uma janela.	Funções de agregação Função dense_rank Função lag
Funções IP	Analisa e calcula endereços IP.	Função ip_to_city Função ip_prefix Função ipv6_to_city
Funções url	Analisa estruturas de url.	Função url_encode Função url_decode Função url_extract_fragment Função url_extract_path Função url_extract_query
Funções de aproximação	Realiza agregações aproximadas em grandes conjuntos de dados, priorizando desempenho em detrimento da precisão absoluta.	Função approx_distinct Função approx_percentile Função numeric_histogram Função numeric_histogram_u
Funções binárias	Opera sobre dados binários.	Função from_base64 Função from_big_endian_64 Função from_hex Função to_hex Função sha256
Funções bit a bit	Manipula diretamente bits binários.	Função bit_count Função bitwise_and Função bitwise_not Função bitwise_or Função bitwise_xor
Funções espaciais	Opera sobre dados de geometria espacial.	Função ST_AsText Função ST_GeometryFromText Função ST_Boundary Função ST_Buffer Função ST_Contains
Funções geográficas	Realiza análises de localização geográfica e cálculos cartográficos.	Função geohash
Funções de cor	Representa e converte cores.	Função bar Função color Função render Função rgb
Funções HyperLogLog	Realiza processamento estatístico em grandes conjuntos de dados, priorizando eficiência de memória em detrimento da precisão absoluta.	Função approx_set Função cardinality Função empty_approx_set Função merge
Operadores de comparação	Compara valores entre tipos compatíveis: double, bigint, varchar, timestamp e date.	Operadores básicos Operador ALL Operador ANY Operador BETWEEN Operador DISTINCT
Operadores lógicos	Combina múltiplas condições booleanas para controlar o fluxo lógico.	Operador AND Operador OR Operador NOT
Funções de conversão de unidades	Converte unidades de tamanho de dados ou intervalos de tempo.	Função convert_data_size Função format_duration
Funções de funil de janela	Analisa dados como comportamento do usuário, tráfego de aplicativos e conversão de metas de produtos.	Função window_funnel
Expressões lambda	Permite definir expressões lambda em instruções SQL e SPL e passá-las para outras funções, oferecendo maior flexibilidade.	Função filter Função reduce Função transform
Expressões condicionais	Retorna um valor com base em uma condição especificada.	Expressão CASE WHEN Expressão IF Expressão COALESCE Expressão NULLIF Expressão TRY