Versi SQL

Mesin AWS IoT aturan menggunakan sintaks seperti SQL untuk memilih data dari pesan MQTT. Pernyataan SQL ditafsirkan berdasarkan versi SQL yang ditentukan dengan awsIotSqlVersion properti dalam dokumen JSON yang menjelaskan aturan. Untuk informasi selengkapnya tentang struktur dokumen aturan JSON, lihat Membuat Aturan. awsIotSqlVersionProperti ini memungkinkan Anda menentukan versi mesin aturan AWS IoT SQL yang ingin Anda gunakan. Saat versi baru diterapkan, Anda dapat terus menggunakan versi yang lebih lama atau mengubah aturan Anda untuk menggunakan versi baru. Aturan Anda saat ini terus menggunakan versi yang dengannya mereka dibuat.

Contoh JSON berikut menunjukkan cara menentukan versi SQL menggunakan properti. awsIotSqlVersion

{
    "sql": "expression",
    "ruleDisabled": false,
    "awsIotSqlVersion": "2016-03-23",
    "actions": [{
        "republish": {
            "topic": "my-mqtt-topic",
            "roleArn": "arn:aws:iam::123456789012:role/my-iot-role"
        }
    }]
}

AWS IoT saat ini mendukung versi SQL berikut:

• 2016-03-23- Versi SQL dibangun pada 2016-03-23 (disarankan).

• 2015-10-08- Versi SQL asli dibangun pada 2015-10-08.

• beta— Versi beta SQL terbaru. Versi ini dapat memperkenalkan perubahan yang melanggar aturan Anda.

Apa yang baru di versi mesin aturan SQL 2016-03-23

• Perbaikan untuk memilih objek JSON bersarang.

• Perbaikan untuk query array.

• Dukungan kueri intra-objek. Untuk informasi selengkapnya, lihat Kueri objek bersarang.

• Support untuk menampilkan array sebagai objek tingkat atas.

• Penambahan encode(value, encodingScheme) fungsi, yang dapat diterapkan pada data format JSON dan non-JSON. Untuk informasi selengkapnya, lihat fungsi encode.

Output Array sebagai objek tingkat atas

Fitur ini memungkinkan aturan untuk mengembalikan array sebagai objek tingkat atas. Misalnya, diberikan pesan MQTT berikut:

{
    "a": {"b":"c"},
    "arr":[1,2,3,4]
}

Dan aturan berikut:

SELECT VALUE arr FROM 'topic'

Aturan menghasilkan output berikut.

[1,2,3,4]