Instruções e funções SPL | Simple Log Service - Simple Log Service: Central de Documentação do Alibaba Cloud

Tipos de parâmetros

As instruções SPL utilizam os seguintes tipos de parâmetros.

Tipo de parâmetro	Descrição
Bool	Parâmetro booleano que funciona como uma chave liga/desliga na SPL.
Char	Parâmetro de caractere ASCII, delimitado por aspas simples (''). Exemplos: `'a'` para o caractere a, `'\t'` para o caractere de tabulação, `'\11'` para o caractere ASCII octal 11 e `'\x09'` para o caractere ASCII hexadecimal 09.
Integer	Parâmetro numérico inteiro.
String	Parâmetro de texto, delimitado por aspas simples (''). Exemplo: `'this is a string'`.
RegExp	Parâmetro de expressão regular RE2, delimitado por aspas simples (''). Exemplo: `'([\d.]+)'`. Detalhes da sintaxe RE2: Syntax.
JSONPath	Parâmetro de caminho JSON, delimitado por aspas simples (''). Exemplo: `'$.body.values[0]'`. Detalhes da sintaxe JSONPath: JsonPath.
Field	Parâmetro de nome de campo. Exemplo: `\| project level, content`. Delimite com aspas duplas ("") os nomes de campo que contêm caracteres especiais (exceto letras, dígitos e sublinhados). Exemplo: `\| project "a:b:c"`. Nota As regras de diferenciação entre maiúsculas e minúsculas em nomes de campo estão documentadas em Referência geral.
FieldPattern	Nome de campo ou padrão com curinga. O curinga () corresponde a zero ou mais caracteres. Delimite os padrões com aspas duplas (""). Exemplo: `\| project "__tag__:`". Nota As regras de diferenciação entre maiúsculas e minúsculas em nomes de campo estão documentadas em Referência geral.
SPLExp	Parâmetro de expressão SPL.
SQLExp	Parâmetro de expressão SQL.

Lista de instruções SPL

Categoria da instrução	Nome da instrução	Descrição	Transformação de dados	Ingest Processor	Consumer Processor	Modo de varredura (SCAN)	Coleta do Logtail
Instrução de controle	.let	Defina um conjunto de dados nomeado. Os detalhes sobre conjuntos de dados SPL estão disponíveis na Referência geral.	Sim	×	×	√	×
Instrução de operação de campo	project	Mantém os campos correspondentes a um padrão especificado e renomeia campos selecionados. As expressões de retenção de campos são processadas antes das expressões de renomeação.	Compatível	Compatível	Compatível	Compatível	Compatível
	project-away	Remove os campos correspondentes a um padrão especificado e mantém todos os demais.	Compatível	Compatível	Compatível	Compatível	✓
	project-rename	Renomeia campos específicos e preserva todos os outros.	Compatível	Compatível	Compatível	Compatível	Compatível
	expand-values	Expande o objeto JSON de nível superior de um campo específico em vários resultados.	Compatível	×	Compatível	Não compatível	×
Instrução de cálculo SQL para dados estruturados	extend	Cria novos campos a partir de resultados de expressões SQL. As funções SQL compatíveis estão listadas na Lista de funções SQL suportadas pela SPL.	Compatível	Compatível	Compatível	Compatível	Compatível
Instrução de cálculo SQL para dados estruturados	where	Filtra dados por meio de uma expressão SQL e retém as entradas correspondentes. As funções SQL compatíveis estão listadas na Lista de funções SQL suportadas pela SPL.	Compatível	✓	Compatível	Compatível	Compatível
Instrução de extração de dados semiestruturados	parse-regexp	Extrai informações correspondentes a grupos de expressões regulares de um campo específico.	√	√	Compatível	✓	Compatível
	parse-csv	Extrai informações no formato CSV de um campo específico.	√	Compatível	Compatível	√	Compatível
	parse-json	Extrai campos JSON de nível superior de um campo específico.	Compatível	Compatível	√	√	Compatível
	parse-kv	Extrai informações de pares chave-valor de um campo específico.	Compatível	Compatível	Compatível	Compatível	Compatível
