QLDB使用控制台访问 Amazon - 亚马逊 Quantum Ledger 数据库（亚马逊QLDB）
PartiQL 编辑器快速参考

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

QLDB使用控制台访问 Amazon

重要

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

你可以访问 AWS Management Console 适用于亚马逊，网址QLDB为 https://console.aws.amazon.com/qldb。

您可以使用控制台在中执行以下操作QLDB：

  • 创建、删除、描述和列出分类账。

  • 使用PartiQL 编辑器运行PartiQL语句。

  • 管理QLDB资源的标签。

  • 以加密方式验证日志数据。

  • 导出或流式传输日志数据块。

要了解如何创建 Amazon QLDB 账本并使用示例应用程序数据进行设置，请参阅开始使用 Amazon QLDB 控制台。

PartiQL 编辑器快速参考

重要

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

亚马逊QLDB支持 Parti QL 的子集作为其查询语言，支持 A mazon Ion 作为其面向文档的数据格式。有关 PartiQL QLDB 实现的完整指南和更多详细信息，请参阅。亚马逊 P QLDB artiQL 参考资料

以下主题提供了有关如何在中使用 PartiQL 的快速参考概述。QLDB

PartiQL 中的快速提示 QLDB

以下是使用PartiQL的提示和最佳实践的简短摘要：QLDB

  • 了解并发和事务限制 — 包括SELECT查询在内的所有语句都受乐观并发控制 (OCC) 冲突和事务限制（包括 30 秒的事务超时）的约束。

  • 使用索引 - 使用高基数索引，并运行有针对性的查询来优化语句并避免全表扫描。要了解更多信息，请参阅 优化查询性能。

  • 使用相等谓词 - 索引查找需要相等运算符（= 或 IN）。不等式运算符（<、>、LIKE、BETWEEN）不符合索引查找的条件，因此会生成全表扫描。

  • 仅@@ 使用内部联接-仅QLDB支持内部联接。根据最佳实践标准，在为要加入的每个表编制索引的字段上进行联接。为联接条件与相等谓词选择高基数索引。

命令

QLDB支持以下 PartiQL 命令。

数据定义语言 (DDL)
命令 描述
CREATE INDEX 为表内的顶级文档字段创建索引。
CREATE TABLE 创建表。
DROP INDEX 从表中删除索引。
DROP TABLE 停用现有表。
UNDROP TABLE 重新激活非活动表。
数据操作语言 (DML)
命令 描述
DELETE 通过创建文档最终修订版，将活动文档标记为已删除。
FROM(INSERTREMOVE、或SET) 语义与UPDATE相同。
INSERT 向表格中添加一个或多个 文档。
SELECT 从一个或多个表中检索数据。
UPDATE 更新、插入或移除文档中的特定元素。

DML陈述示例

INSERT

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

UPDATE-INSERT

UPDATE Vehicle AS v
INSERT INTO v VALUE 26500 AT 'Mileage'
WHERE v.VIN = '1N4AL11D75C109151'

UPDATE-REMOVE

UPDATE Person AS p
REMOVE p.Address
WHERE p.GovId = '111-22-3333'

SELECT— 关联子查询

SELECT r.VIN, o.SecondaryOwners
FROM VehicleRegistration AS r, @r.Owners AS o
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

SELECT— 内部连接

SELECT v.Make, v.Model, r.Owners
FROM VehicleRegistration AS r INNER JOIN Vehicle AS v
ON r.VIN = v.VIN
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

SELECT— 使用 BY 子句获取文档 ID

SELECT r_id FROM VehicleRegistration AS r BY r_id
WHERE r.VIN = '1HVBBAANXWH544237'

System-defined 视图

QLDB支持以下系统定义的表格视图。

查看 描述
table_name 表格默认用户视图，仅包含用户数据的当前状态。
_ql_committed_table_name 表格的完整系统定义提交视图，其中包含用户数据和系统生成的元数据（例如文档 ID）的当前状态。
history(table_name) 内置历史记录函数，可返回表格的完整修订历史记录。

基本语法规则

QLDB支持以下 PartiQL 的基本语法规则。

字符 描述
' 在单引号表示字符串值或 Amazon Ion 结构的字段名称。
" 双引号表示带引号的标识符，如用作表名的 保留字。
` 反引号表示 Ion 文本值。
. 用点表示法访问父结构的字段名称。
[ ] 方括号定义 Ion list，或者表示现有列表从零开始的序数。
{ } 大括号定义 Ion struct。
<< >> 双尖括号定义了 PartiQL 数据包，这是无序集合。你用一个数据包将多个文档插入表格。
区分大小写 所有QLDB系统对象名称（包括字段名和表名）均区分大小写。

PartiQL 编辑器键盘快捷键

QLDB控制台上的 P artiQL 编辑器支持以下键盘快捷键。

操作 macOS Windows
运行 Cmd+Return Ctrl+Enter
注释 Cmd+/ Ctrl+/
Clear Cmd+Shift+Delete Ctrl+Shift+Delete