適用於 DynamoDB 的 PartiQL Insert 陳述式

使用 INSERT 陳述式在 Amazon DynamoDB 中將項目新增至資料表。

注意

您一次只能插入一個項目，因為您無法發出可插入多個項目的單個 DynamoDB PartiQL 陳述式。如需插入多個項目的相關資訊，請參閱 使用 DynamoDB 專用 PartiQL 執行交易 或 使用 DynamoDB 專用 PartiQL 執行批次操作。

語法

插入單一項目。

INSERT INTO table VALUE item

參數

表格

(必要) 您要插入資料的資料表。索資料表必須已存在。

項目

(必要) 有效的 DynamoDB 項目表示為 PartiQL 元組。您必須在 PartiQL 中僅指定一個項目，項目中的每個屬性名稱均區分大小寫，且可以使用單引號 ('...') 表示。

PartiQL 中的字串值也使用單引號 ('...') 表示。

傳回值

此陳述式不會傳回任何值。

注意

如果 DynamoDB 資料表已經有一個項目的主索引鍵與插入的項目的主索引鍵相同，則會傳回 DuplicateItemException。

範例

INSERT INTO "Music" value {'Artist' : 'Acme Band','SongTitle' : 'PartiQL Rocks'}