View a markdown version of this page

Klausa SET - AWS IoT Core

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

Klausa SET

Gunakan klausa SET untuk menentukan variabel yang menyimpan hasil ekspresi. Anda dapat menggunakan kembali variabel-variabel ini dalam klausa SELECT dan WHERE, dan dalam template substitusi. Ini membantu Anda menghindari duplikasi ekspresi kompleks dan mengurangi jumlah panggilan fungsi dalam pernyataan SQL Anda.

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

Sintaks klausa SET

Klausa SET harus muncul sebelum klausa SELECT dalam pernyataan SQL Anda. Gunakan sintaks berikut:

SET @variable_name = expression [, @variable_name2 = expression2]

Aturan sintaks:

  • Mulai nama variabel dengan @

  • Nama variabel dapat berisi huruf, angka, dan garis bawah

  • Nama variabel dapat mencapai 64 karakter

  • Beberapa variabel dapat diatur dalam klausa SET tunggal, dipisahkan oleh koma

  • Setiap variabel hanya dapat ditetapkan sekali (variabel tidak dapat diubah)

  • Kata kunci SET hanya dapat digunakan sekali per pernyataan SQL

Menggunakan variabel

Setelah Anda menentukan variabel, Anda dapat menggunakannya di:

  • SELECT klausa

  • klausa WHERE

  • Tugas variabel SET lainnya

  • Templat substitusi tindakan

  • Templat substitusi tindakan kesalahan

  • Kueri SELECT bersarang

  • Parameter fungsi (parameter tertentu seperti parameter roLearn dan parameter yang mengalihkan mode fungsi yang mirip dengan transform("enrichArray", attributes, values) tidak mendukung variabel)

Variabel direferensikan menggunakan yang sama @variable_name sintaks yang digunakan dalam klausa SET. Anda juga dapat menggunakan sintaks ekstensi JSON untuk mengakses properti variabel yang berisi objek, seperti @variable_name.property.

Contoh klausa SET

Penggunaan variabel dasar

Contoh berikut menunjukkan payload yang dipublikasikan pada topik device/data: {"temp_fahrenheit": 75, "humidity": 60}

Pernyataan SQL:

SET @temp_celsius = (temp_fahrenheit - 32) * 5 / 9 SELECT @temp_celsius AS celsius, humidity FROM 'device/data'

Muatan keluar: {"celsius": 23.89, "humidity": 60}

Akses anggota dalam objek JSON yang disematkan

Contoh berikut menunjukkan payload yang dipublikasikan pada topik device/data: {"device1": {"deviceId":"weather_sensor", "deviceData": {"sensors": {"temp_fahrenheit": 75, "humidity": 60}, "location": [47.606,-122.332]}}}

Pernyataan SQL:

SET @device_sensor_data = device1.deviceData.sensors SELECT @device_sensor_data.temp_fahrenheit AS temp_fahrenheit, @device_sensor_data.humidity as humidity, device1.deviceId as deviceId FROM 'device/data'

Muatan keluar: {"temp_fahrenheit":75,"humidity":60,"deviceId":"weather_sensor"}

untuk informasi lebih lanjut tentang cara bekerja dengan ekstensi JSON, referensi Ekstensi JSON

Menghindari panggilan fungsi duplikat

Variabel SET membantu menghindari duplikasi operasi decode yang kompleks:

SET @decoded_data = decode(encode(*, 'base64'), 'proto', 'schema', 'schema.desc', 'message.proto', 'Message') SELECT @decoded_data.sensor_id, @decoded_data.reading FROM 'device/protobuf' WHERE @decoded_data.reading > 100

Tanpa variabel SET, Anda perlu mengulangi fungsi decode tiga kali, yang melebihi batas panggilan fungsi.

Beberapa variabel

Anda dapat mendefinisikan beberapa variabel dalam klausa SET tunggal dengan memisahkannya dengan koma:

SET @user_data = get_user_properties(device_id), @threshold = 50 SELECT @user_data.name, temp_fahrenheit FROM 'sensors/+' WHERE temp_fahrenheit > @threshold AND @user_data.active = true

Menggunakan variabel dalam template substitusi

Variabel juga dapat digunakan dalam template substitusi tindakan, memungkinkan Anda untuk menggunakan kembali nilai yang dihitung di kedua pernyataan SQL dan tindakan aturan.

Pernyataan SQL:

SET @temp_celsius = (temp_fahrenheit - 32) * 5 / 9 SELECT @temp_celsius AS celsius, humidity FROM 'device/data'

Konfigurasi tindakan:

{ "s3": { "roleArn": "arn:aws:iam::123456789012:role/testRuleRole", "bucketName": "bucket", "key": "temperature-data/${device_id}/temp-${@temp_celsius}C.json" } }

Dalam contoh ini, variabel SET @temp_celsius digunakan dalam template substitusi untuk membangun bidang kunci dari tindakan S3.

Non-JSON penggunaan muatan

Variabel SET tidak mendukung payload non-JSON secara langsung, jadi payload harus dikodekan atau diterjemahkan terlebih dahulu:

SET @encoded_payload = encode(*, 'base64') SELECT @encoded_payload AS raw_data FROM 'device/binary'

untuk informasi lebih lanjut tentang cara bekerja dengan muatan non-JSON, referensi Bekerja dengan payload biner

Batas klausa SET

Batas berikut berlaku untuk variabel SET:

  • Maksimal 10 variabel unik per pernyataan SQL

  • Ukuran nilai variabel maksimum 128 KiB (diperkecil UTF-8 String JSON)

  • Ukuran nilai total maksimum 128 KiB untuk semua variabel

  • Nama variabel terbatas pada 64 karakter

  • Variabel dapat menerima muatan JSON secara langsung apa adanya (muatan non-JSON harus terlebih dahulu encoded/decoded)