All Products
Search

This Product

    MaxCompute:FROM_CHARSET

    Document Center

    MaxCompute:FROM_CHARSET

    Last Updated:Jun 26, 2026

    Mengonversi data biner yang menggunakan format encoding tertentu menjadi string berencoding UTF-8 untuk perhitungan selanjutnya. Topik ini menjelaskan sintaks dan parameter fungsi FROM_CHARSET serta menyertakan contoh penggunaannya.

    Syntax

    STRING FROM_CHARSET(binary <source>, string <source_charset>, [string <mode>])

    Parameters

    • source: wajib. Nilai bertipe BINARY yang menentukan data biner yang akan dikonversi.

    • source_charset: wajib. Nilai bertipe STRING yang menentukan format encoding asli dari data biner yang ditentukan oleh source. Nilai yang valid: UTF-8, UTF-16, UTF-16LE, UTF-16BE, ISO-8859-1, US-ASCII, GB2312, GBK, dan GB18030.

    • mode: opsional. Nilai bertipe STRING yang menentukan mode pemrosesan jika terdapat karakter yang tidak dapat dikonversi saat fungsi FROM_CHARSET mengonversi data biner yang ditentukan oleh source menjadi string dalam format encoding tujuan. Nilai yang valid:

      • NONE: melaporkan error tanpa pemrosesan tambahan. Ini adalah nilai default.

      • TRANSLIT: mengganti karakter tersebut dengan karakter serupa dalam format encoding tujuan.

      • IGNORE: mengabaikan error dan melanjutkan eksekusi perintah.

    Return value

    Mengembalikan nilai bertipe STRING dalam format encoding UTF-8. Jika parameter input bernilai null atau string kosong, nilai kembaliannya mengikuti aturan berikut:

    • Jika parameter input bernilai null, maka dikembalikan null.

    • Jika parameter input berupa string kosong, maka dikembalikan error.

    Examples

    • Contoh 1: Mengonversi data biner berencoding UTF-8 menjadi string berencoding UTF-8.

      SELECT FROM_CHARSET(unhex('e58aa0e6b2b9e9949fe696a4e68bb70a'),'UTF-8', 'TRANSLIT');

    • Contoh 2: Mengonversi data biner berencoding GBK menjadi string berencoding UTF-8.

      SELECT FROM_CHARSET(unhex('b9feb9febac3a4ce'), 'GBK');

    • Contoh 3: Jika parameter input bernilai null, maka dikembalikan null.

      SELECT FROM_CHARSET(unhex('b9feb9febac3a4ce'), null);

      Hasil berikut dikembalikan:

      +------------+
| _c0        |
+------------+
| NULL       |
+------------+
    Catatan

    Fungsi UNHEX mengembalikan string yang direpresentasikan oleh string heksadesimal. Untuk informasi lebih lanjut, lihat UNHEX.

    References