View a markdown version of this page

AWS IoT Referensi SQL - AWS IoT Core

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS IoT Referensi SQL

Dalam AWS IoT Aturan didefinisikan dengan menggunakan SQL-like sintaks. Pernyataan SQL terdiri dari tiga jenis klausa:

SET

(Opsional) Mendefinisikan variabel yang dapat Anda gunakan kembali di seluruh pernyataan SQL dan templat substitusi. Tetapkan nilai ke variabel menggunakan ekspresi. Referensikan variabel-variabel ini dalam klausa SELECT dan WHERE, dan dalam template substitusi tindakan.

Klausa SET mendukung Jenis Data, Operator, Fungsi, Literal, Pernyataan kasus, Ekstensi JSON, Variabel, dan Kueri objek bersarang.

SELECT

(Wajib) Mengekstrak informasi dari muatan pesan masuk dan melakukan transformasi pada informasi. Pesan yang digunakan diidentifikasi oleh filter topik ditentukan dalam klausa FROM.

Klausa SELECT mendukung Jenis Data, Operator, Fungsi, Literal, Pernyataan kasus, Ekstensi JSON, Templat substitusi, Variabel, Kueri objek bersarang, dan Muatan biner.

FROM

Pesan MQTT filter topik yang mengidentifikasi pesan untuk mengekstrak data. Aturan diaktifkan untuk setiap pesan yang dikirim ke topik MQTT yang cocok dengan filter topik yang ditentukan di sini. Diperlukan untuk aturan yang diaktifkan oleh pesan yang melewati broker pesan. Opsional untuk aturan yang hanya diaktifkan menggunakan Menelan Dasar fitur.

WHERE

(Opsional) Menambahkan logika kondisional yang menentukan apakah tindakan yang ditentukan oleh aturan dilakukan.

Klausul WHERE mendukung Jenis Data, Operator, Fungsi, Literal, Pernyataan kasus, Ekstensi JSON, Variabel, dan Kueri objek bersarang.

Contoh pernyataan SQL terlihat seperti ini:

SELECT color AS rgb FROM 'topic/subtopic' WHERE temperature > 50

Contoh pesan MQTT (juga disebut payload masuk) terlihat seperti ini:

{ "color":"red", "temperature":100 }

Jika pesan ini dipublikasikan di 'topic/subtopic' topik, aturan dipicu dan pernyataan SQL dievaluasi. Pernyataan SQL mengekstrak nilai color properti jika "temperature" Properti lebih besar dari 50. Klausa WHERE menentukan kondisi temperature > 50. AS kata kunci mengganti nama "color" properti untuk "rgb". Hasilnya (juga disebut muatan keluar) terlihat seperti ini:

{ "rgb":"red" }

Data ini kemudian diteruskan ke tindakan aturan, yang mengirimkan data untuk diproses lebih lanjut. Untuk informasi selengkapnya tentang tindakan aturan, lihat AWS IoT tindakan aturan.

catatan

Komentar saat ini tidak didukung di AWS IoT Sintaks SQL.

Nama atribut dengan spasi di dalamnya tidak dapat digunakan sebagai nama bidang dalam pernyataan SQL. Sementara payload yang masuk dapat memiliki nama atribut dengan spasi di dalamnya, nama tersebut tidak dapat digunakan dalam pernyataan SQL. Namun, mereka akan diteruskan ke payload keluar jika Anda menggunakan spesifikasi nama bidang wildcard (*).