All Products
Search

This Product

    Simple Log Service:Fungsi konversi tipe

    Document Center

    Simple Log Service:Fungsi konversi tipe

    Last Updated:Jun 11, 2026

    Gunakan fungsi konversi tipe dalam pernyataan kueri dan analisis untuk mengonversi tipe data.

    SLS mendukung fungsi konversi tipe berikut.

    Penting

    Jika Anda ingin menggunakan string dalam pernyataan analitik, bungkus string tersebut dengan tanda kutip tunggal (''). String yang tidak dibungkus atau dibungkus dengan tanda kutip ganda ("") dianggap sebagai nama field atau nama kolom. Misalnya, 'status' merepresentasikan string status, sedangkan status atau "status" merepresentasikan field log status.

    Function

    Syntax

    Description

    SQL

    SPL

    cast function

    cast(x as type)

    Mengonversi tipe data x.

    Jika konversi gagal, seluruh kueri gagal.

    √

    √

    try_cast function

    try_cast(x as type)

    Mengonversi tipe data x.

    Jika konversi gagal, mengembalikan NULL dan melanjutkan pemrosesan.

    Catatan

    Gunakan try_cast alih-alih cast untuk mencegah data kotor menghentikan seluruh kueri.

    √

    ×

    typeof function

    typeof(x)

    Mengembalikan tipe data x.

    √

    ×

    Cast function

    Mengonversi tipe data x. Jika konversi gagal, seluruh kueri akan gagal.

    Syntax

    cast(x as type)

    Parameters

    Parameter

    Description

    x

    Ekspresi yang akan dikonversi. Mendukung semua tipe data.

    type

    Tipe data SQL target. Nilai yang valid: bigint, varchar, double, boolean, timestamp, decimal, array, dan map.

    Contoh: cast(json_parse(key) as array(varchar)).

    Lampiran: Pemetaan tipe data mencantumkan pemetaan tipe indeks ke tipe SQL.

    Return value type

    Tipe data yang ditentukan oleh parameter type.

    Examples

    SQL

    Konversi 1 ke boolean.

    • Pernyataan kueri dan analisis

      * | select cast(1 as boolean)

    • Kueri mengembalikan true.

    SPL

    Konversi 1 ke boolean.

    • Pernyataan kueri dan analisis

    * | extend a = cast(1 as boolean)

    • Nilai a adalah true.

    Try_cast function

    Mengonversi tipe data x. Jika konversi gagal, fungsi ini mengembalikan NULL dan melanjutkan pemrosesan.

    Syntax

    try_cast(x as type)

    Parameters

    Parameter

    Description

    x

    Ekspresi yang akan dikonversi. Mendukung semua tipe data.

    type

    Tipe data SQL target. Nilai yang valid: bigint, varchar, double, boolean, timestamp, decimal, array, dan map.

    Contoh: try_cast(json_parse(key) as map(varchar, varchar)).

    Lampiran: Pemetaan tipe data mencantumkan pemetaan tipe indeks ke tipe SQL.

    Return value type

    Tipe data yang ditentukan oleh parameter type.

    Examples

    Konversi field uid ke varchar.

    • Pernyataan kueri dan analisis

      * | select try_cast(uid as varchar)

    • Hasil berisi kolom _col0. Kedua baris memiliki nilai owner-01.

    Typeof function

    Mengembalikan tipe data x.

    Syntax

    typeof(x)

    Parameters

    Parameter

    Description

    x

    Ekspresi yang akan dievaluasi. Mendukung semua tipe data.

    Return value type

    varchar

    Examples

    Periksa tipe data request_time.

    • Pernyataan kueri dan analisis

      * |SELECT typeof(request_time)

    • Tipe data request_time adalah double.

    Lampiran: Pemetaan tipe data

    Pemetaan tipe data indeks ke SQL:

    Index data type

    SQL data type

    long

    bigint

    text

    varchar

    double

    double

    json

    varchar