IoT Platform:Fungsi

Function

Description

abs(number)

Mengembalikan nilai absolut dari angka tersebut.

asin(number)

Mengembalikan arcsinus dari angka tersebut.

attribute(key)

Mengembalikan nilai tag perangkat dari kunci tag tersebut. Jika tag dengan kunci yang ditentukan tidak disambungkan ke perangkat, tidak ada nilai tag yang dikembalikan. Saat Anda melakukan debug pernyataan SQL, string null dikembalikan karena tidak ada perangkat atau tag aktual.

concat(string1, string2)

Menggabungkan string-string tersebut. String hasil penggabungan dikembalikan.

Contoh: concat(field,'a').

cos(number)

Mengembalikan kosinus dari angka tersebut.

cosh(number)

Mengembalikan kosinus hiperbolik dari angka tersebut.

crypto(field,String)

Mengenkripsi nilai bidang tersebut.

Parameter String menentukan algoritma enkripsi. Algoritma berikut didukung: MD2, MD5, SHA1, SHA-256, SHA-384, dan SHA-512.

deviceName()

Mengembalikan nama perangkat saat ini. Saat Anda melakukan debug pernyataan SQL, string null dikembalikan karena tidak ada perangkat aktual.

endswith(input, suffix)

Memeriksa apakah string input diakhiri dengan string yang ditentukan oleh parameter suffix.

exp(number)

Mengembalikan nilai konstanta matematika e yang dipangkatkan dengan angka yang ditentukan.

floor(number)

Mengembalikan bilangan bulat terbesar yang kurang dari atau sama dengan angka tersebut.

log(n, m)

Mengembalikan logaritma dari angka n dengan basis m.

Jika Anda tidak menentukan m, basis default 10 digunakan. Dalam kasus ini, log(n) dikembalikan.

lower(string)

Mengonversi semua huruf dalam string yang ditentukan menjadi huruf kecil dan mengembalikan string dalam huruf kecil tersebut.

mod(n, m)

Mengembalikan sisa bagi setelah angka n dibagi dengan pembagi m.

nanvl(value, default)

Mengembalikan nilai properti tersebut.

Parameter value menentukan nama properti. Jika nilai properti tersebut null, fungsi ini mengembalikan nilai parameter default.

newuuid()

Mengembalikan identifier unik universal (UUID) acak.

payload(textEncoding)

Mengembalikan muatan pesan yang dikirim oleh perangkat. Muatan tersebut dikodekan menggunakan skema pengkodean yang ditentukan oleh parameter textEncoding.

Skema pengkodean default adalah UTF-8. Hal ini berarti fungsi payload() dan payload('utf-8') mengembalikan hasil yang sama.

power(n,m)

Mengembalikan angka n yang dipangkatkan dengan m.

rand()

Mengembalikan bilangan acak yang lebih besar dari atau sama dengan 0 dan kurang dari 1.

replace(source, substring, replacement)

Mengganti substring dalam kolom source dengan string replacement.

Contoh: replace(field,'a','1').

sin(n)

Mengembalikan sinus dari angka n.

sinh(n)

Mengembalikan sinus hiperbolik dari angka n.

tan(n)

Mengembalikan tangen dari angka n.

tanh(n)

Mengembalikan tangen hiperbolik dari angka n.

thingPropertyFlatMap(property)

Mengembalikan nilai-nilai properti dalam model Thing Specification Language (TSL). Jika properti memiliki beberapa nilai, nilai-nilai tersebut dipisahkan dengan garis bawah (_). Jika model TSL berisi lebih dari 50 properti, fitur penerusan data tidak dapat meneruskan seluruh model TSL. Anda dapat memanggil fungsi ini untuk mengekstraksi data properti dari model TSL. Dengan cara ini, semua properti model TSL dapat diteruskan ke layanan Alibaba Cloud lainnya.

Anda dapat menentukan beberapa properti untuk parameter property fungsi ini. Jika Anda tidak menentukan properti, semua nilai properti diekstraksi.

Sebagai contoh, fungsi thingPropertyFlatMap('Power', 'Position') menambahkan "Power": "On", "Position_latitude": 39.9, "Position_longitude": 116.38 ke isi pesan.

timestamp(format)

Mengembalikan timestamp waktu sistem saat ini dalam GMT+8.

Parameter format bersifat opsional. Jika Anda tidak mengonfigurasi parameter format, timestamp waktu sistem saat ini dikembalikan. Sebagai contoh, fungsi timestamp() mengembalikan 1543373798943 dan fungsi timestamp('yyyy-MM-dd\'T\'HH:mm:ss\'Z\'') mengembalikan 2018-11-28T10:56:38Z.

