INSERTAmazon 的命令 QLDB - Amazon Quantum 賬本數據庫（AmazonQLDB）
語法參數傳回值範例以編程方式使用驅動程序

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

INSERTAmazon 的命令 QLDB

重要

支援結束通知：現有客戶將能夠使用 Amazon，QLDB直到 2025 年 7 月 31 日終止支援為止。有關更多詳細信息，請參閱將 Amazon QLDB 分類帳遷移到 Amazon Aurora 郵政. SQL

在 Amazon 中QLDB，使用命INSERT令將一個或多個 Amazon Ion 文檔添加到表中。

注意

若要瞭解如何控制在特定資料表上執行此 PartiQL 命令的存取權，請參閱開始使用 Amazon 的標準許可模式 QLDB。

語法

插入單一文件。

INSERT INTO table_name VALUE document

插入多個文件。

INSERT INTO table_name << document, document, ... >>

參數

table_name

要在其中插入資料的使用者表格名稱。索資料表必須已存在。DML只有預設使用者檢視中才支援陳述式。

document

有效的QLDB文件。您必須指定至少一個文件。多個文件必須以逗號分隔。

該文檔必須用大括號（{...}）來表示。

文件中的每個欄位名稱都是區分大小寫的 Ion 符號，可在 PartiQL 中以單引號 ('...') 表示。

在 PartiQL 中，字串值也會以單引號 ('...') 表示。

任何離子文字都可以用反引號（）表示。`...`

注意

雙角括號 (<<...>>) 表示無序集合（在 PartiQL 中稱為袋），並且只有在您要插入多個文檔時才需要使用。

傳回值

documentId— 您插入的每個文件的唯一 ID。

範例

插入單一文件。

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidFromDate' : `2017-09-14T`, --Ion timestamp literal with day precision
    'ValidToDate' : `2020-06-25T`
}

這個陳述式會傳回您插入之文件的唯一 ID，如下所示。

{
    documentId: "2kKuOPNB07D2iTPBrUTWGl"
}

插入多個文件。

INSERT INTO Person << 
{
    'FirstName' : 'Raul',
    'LastName' : 'Lewis',
    'DOB' : `1963-08-19T`,
    'GovId' : 'LEWISR261LL',
    'GovIdType' : 'Driver License',
    'Address' : '1719 University Street, Seattle, WA, 98109'
},
{
    'FirstName' : 'Brent',
    'LastName' : 'Logan',
    'DOB' : `1967-07-03T`,
    'GovId' : 'LOGANB486CG',
    'GovIdType' : 'Driver License',
    'Address' : '43 Stockert Hollow Road, Everett, WA, 98203'
},
{
    'FirstName' : 'Alexis',
    'LastName' : 'Pena',
    'DOB' : `1974-02-10T`,
    'GovId' : '744 849 301',
    'GovIdType' : 'SSN',
    'Address' : '4058 Melrose Street, Spokane Valley, WA, 99206'
}
>>

這個陳述式會傳回您插入的每個文件的唯一 ID，如下所示。

{
    documentId: "6WXzLscsJ3bDWW97Dy8nyp"
},
{
    documentId: "35e0ToZyTGJ7LGvcwrkX65"
},
{
    documentId: "BVHPcH612o7JROQ4yP8jiH"
}

以編程方式使用驅動程序

若要了解如何以程式設計方式使用QLDB驅動程式執行此陳述式，請參閱開始使用驅動程式中的下列教學課程：