Todos os produtos
Search
Central de documentação

Simple Log Service:Control instructions

Última atualização: Jul 03, 2026

As instruções de controle SPL definem e gerenciam conjuntos de dados nomeados para uso em expressões de consulta.

.let

Define um conjunto de dados nomeado como entrada para expressões SPL subsequentes. Conjuntos de dados SPL.

Sintaxe

.let <dataset>=<spl-expr>

Parâmetros

Parâmetro

Tipo

Obrigatório

Descrição

dataset

String

Sim

Nome do conjunto de dados. Aceita letras, dígitos e sublinhados (_). Deve iniciar com uma letra e diferencia maiúsculas de minúsculas.

spl-expr

SPLExp

Sim

Expressão SPL que gera o conjunto de dados.

Exemplo

Filtre e classifique logs de acesso por código de status e exiba os resultados.

  • Instrução SPL

    -- Define the SPL processing result as the named dataset 'src' to use as input for subsequent SPL expressions.
    .let src = * 
    | where status=cast(status as BIGINT);
    
    -- Use the named dataset 'src' as input. Filter for data where the status field is 5xx. Define the result as the dataset 'err'. Do not output the result.
    .let err = $src
    | where status >= 500
    | extend msg='ERR';
    
    -- Use the named dataset 'src' as input. Filter for data where the status field is 2xx. Define the result as the dataset 'ok'. Do not output the result.
    .let ok = $src
    | where status >= 200 and status < 300
    | extend msg='OK';
    
    -- Output the named datasets 'err' and 'ok'.
    $err;
    $ok;
  • Dados de entrada

    # Entry 1
    status: '200'
    body: 'this is a test'
    
    # Entry 2
    status: '500'
    body: 'internal error'
    
    # Entry 3
    status: '404'
    body: 'not found'
  • Saída

    # Entry 1: Dataset is 'err'
    status: '500'
    body: 'internal error'
    msg: 'ERR'
    
    # Entry 2: Dataset is 'ok'
    status: '200'
    body: 'this is a test'
    msg: 'OK'