Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:Veri dönüştürme sözdizimi

Son Güncelleme:Sep 30, 2026

Simple Log Service (SLS) DSL, Python tabanlıdır ve veri dönüştürme görevlerini basitleştirmek için 200'den fazla yerleşik işlev sağlar. Bu konuda DSL'in dil modları, işlev kategorileri ve çalışma ilkeleri açıklanmaktadır.

Dil modları

SLS DSL, Python ile uyumludur. Standart modda SLS DSL, Python'un bir alt kümesidir. Temel veri yapıları ve ifadeler dışındaki diğer tüm sözdizimi kuralları işlevler aracılığıyla uygulanır.

Kategori

Python sözdizimi

Standart mod

Veri yapısı

Sayı, dize ve Boolean

Desteklenir.

""" ile başlayan veya biten dizeler desteklenmez.

Tuple, liste, küme ve sözlük

Desteklenir.

set yapısı desteklenmez; örneğin {1,2,3}.

Nesne

Yalnızca tablo ve datetime nesneleri gibi yerleşik genişletilmiş veri yapıları desteklenir.

Temel sözdizimi

Artı (+), eksi (-), çarpma (×) ve bölme (/) gibi operatörler

Kodda yalnızca ==, !=, > gibi karşılaştırma operatörleri ile and, or ve not gibi mantıksal operatörler doğrudan kullanılabilir. Diğer operatörleri kullanmak için işlev çağrısı yapmanız gerekir.

Açıklamalar

Desteklenir.

Değişken atama

Desteklenmez. Değeri bir işlev çağrısı aracılığıyla aktarmanız gerekir.

Ön koşullar

Desteklenir. İşlevler: e_if, e_if_else ve e_switch.

Döngüler

Dolaylı olarak desteklenir. Döngüleri uygulamak için iç içe geçmiş yerleşik işlevler kullanmanız gerekir. Aşağıdaki örnek işlevler, bir dizideki öğelerin nasıl yineleneceğini gösterir:

e_if(op_ge(op_len(json_parse(v("x"))), 1), e_set("x0", lst_get(v("x"), 0)))
e_if(op_ge(op_len(json_parse(v("x"))), 2), e_set("x1", lst_get(v("x"), 1)))

İşlev

Python'un standart yerleşik işlevleri

Desteklenmez. Bunun yerine SLS DSL tarafından sağlanan 200'den fazla yerleşik işlevi kullanabilirsiniz.

İşlev çağrıları

Desteklenir. Parametre açma kullanan işlev çağrıları desteklenmez.

def veya lambda gibi kullanıcı tanımlı işlevler

Desteklenmez. Ancak, herhangi bir kombinasyonda çağrılabilen 200'den fazla genel işlem ve ifade işlevi sunulur.

Modül

Python standart kitaplığının içe aktarılması ve kullanılması

Desteklenmez.

İş parçacıkları ve işlemler oluşturma

Desteklenmez.

Üçüncü taraf kitaplıkların içe aktarılması

Desteklenmez.

Harici ağ bağlantısı veya harici komut çağrısı

Yerleşik kaynak bağlayıcılarını içerir.

İşlev kategorileri

Standart modda SLS DSL, tüm işlemleri işlevleri çağırarak gerçekleştirir. DSL, 200'den fazla yerleşik işlev sunar; bu işlevler genel işlem işlevleri ve ifade işlevleri olarak sınıflandırılır.

  • Genel işlem işlevleri

    Genel işlem işlevleri, günlükleri almak, işlemek ve döndürmek için kullanılır. Bir dönüştürme kuralındaki her adımı yalnızca genel işlem işlevleriyle oluşturabilirsiniz.

  • İfade işlevleri

    Genel amaçlı işlevler belirli parametreleri kabul eder. Bunları birleştirerek çağırmak ve bir genel işlem işlevine parametre olarak iletmek daha esnek mantık tanımlamanızı sağlar.

Aşağıdaki tabloda iki işlev türünün yetenekleri karşılaştırılmaktadır.


İşlev türü


Genel adımlar


Alma


Döndürme


Günlüğü değiştirme


Birleşik Çağrılar


Genel İşlemler ve İşlevler


Destekler


Günlükler otomatik olarak alınır


Sıfır veya daha fazla günlük


Çoğu durumda desteklenir


Destekler


İfade işlevleri


Desteklenmez


Yalnızca birkaç işlev doğrudan günlük işlemeyi destekler.


Belirli veri yapıları


Desteklenmez


Destekler

Genel işlem işlevleri

Günlükleri kabul eden ve döndüren bir işlevdir.

Not

Her adımın ilk satırına yalnızca bir genel işlem işlevi yerleştirilebilir.

SLS DSL'deki bir dönüştürme kuralı aşağıdaki sözdizimini kullanır:

GlobalFunction1(..parameters....)
GlobalFunction2(..parameters....)
GlobalFunction3(..parameters....)
GlobalFunction4(..parameters....)

Genel işlem işlevleri iki kategoriye ayrılır:

İşlevsel sınıflandırma

Açıklama

Örnek

Akış kontrol işlevleri

Bu işlevler süreç akışını yönetir, günlükleri alır ve günlükleri işlemek için diğer işlevleri koşullu olarak çağırır.

e_if, e_switch ve e_if_else.

Olay işleme işlevleri

Bu işlevler günlükleri dönüştürür ve sıfır veya daha fazla günlük döndürür.

Aşağıda bir işlev örneği verilmiştir:

  • e_drop_fields: günlük alanlarını siler.

  • e_kv: günlüklerden anahtar-değer çiftlerini ayıklar ve ekler.

  • e_dict_map: günlükleri zenginleştirir.

Dönüştürme mantığı:

  • Temel işleme

    Veri dönüştürme özelliği, kaynağa ait Logstore'dan verileri akış biçiminde okur. Her günlüğü bir sözlük olarak dönüştürme kuralına iletir. Sistem daha sonra kuralda tanımlanan işlevlere göre günlük verilerini sırayla işler. Son olarak sistem, dönüştürme sonucunu hedef Logstore'a çıkarır.

    Not

    Bir günlüğün tüm alanları ve değerleri dize olarak gönderilir. Örneğin, ham günlük {"__time__": "1234567", "__topic__": "", "k1": "test"} e_set("f1", 200) işlevi tarafından işlenir. İşlev, değeri 200 olan f1 alanını ekler. İşlemeden sonra günlük şu hale gelir: {"__time__": "1234567", "__topic__": "", "k1": "test", "f1": "200"}. Bu günlükte hem f1 alanı hem de 200 değeri dizedir.

    Bir dönüştürme kuralında belirtilen olay işleme işlevleri sırayla çağrılır. Her işlev bir günlük alır, onu işler ve ardından işlenen günlüğü döndürür.

    Örneğin, e_set("type", "test") işlevi bir günlüğe değeri test olan type alanını ekler. Sonraki işlev, değiştirilen günlüğü alır ve işler.

  • Koşul değerlendirme

    • e_if: e_if işlevi, günlükleri işlemek için koşullu ifadeler eklemenizi sağlar. Bir günlük belirtilen koşulu karşılamazsa ilgili işlem atlanır. e_if işlevi if mantığını uygular.

      Örneğin, e_if(e_match("status", "200"), e_regex("data", "ret: \d+", "result")) işlevi status alanının değerinin 200 olup olmadığını denetler. Doğruysa işlev, belirtilen normal ifadeyi kullanarak data alanından result alanını ayıklar. Aksi takdirde hiçbir işlem gerçekleştirilmez.

    • e_if_else: Bu işlev, if_else işlemine benzer şekilde çalışır.

  • İşleme sonlandırma

    • Bir dönüştürme kuralındaki bir adım günlük döndürmeyebilir; bu, günlüğün silindiği anlamına gelir.

      Örneğin, e_if(str_islower(v("result")), e_drop()) işlevi result alanının değerinin küçük harfli bir dize olup olmadığını denetler. Doğruysa günlük silinir ve bu günlük üzerinde sonraki adımlar gerçekleştirilmez. Sistem otomatik olarak sonraki günlüğü işler.

    • Bir günlüğün hedef logstore'a yazılması işlemeyi sonlandırır. Örneğin, e_output işlevi bir günlüğü hedef logstore'a yazar ve silerse bu günlük üzerinde sonraki adımlar gerçekleştirilmez.

      Not

      e_coutput işlevi çıkış günlüğünü kopyalar ve sonraki adımları işlemeye devam eder.

  • Paralel bölme:

    Bir dönüştürme kuralındaki bir adım birden çok günlük döndürebilir; bu, günlüğün bölündüğü anlamına gelir.

    Örneğin, e_split(data) işlevi bir günlüğü data alanının değerine göre iki günlüğe böler. data alanının değeri "abc, xyz" ise günlük iki günlüğe bölünür. Bir günlükte data alanının değeri abc olur. Diğer günlükte ise değer xyz olur.

    Bölme işleminden sonra oluşturulan günlükler sonraki adımlarda işlenir.

Daha fazla bilgi için bkz. Genel işlem işlevleri.

İfade işlevleri

SLS DSL, genel işlem işlevlerine ek olarak belirli parametreleri kabul eden ve belirli değerler döndüren 200 ifade işlevi sağlar. Bir ifade işlevini veya ifade işlevlerinin bir kombinasyonunu bir genel işlem işlevi içinde çağırın. Sözdizimi aşağıdaki gibidir:

Global Processing Function 1(Expression Function 1(...), ...)
Global Processing Function 2(..., Expression Function 2(...), Expression Function 3(...), ...)

İfade işlevleri dört kategoriye ayrılır:


İşlevsel Sınıflandırma


Açıklama


Örnek


Olay denetim işlevleri


Bu işlevler günlükleri alır, belirli bilgileri ayıklar veya getirir ve günlükleri değiştirmeden bu bilgileri döndürür.


v işlevi bir günlük alanının değerini döndürür. e_search ve e_match işlevleri bir günlüğün belirtilen bir koşulu karşılayıp karşılamadığını denetler.


Kaynak işlevleri


Bu işlevler şirket içi veya harici kaynaklara bağlanır, belirli parametre ayarlarını kullanır ve sözlükler veya tablolar gibi verileri döndürür.


OSS, RDS ve Logstore kaynak işlevleri.


Kontrol işlevleri


Bu işlevler ifadeler üzerinde mantıksal işlemler gerçekleştirir. Belirli parametreler kullanır, koşullu kontrol uygular ve sonuçları döndürmek için diğer ifade işlevlerini çağırır.


op_and, op_or, op_not, op_if ve op_coalesce.


Diğer ifade işlevleri


Bu işlevler sabit değerleri veya diğer işlev çağrılarının sonuçlarını kabul eder ve belirli değerleri döndürür.


Dize, tarih ve saat ile tür dönüştürme işlevleri.

Daha fazla bilgi için bkz. İfade işlevleri.