在亞馬遜 QLDB 插入命令 - Amazon Quantum Ledger Database (Amazon QLDB)
語法參數傳回值範例以編程方式使用驅動程序

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

在亞馬遜 QLDB 插入命令

在亞馬遜 QLDB 中，使用INSERT命令將一個或多個 Amazon 離子文檔添加到表中。

注意

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

語法

插入單一文件。

INSERT INTO table_name VALUE document

插入多個文件。

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

參數

table_name

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

文件

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

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

文件中的每個欄位名稱都是區分大小寫的 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 驅動程式執行此陳述式，請參閱開始使用驅動程式中的下列教學課程：