資料類型

AWS IoT 規則引擎支援所有 JSON 資料類型。

支援的資料類型

類型	意義
Int	離散的 Int。最多 34 位數。
Decimal	精度為 34 位的 Decimal，最小非零量級為 1E-999，最大量級為 9.999…E999。 注意 有些函數傳回的 Decimal 值為雙精度，而非 34 位數的精度。 使用 SQL V2 (2016-03-23) 時，數值若為整數 (例如 10.0) 會被當成 Int 值 (10) 處理，而不是預期的 Decimal 值 (10.0)。若要可靠地將整數數值當成 Decimal 值處理，請針對規則查詢陳述式使用 SQL V1 (2015-10-08)。
Boolean	True 或 False
String	UTF-8 字串。
Array	一系列類型無需相同的值。
Object	由鍵和值組成的 JSON 值。鍵必須為字串。值可以為任何類型。
Null	Null 是由 JSON 定義。此為用來代表缺少某個值的實際值。您可以在 SQL 陳述式中使用 Null 的關鍵字來明確建立 Null 的值。例如："SELECT NULL AS n FROM 'topic/subtopic'"
Undefined	並非值。無法以 JSON 明確顯示，除非是省略該值。舉例而言，在物件 {"foo": null} 中，「foo」鍵會傳回 NULL，但「bar」鍵傳回 Undefined。SQL 語言在內部將 Undefined 視為一個值，但無法以 JSON 顯示，因此序列化為 JSON 時，結果會是 Undefined。 {"foo":null, "bar":undefined} 序列化為 JSON 如下： {"foo":null} 同樣地，Undefined 由自身序列化時，會轉換為空白字串。以無效引數 (例如，錯誤類型、錯誤的引數數量等等) 呼叫的函數會傳回 Undefined。

轉換

下表列出的是當某個類型的值轉換為另一種類型 (給函數指定錯誤類型的值) 所得的結果。舉例而言，如果絕對值的函數「abs」(預期為 Int或 Decimal) 得到的是 String，其會嘗試按照下列規則將 String 轉換為 Decimal。此例中，'abs("-5.123")' 會視為 'abs(-5.123)'。

注意

不會企圖轉換為 Array、Object、Null、Undefined。

To Decimal

引數類型	結果
Int	無小數點的 Decimal。
Decimal	來源值。
Boolean	Undefined。(您可以明確使用 Cast 函數轉換 true = 1.0、false = 0.0。)
String	SQL 引擎會嘗試將字串剖析為 Decimal. AWS IoT attempts，以剖析符合規則表達式的字串：^-?\d+(\.\d+)?((?i)E-?\d+)?$。「0」、「-1.2」、「5E-12」均為自動轉換為 Decimal 的範例字串。
Array	Undefined.
物件	Undefined.
Null	Null.
未定義	Undefined.

To Int

引數類型	結果
Int	來源值。
Decimal	四捨五入到最接近 Int 的來源值。
Boolean	Undefined。(您可以明確使用 Cast 函數轉換 true = 1.0、false = 0.0。)
String	SQL 引擎會嘗試將字串剖析為 Decimal. AWS IoT attempts，以剖析符合規則表達式的字串：^-?\d+(\.\d+)?((?i)E-?\d+)?$。"0"、"-1.2"、"5E-12" 是字串的所有範例，這些字串會自動轉換為 Decimals. AWS IoT attempts，以String將 轉換為 Decimal，然後截斷該字串的小數位Decimal數以製作 Int。
Array	Undefined.
物件	Undefined.
Null	Null.
未定義	Undefined.

To Boolean

引數類型	結果
Int	Undefined。(您可以明確使用 cast 函數轉換 0 = False、any_nonzero_value = True。)
Decimal	Undefined。(您可以明確使用 Cast 函數轉換 0 = False、any_nonzero_value = True。)
Boolean	原始的值。
String	「true」= True 而「false」= False (不區分大小寫)。其他字串值為 Undefined。
Array	Undefined.
物件	Undefined.
Null	Undefined.
未定義	Undefined.

To String

引數類型	結果
Int	以標準表示法表示的 Int 的字串顯示方式。
Decimal	代表 Decimal 值的字串，可能是採取科學表示法。
Boolean	「true」或「false」。所有小寫。
String	原始的值。
陣列	序列化為 JSON 的 Array。該結果字串為以逗號分隔的清單，並包含在方括弧內。String 在括號中。Decimal、Int、Boolean 和 Null 則不是。
物件	序列化為 JSON 的物件。該結果字串為以逗號分隔的鍵值組清單，並以大括號為開頭和結尾。String 在括號中。Decimal、Int、Boolean 和 Null 則不是。
Null	Undefined.
未定義	未定義。