適用於 DynamoDB 的 PartiQL 資料類型

下表列出您可搭配 DynamoDB 專用 PartiQL 使用的資料類型。

DynamoDB 資料類型	PartiQL 表示法	備註
Boolean	TRUE | FALSE	不區分大小寫。
Binary	N/A	僅透過程式碼支援。
List	[ value1, value2,...]	清單類型中可存放的資料類型不限，而且清單中的元素不必屬於相同類型。
Map	{ 'name' : value }	映射類型中可存放的資料類型不限，而且映射中的元素不必屬於相同類型。
Null	NULL	不區分大小寫。
Number	1、1.0、1 e0	數字可以是正數、負數或零。數字精確度最高可達 38 位數。
Number Set	<<number1, number2>>	數字集中的元素必須是 Number (數字) 類型。
String Set	<<'string1', 'string2'>>	字串集中的元素必須是 String (字串) 類型。
String	'string value'	必須使用單引號來指定 String (字串) 值。

範例

下述陳述式示範如何插入以下資料類型：String、Number、Map、List、Number Set 和 String Set。

INSERT INTO TypesTable value {'primarykey':'1', 
'NumberType':1,
'MapType' : {'entryname1': 'value', 'entryname2': 4}, 
'ListType': [1,'stringval'], 
'NumberSetType':<<1,34,32,4.5>>, 
'StringSetType':<<'stringval','stringval2'>>
}

下述陳述式示範如何將新的元素插入 Map、List、Number Set 和 String Set 類型，並變更 Number 類型的數值。

UPDATE TypesTable 
SET NumberType=NumberType + 100 
SET MapType.NewMapEntry=[2020, 'stringvalue', 2.4]
SET ListType = LIST_APPEND(ListType, [4, <<'string1', 'string2'>>])
SET NumberSetType= SET_ADD(NumberSetType, <<345, 48.4>>)
SET StringSetType = SET_ADD(StringSetType, <<'stringsetvalue1', 'stringsetvalue2'>>)
WHERE primarykey='1'

下述陳述式示範如何從 Map、List、Number Set 和 String Set 類型移除元素，並變更 Number 類型的數值。

UPDATE TypesTable 
SET NumberType=NumberType - 1
REMOVE ListType[1]
REMOVE MapType.NewMapEntry
SET NumberSetType = SET_DELETE( NumberSetType, <<345>>)
SET StringSetType = SET_DELETE( StringSetType, <<'stringsetvalue1'>>)
WHERE primarykey='1'

如需詳細資訊，請參閱 DynamoDB 資料類型。