Nova instrução de transformação de dados	pack-fields	Agrupa campos de log em um novo campo por meio de serialização JSON. Ideal para cenários de transmissão estruturada, como a construção de corpos de requisição de API.	✓	×	✓	Compatível	×
	log-to-metric	Converte o formato de log para o formato de armazenamento de séries temporais.	Compatível	×	×	×	×
	metric-to-metric	Processa dados de métricas existentes, permitindo adicionar, modificar ou remover tags.	Compatível	×	×	×	×
Instrução de agregação	stats	Executa análises estatísticas em campos de log, semelhante às funções de agregação SQL como `COUNT`, `SUM` e `AVG`. Permite agrupamento e agregação em campos específicos.	×	×	Não compatível	Compatível	×
	sort	Ordena os resultados da consulta pelos valores dos campos ou resultados estatísticos em ordem crescente (`asc`) ou decrescente (`desc`).	×	×	×	Compatível	×
	limit	Limita o número de linhas de log retornadas nos resultados da consulta. Utilize `limit` para controlar o volume de dados e evitar problemas de desempenho causados por grandes conjuntos de resultados.	×	×	×	Compatível	×

Visão geral das funções

As instruções SPL suportam a maioria das funções SQL. A disponibilidade e os cenários aplicáveis de cada função estão descritos em suas respectivas documentações.

Categoria	Descrição	Funções comuns
Funções de agregação	Calcula um único resultado a partir de um conjunto de valores de entrada.	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, trunca e agrega valores de data e hora.	Função current_date Função date Função day Função date_trunc Função time_series
Funções JSON	Extrai, transforma e consulta dados de objetos e arrays JSON.	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	Corresponde, extrai e substitui texto usando expressões regulares.	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 mês a mês	Compara dados de séries temporais em diferentes períodos de tempo.	Função compare Função ts_compare
Funções e operadores de array	Acessa, filtra e transforma elementos de array.	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 em pares chave-valor (mapas).	Função cardinality Função element_at Função histogram Função histogram_u Função map
Funções matemáticas	Arredonda valores, gera números aleatórios e executa cálculos trigonométricos.	Função abs Função ceil Função log Função mod Função random
Funções matemáticas e estatísticas	Analisa distribuições de dados com funções de correlação, regressão e probabilidade.	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 tipo	Converte valores de um tipo de dados para outro.	Função cast Função try_cast Função typeof
Funções de janela	Calcula agregações ou classificações sobre uma janela deslizante de linhas.	Funções de agregação Função dense_rank Função lag
Funções IP	Analisa e processa endereços IP.	Função ip_to_city Função ip_prefix Função ipv6_to_city
Funções URL	Extrai componentes de URLs.	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 estimativa	Estima contagens distintas, percentis e histogramas para grandes conjuntos de dados.	Função approx_distinct Função approx_percentile Função numeric_histogram Função numeric_histogram_u
Funções binárias	Opera em 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 de operação bit a bit	Executa operações bit a bit em inteiros.	Função bit_count Função bitwise_and Função bitwise_not Função bitwise_or Função bitwise_xor
Funções de geometria espacial	Opera em objetos 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	Executa análises e cálculos geoespaciais.	Função geohash
Funções de cor	Cria e manipula representações de cores.	Função bar Função color Função render Função rgb
Funções HyperLogLog	Estima a cardinalidade em grandes conjuntos de dados com uso mínimo de memória.	Função approx_set Função cardinality Função empty_approx_set Função merge
Operadores de comparação	Compara valores entre tipos (double, bigint, varchar, timestamp, date) e retorna um valor booleano.	Operadores básicos Operador ALL Operador ANY Operador BETWEEN Operador DISTINCT
Operadores lógicos	Combina múltiplas expressões booleanas para controlar o fluxo lógico.	Operador AND Operador OR Operador NOT
Funções de conversão de unidades	Converte tamanhos de dados ou intervalos de tempo entre diferentes unidades.	Função convert_data_size Função format_duration
Funções de funil de janela	Rastreia ações sequenciais do usuário para análise de funil de conversão.	Função window_funnel
Expressões lambda	Define funções inline para operações de array de ordem superior em SQL ou SPL.	Função filter Função reduce Função transform
Expressões condicionais	Retorna valores diferentes com base em uma condição especificada.	Expressão CASE WHEN Expressão IF Expressão COALESCE Expressão NULLIF Expressão TRY