Gunakan pernyataan mirip SQL untuk mencari perangkat yang memenuhi kriteria tertentu—misalnya, perangkat online—dan unduh daftar perangkat yang sesuai beserta ProductKey dan DeviceName-nya.
Batasan
-
Wilayah yang didukung: China (Shanghai), , dan Japan (Tokyo).
-
Batasan fitur: Fitur Advanced Search tidak didukung pada halaman untuk instans publik.
Kasus penggunaan
Anda dapat menggunakan advanced search dalam skenario berikut di Konsol IoT Platform:
-
Lihat informasi perangkat: Di tab Advanced Search pada halaman , cari dan kelola perangkat tertentu.
Anda juga dapat memanggil operasi API QueryDeviceBySQL untuk melakukan pencarian lanjutan. API ini tidak terbatas pada skenario konsol tersebut.
Prosedur
Contoh berikut menunjukkan cara menggunakan advanced search di Konsol IoT Platform untuk menambahkan perangkat ke kelompok perangkat dan mencari perangkat berdasarkan model TSL.
Masuk ke Konsol IoT Platform.
Di halaman Overview, temukan instans yang ingin Anda kelola lalu klik ID instans atau nama instans tersebut.
-
Di panel navigasi sebelah kiri, pilih , lalu klik tab Advanced Search.
-
Di tab Advanced Search, cari perangkat yang memenuhi kriteria Anda.
Sintaks mirip SQL
Saat menggunakan advanced search di konsol, pernyataan mirip SQL terdiri dari klausa WHERE dan klausa ORDER BY opsional. Klausa SELECT dan LIMIT, serta kata kunci WHERE itu sendiri, dihilangkan. Panjang pernyataan dibatasi hingga 400 karakter.
Contoh:
product_key = "a1*****" order by active_timeKlausa WHERE
Format:
[condition1] AND [condition2] Abaikan WHERE.
Anda dapat menentukan maksimal lima kondisi. Kondisi bersarang tidak didukung.
Operator logika AND dan OR didukung. Anda dapat menggunakan maksimal lima operator logika per pernyataan.
Klausa ORDER BY (opsional)
Gunakan klausa ORDER BY untuk mengurutkan hasil. Anda dapat mengurutkan berdasarkan bidang gmt_create, gmt_modified, dan active_time.
Klausa ini opsional. Jika dihilangkan, hasil dikembalikan dalam urutan acak.
Bidang yang dapat dicari
|
Bidang |
Tipe |
Deskripsi |
|
product_key |
text |
ProductKey dari produk tempat perangkat tersebut terdaftar. |
|
iot_id |
text |
Identifier perangkat. Bidang iot_id dikembalikan secara default. |
|
name |
text |
DeviceName perangkat. |
|
active_time |
date |
Waktu saat perangkat diaktifkan. Waktu dalam format |
|
nickname |
text |
Alias perangkat. |
|
gmt_create |
date |
Waktu saat perangkat dibuat. Waktu dalam format |
|
gmt_modified |
date |
Waktu saat nickname perangkat terakhir diperbarui. Waktu dalam format |
|
status |
text |
Status perangkat. Nilai yang valid:
|
|
group.group_id |
text |
ID kelompok perangkat. |
|
tag.tag_name |
text |
Kunci tag. |
|
tag.tag_value |
text |
Nilai tag. |
|
ota_module.name |
text |
Nama modul OTA. Gunakan bidang ini bersama ota_module.version untuk menentukan modul OTA yang sesuai dengan versi OTA perangkat saat ini. |
|
ota_module.version |
text |
Versi OTA perangkat saat ini. Gunakan bidang ini bersama ota_module.name. |
Operator
|
Operator |
Tipe bidang yang didukung |
|
= |
number, date, text, keyword |
|
> |
number, date |
|
< |
number, date |
|
LIKE |
text |
Operator LIKE mendukung pencocokan awalan (prefix matching) tetapi tidak mendukung pencocokan akhiran (suffix) atau wildcard. Awalan harus memenuhi ketentuan berikut:
-
Awalan harus terdiri dari minimal empat karakter dan tidak boleh mengandung karakter khusus, seperti backslash (\), garis miring (/), ampersand (&), tanda plus (+), tanda hubung (-), tanda seru (!), tanda kurung (), titik dua (:), tilde (~), kurung siku ([]), kurung kurawal ({}), tanda bintang (*), dan tanda tanya (?).
-
Awalan harus diakhiri dengan
%.
Contoh:
product_key = "a1*********" and name LIKE "test%"API Terkait
QueryDeviceBySQL: mencari perangkat yang memenuhi kondisi tertentu menggunakan pernyataan mirip SQL.