timestamp_utc(format)

Mengembalikan timestamp UTC dari waktu sistem saat ini dalam format yang ditentukan.

Parameter format bersifat opsional. Jika Anda tidak mengonfigurasi parameter format, timestamp 13 digit dari waktu sistem saat ini dikembalikan. Sebagai contoh, fungsi timestamp_utc() mengembalikan 1543373798943 dan fungsi timestamp_utc('yyyy-MM-dd\'T\'HH:mm:ss\'Z\'') mengembalikan 2018-11-28T02:56:38Z.

topic(number)

Mengembalikan informasi topik pada level yang ditentukan.

Sebagai contoh, sebuah topik bernama /alDbcLe****/TestDevice/user/set. Fungsi topic() mengembalikan nama topik lengkap /alDbcLe****/TestDevice/user/set. Fungsi topic(1) mengembalikan level pertama alDbcLe****. Fungsi topic(2) mengembalikan level kedua TestDevice.

upper(string)

Mengonversi semua huruf dalam string yang ditentukan menjadi huruf kapital dan mengembalikan string dalam huruf kapital tersebut.

Sebagai contoh, fungsi upper(alibaba) mengembalikan ALIBABA.

to_base64(*)

Mengonversi muatan pesan dari data biner menjadi string yang dikodekan Base64, lalu mengembalikan muatan pesan setelah konversi. Jika muatan pesan asli bertipe data biner, Anda dapat memanggil fungsi ini.

messageId()

Mengembalikan ID pesan yang dihasilkan oleh IoT Platform.

substring(target, start, end)

Mengembalikan bagian dari string yang ditentukan.

Deskripsi parameter

• target: string asli. Parameter ini wajib diisi.

• start: posisi awal karakter yang dikembalikan. Karakter pada posisi tersebut juga dikembalikan. Parameter ini wajib diisi.

• end: posisi akhir karakter yang dikembalikan. Karakter pada posisi tersebut tidak dikembalikan. Parameter ini opsional.

Contoh:

• substring('012345', 0) = "012345"

• substring('012345', 2) = "2345"

• substring('012345', 2.745) = "2345"

• substring(123, 2) = "3"

• substring('012345', -1) = "012345"

• substring(true, 1.2) error

• substring('012345', 1, 3) = "12"

• substring('012345', -50, 50) = "012345"

• substring('012345', 3, 1) = ""

to_hex(*)

Mengonversi muatan pesan dari data biner menjadi string heksadesimal dan mengembalikan muatan pesan setelah konversi. Jika muatan pesan asli bertipe data biner, Anda dapat memanggil fungsi ini.

user_property()

Mendapatkan nilai parameter UserProperty ketika perangkat menggunakan MQTT 5.0.

• Fungsi user_property() dipanggil untuk mendapatkan semua data properti.

• Fungsi user_property('${Key}') dipanggil untuk mendapatkan data kunci tertentu.

Sebagai contoh, nilai parameter UserProperty yang dilaporkan oleh perangkat adalah {"a": "1", "b": "2"}.

• Fungsi user_property() mengembalikan "{\"a\": \"1\", \"b\": \"2\"}".

• Fungsi user_property('a') mengembalikan "{\"a\": \"1\"}".

things_function_type()

Menanyakan tipe data TSL yang dilaporkan. Fungsi ini hanya berlaku untuk event TSL dan layanan TSL. Nilai kembali fungsi ini bervariasi tergantung pada jenis fitur TSL yang ditanyakan.

• Jika Anda menanyakan suatu event, identifier event tersebut dikembalikan.

• Jika Anda menanyakan suatu layanan, identifier layanan tersebut dikembalikan.

Sebagai contoh, topik /SdfgeW***/device1/thing/event/BrokenInfo/post digunakan untuk meneruskan event BrokenInfo. Jika Anda memanggil fungsi things_function_type() untuk menanyakan event tersebut, identifier event yang dilaporkan BrokenInfo dikembalikan.

things_property('${Parameter name}')

Menanyakan nilai properti, layanan, atau event TSL. Fungsi ini hanya berlaku untuk data TSL.

Sebagai contoh, topik /${productKey}/${deviceName}/thing/event/property/post digunakan untuk meneruskan properti CurrentTemperature. Fungsi things_property('CurrentTemperature') mengembalikan nilai yang dilaporkan dari properti CurrentTemperature.