INSERT亚马逊中的命令 QLDB - 亚马逊 Quantum Ledger 数据库（亚马逊QLDB）
语法参数返回值示例使用驱动程序以编程方式运行

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

INSERT亚马逊中的命令 QLDB

重要

终止支持通知：现有客户可以在2025年7月31日终止支持QLDB之前使用亚马逊。有关更多详细信息，请参阅将亚马逊QLDB账本迁移到亚马逊 Aurora Postgr SQL e。

在 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 中表示。

任何 Ion 文字都可以用反引号（`...`）表示。

注意

双尖括号（<<...>>）表示无序集合（ 在 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驱动程序入门中的以下教程：