Jika Anda perlu mencari dan mengunduh daftar perangkat, termasuk ProductKey dan DeviceName, berdasarkan kondisi tertentu di IoT Platform, gunakan fitur pencarian lanjutan. Fitur ini memungkinkan Anda menggunakan pernyataan mirip SQL untuk mencari perangkat, seperti perangkat yang online. Artikel ini menjelaskan cara melakukan pencarian lanjutan dan sintaksis mirip SQL.
Batasan
Fitur ini tersedia di wilayah Tiongkok (Shanghai) dan Jepang (Tokyo).
Batasan pada fitur: Pencarian lanjutan tidak didukung di halaman dari instance publik.
Skenario
Pencarian lanjutan didukung dalam skenario berikut di konsol IoT Platform:
Lihat informasi perangkat: Di tab Advanced Search pada halaman , cari perangkat tertentu.
Anda juga dapat memanggil operasi QueryDeviceBySQL untuk melakukan pencarian lanjutan. Pencarian lanjutan berbasis API operation tidak terbatas pada skenario di atas.
Prosedur
Artikel ini menjelaskan cara menggunakan fitur pencarian lanjutan untuk menambahkan perangkat ke grup perangkat dan mencari perangkat berdasarkan model TSL.
- Masuk ke konsol IoT Platform.
Di halaman Overview, klik All environment. Di tab Semua lingkungan, temukan instance yang ingin Anda kelola dan klik ID instance atau nama instance.
Di panel navigasi sisi kiri, pilih . Klik tab Advanced Search.
Di tab Advanced Search, gunakan fitur pencarian lanjutan untuk mencari perangkat.
Sintaksis mirip SQL
Pernyataan mirip SQL terdiri dari klausa WHERE dan klausa ORDER BY (opsional). Klausa SELECT, klausa LIMIT, dan kata kunci WHERE dari klausa WHERE dihilangkan. Setiap pernyataan tidak boleh melebihi 400 karakter panjangnya.
Contoh:
product_key = "a1*****" order by active_timeKlausa WHERE
Sintaksis:
[kondisi1] AND [kondisi2]Kata kunci WHERE dihilangkan.
Anda dapat menentukan maksimal lima kondisi. Penyusunan bersarang tidak didukung. Untuk informasi lebih lanjut, lihat bidang pencarian dan operator dalam tabel berikut.
Anda dapat menggunakan operator logika AND dan OR. Maksimal lima operator dapat digunakan.
Klausa ORDER BY (opsional)
Klausa ORDER BY digunakan untuk pengurutan. Bidang yang dapat diurutkan meliputi gmt_create, gmt_modified, dan active_time.
Klausa ini dapat dibiarkan tidak ditentukan. Dalam hal ini, hasilnya diurutkan secara acak.
Bidang pencarian
Bidang | Tipe | Deskripsi |
product_key | teks | ProductKey dari produk tempat perangkat milik. |
iot_id | teks | ID perangkat. Secara default, iot_id dikembalikan. |
name | teks | DeviceName perangkat. |
active_time | tanggal | Waktu ketika perangkat diaktifkan. Waktu menggunakan format yyyy-MM-dd HH:mm:ss.SSS, akurat hingga milidetik. |
nickname | teks | Alias perangkat. |
gmt_create | tanggal | Waktu ketika perangkat dibuat. Waktu menggunakan format yyyy-MM-dd HH:mm:ss.SSS, akurat hingga milidetik. |
gmt_modified | tanggal | Waktu ketika alias perangkat terakhir diperbarui. Waktu menggunakan format yyyy-MM-dd HH:mm:ss.SSS, akurat hingga milidetik. |
status | teks | Status perangkat. Nilai valid:
|
group.group_id | teks | ID grup perangkat. |
tag.tag_name | teks | Kunci tag perangkat. |
tag.tag_value | teks | Nilai tag perangkat. |
ota_module.name | teks | Nama modul OTA. Kami merekomendasikan Anda menggunakan bidang ini dengan ota_module.version untuk menentukan modul OTA yang sesuai dengan nomor versi OTA saat ini dari perangkat. |
ota_module.version | teks | Nomor versi OTA saat ini dari perangkat. Kami merekomendasikan Anda menggunakan bidang ini dengan ota_module.name. |
Operator
Operator | Tipe data yang didukung |
= | number, date, teks, dan keyword |
> | number dan date |
< | number dan date |
LIKE | teks |
LIKE mendukung pencocokan awalan, tetapi tidak mendukung pencocokan akhiran atau pencocokan wildcard. Awalan harus memenuhi persyaratan berikut:
Awalan harus minimal 4 karakter dan tidak boleh mengandung karakter khusus apa pun, seperti backslash (\), garis miring (/), ampersand (&), tanda tambah (+), tanda hubung (-), tanda seru (!), tanda kurung (), titik dua (:), tilde (~), tanda kurung siku [], tanda kurung kurawal {}, tanda bintang (*), dan tanda tanya (?).
Awalan harus diakhiri dengan tanda persen (
%).
Contoh:
product_key = "a1*********" and name LIKE "test%"