Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:Veri yapıları

Son Güncelleme:Sep 30, 2026

Veri dönüştürme, günlük verilerini işlemek için temel türler, olay türleri, sabit tanımlayıcılar ve JSON nesneleri dahil olmak üzere çeşitli veri yapılarını kullanır.

Temel veri yapıları

Aşağıdaki tabloda temel veri yapı türleri listelenmiştir.

Tür

Açıklama

Integer

Alan değerlerini ayarlamak veya işlevlere parametre aktarmak için kullanılır.

Örnek: e_set("f1", 100), f1 alanını 100 olarak ayarlar.

Float

Alan değerlerini ayarlamak veya işlevlere parametre aktarmak için kullanılır.

Örnek: e_set("f1", 1.5), f1 alanını 1.5 olarak ayarlar.

String

Dizeler aşağıdaki kuralları destekler:

  • "abc" ifadesi 'abc' ile aynıdır. Bir dize çift tırnak (") içeriyorsa, dizeleri tek tırnakla çevreleyebilirsiniz; örneğin 'abc"xyz'. Alternatif olarak çift tırnağı ters eğik çizgi (\) ile kaçış karakteri olarak kullanabilirsiniz; örneğin "abc\"xyz".

    Ters eğik çizgi (\) bir kaçış karakteridir. Örneğin, "\\abc\\xyz" ifadesi \abc\xyz dizesini temsil eder.

  • r"\\10.64.1.1\share\folder" ifadesi "\\\\10.64.1.1\\share\\folder" ile aynıdır. Her ikisi de \\10.64.1.1\share\folder dizesini temsil eder.

  • Çok baytlı dizeler Unicode olarak temsil edilir. Örneğin, Chinese dizesinin uzunluğu 2'dir.

  • Normal ifadeler dize olarak temsil edilir.

Not

Dış dize için tek tırnak, iç arama değeri için çift tırnak kullanın. e_search("domain: '/url/test.jsp'") kullanımı yanlıştır. Doğru biçim e_search('domain: "/url/test.jsp"') şeklindedir.

Bytes

Dize bellek kodlamasından farklıdır. b'abc', bazı özel işlevler için parametre veya dönüş türü olarak kullanılır.

empty

None veya null, değer eksikliğini belirtir. İşlevlerdeki bazı adlandırılmış parametrelerin varsayılan değeri None'dir ve bu durum belirli bir varsayılan davranışı ifade eder.

Not

Boş dize, None veya null değerinden farklı bir veri türüne sahiptir.

List

Bir dizi; örneğin [1,2,3,4].

  • Bazı işlevler liste türünde parametre kabul eder. Örnek: e_dict_map("dict data", ["f1", "f2", "f3"], ...).

  • Bazı işlevler liste döndürür. Örnek: json_select, bir dizi seçerken liste döndürür.

Tuple

Liste ile aynı şekilde çalışır. Örnek: (1,2,3,4).

Dictionary (Dict)

{"key": "value", "k2": "v2", ...} biçimindeki anahtar-değer çiftleri koleksiyonudur. Anahtarlar genellikle benzersiz dizelerdir. Değerler yukarıda listelenen herhangi bir türde olabilir. Sözlükler karma tabanlıdır ve sırasızdır.

  • Olay, özel bir sözlük türüdür.

  • Bazı işlevler belirli biçimlerdeki sözlükleri kabul eder. Örnek: {"key": [1,2,3], "key2": {"k3": "v3"}}.

  • Sözlükler, sözlük eşlemelerinde giriş verisi olarak da kullanılır.

Boolean (Bool)

Örneğin, True, False, true veya false.

Table

Çok sütunlu bir tablo yapısıdır. Tablolar, harici kaynaklardan çok satırlı CSV içeriği yüklenerek veya ApsaraDB RDS ya da Logstore'dan çok sütunlu veri alınarak oluşturulur. Tablolar başlıca veri zenginleştirme eşlemeleri veya diğer ileri düzey yapılandırma senaryolarında kullanılır.

Datetime object

Bellekteki bir tarih ve saati temsil eder. Unix zaman damgası dizesine veya biçimlendirilmiş saat dizesine dönüştürülebilir ya da daha fazla dönüştürme için dt_ işlevlerine aktarılabilir.

Olay türleri

Veri dönüştürme aşağıdaki olay türlerini destekler.

  • İlkel tür

    Veri dönüştürme, günlük verilerini bir sözlük olarak işler; örneğin {"__topic__": "access_log", "content": "....."}.

    Sözlük anahtarları ve değerleri, günlük alanlarına ve değerlerine karşılık gelir.

    Not

    Olay anahtarları ve değerlerinin her ikisi de dizedir ve anahtarlar benzersiz olmalıdır.

  • Meta-alanlar

    Meta-alanlar şunları içerir:

    • Zaman alanı __time__: Günlüğün yazıldığı Unix zaman damgası (1 Ocak 1970 00:00:00 UTC'den bu yana geçen saniye). Tamsayı dizesi olarak depolanır.

    • Konu __topic__: Logstore içindeki günlükleri konuya göre düzenler. Günlükleri yazarken veya sorgularken bir konu belirtebilirsiniz.

    • Kaynak __source__: Günlük kaynağı; örneğin günlüğü oluşturan makinenin IP adresi.

  • Zaman alanı değişikliği

    Olay zamanını değiştirmek için zaman alanı değerini değiştirin. Bu alanda diğer işlemler yapmak üzere datetime işlevlerini de kullanabilirsiniz.

    Not

    Zaman alanı silinirse sistem, günlüğü hedefe gönderirken işlem zamanını olay zamanı olarak kullanır.

  • Etiketler

    Etiket, sınıflandırma amacıyla kullanılan bir günlük etiketidir ve __tag__:name biçimindedir.

    • Kaynak Logstore için genel IP adresi kaydı etkinleştirilirse günlükler tag:__tag__:__receive_time__ etiketini içerir.

    • Container Service günlükleri, __tag__:__container_name__ gibi birden fazla konteyner ile ilgili etiket içerir.

    • Etiket ekleyebilir veya değiştirebilirsiniz. type adlı bir etiket eklemek için e_set("__tag__:type", "access_log") kullanın.

  • Atamada otomatik dönüştürme

    Olay anahtarları ve değerleri dizedir. Bir değer atadığınızda veya yeni bir alan ayarladığınızda anahtarlar ve değerler otomatik olarak dizeye dönüştürülür. Örnek:

    e_set("v1", 12.3)
    e_set("v2", True)

    Bu işlem, v1 değerini "12.3" dizesine ve v2 değerini "true" dizesine ayarlar.

    Aşağıdaki tabloda farklı veri türlerinin dizeye nasıl dönüştürüldüğü gösterilmektedir.

    Tür

    Örnek

    Dönüştürülen tür

    Dönüştürülen örnek

    Integer

    1

    String

    "1"

    Float

    1.2

    String

    "1.2"

    Boolean

    True

    String

    "true"

    Bytes

    b"123"

    UTF-8 kullanılarak dizeye kod çözülür

    "123"

    Tuple

    • Örnek 1: (1, 2, 3)

    • Örnek 2: ("a", 1)

    Liste dizesi

    • Örnek 1: "[1, 2, 3]"

    • Örnek 2: "[\"a\", 1]"

    List

    • Örnek 1: [1,2,3]

    • Örnek 2: ["a", 1]

    String

    • Örnek 1: "[1, 2, 3]"

    • Örnek 2: "[\"a\", 1]"

    Dictionary

    {"1":2, "3":4}

    String

    "{\"1\": 2, \"3\": 4}"

    Datetime

    datetime(2018, 10, 10, 10, 10, 10)

    ISO biçimli dize

    2018-10-10 10:10:10

Sabit tanımlayıcılar

Veri dönüştürme, kodu basitleştirmek ve okunabilirliği artırmak için sabit tanımlayıcılar sağlar.


Tanımlayıcı


Tür


Açıklama


true


Boolean


True değerine eşdeğerdir.


false


Boolean


False değerine eşdeğerdir.


null


None


None değerine eşdeğerdir.


F_TAGS


String


TAG alanları için normal ifade. "__tag__:.+" değerine eşdeğerdir.


F_META


String


TAG, __topic__ ve __source__ alanları için normal ifade. __tag__:.+|__topic__|__source__ değerine eşdeğerdir.


F_TIME


String


__time__ alan adı. __time__ değerine eşdeğerdir.


F_PACK_META


String


pack meta alanları için normal ifade. "__pack_meta__|__tag__:__pack_id__" değerine eşdeğerdir.


F_RECEIVE_TIME


String


Sunucu günlük alma zamanı için tag alanı. "__tag__:__receive_time__" değerine eşdeğerdir.


C_JOB_REGION


String


Veri dönüştürme görevinin bölge kimliği; örneğin cn-hangzhou. Örnek: e_set("job_region", C_JOB_REGION).


C_JOB_PROJECT


String


Veri dönüştürme görevinin proje adı; örneğin my-sls-project. Örnek: e_set("job_project", C_JOB_PROJECT).


C_JOB_NAME


String


Veri dönüştürme işi yapılandırma adı; örneğin etl-1649227848-642277. Örnek: e_set("job_name", C_JOB_NAME).


C_JOB_ID


String


Veri dönüştürme görevinin çalışma kimliği; örneğin 73b96061b8c1c2101d558139bf641ea9. Örnek: e_set("job_id", C_JOB_ID).

JSON nesneleri

JSON nesnesi, json_select veya json_parse kullanılarak bir dizeden ayrıştırılır. Temel veri yapılarından oluşur. Aşağıdaki tabloda giriş dizelerinin JSON nesnelerine nasıl dönüştürüldüğü gösterilmektedir.


Dize


JSON nesnesi


Gerçek tür


1


1


Integer


1.2


1.2


Float


true


True


Boolean


false


False


Boolean


"abc"


"abc"


String


null


None


None


["v1", "v2", "v3"]


["v1", "v2", "v3"]


List


["v1", 3, 4.0]


["v1", 3, 4.0]


List


{"v1": 100, "v2": "good"}


{"v1": 100, "v2": "good"}


Dictionary


{"v1": {"v11": 100, "v2": 200}, "v3": "good"}


{"v1": {"v11": 100, "v2": 200}, "v3": "good"}


Dictionary