查询数据

重要

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

用户视图 仅返回用户数据的最新未删除版本。这是 Amazon 中的默认视图QLDB。这意味着，当您只想查询自己的数据时，不需要特殊限定符。

有关以下查询示例的语法和参数的详细信息，请参阅 Amazon P QLDB artiQL 参考SELECT中的。

主题

基本查询
投影和筛选
联接
嵌套数据

基本查询

基本 SELECT 查询会返回您插入表格中的文档。

警告

当您在没有索引查询QLDB的情况下在中运行查询时，它会调用全表扫描。PartiQL 之所以支持此类查询，是因为它是兼容的。SQL但是，不要在中对生产用例运行表扫描QLDB。表扫描可能会导致大型表出现性能问题，包括并发冲突与事务超时。

为避免表扫描，必须在索引字段或文档 ID 上使用相等运算符（WHERE indexedField = 123或WHERE indexedField IN (456, 789)）运行带有WHERE谓词子句的语句。有关更多信息，请参阅优化查询性能。

以下查询显示了您之前在创建带有索引的表和插入文档中插入的车辆登记文件的结果。结果的顺序不指定，可能因每个SELECT查询而异。中的任何查询都不应依赖结果顺序QLDB。


SELECT * FROM VehicleRegistration
WHERE LicensePlateNumber IN ('LEWISR261LL', 'CA762X')


{
    VIN: "1N4AL11D75C109151",
    LicensePlateNumber: "LEWISR261LL",
    State: "WA",
    City: "Seattle",
    PendingPenaltyTicketAmount: 90.25,
    ValidFromDate: 2017-08-21T,
    ValidToDate: 2020-05-11T,
    Owners: {
        PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
        SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
    }
},
{
    VIN: "KM8SRDHF6EU074761",
    LicensePlateNumber: "CA762X",
    State: "WA",
    City: "Kent",
    PendingPenaltyTicketAmount: 130.75,
    ValidFromDate: 2017-09-14T,
    ValidToDate: 2020-06-25T,
    Owners: {
        PrimaryOwner: { PersonId: "IN7MvYtUjkp1GMZu0F6CG9" },
        SecondaryOwners: []
    }
}


SELECT * FROM Vehicle
WHERE VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')


{
    VIN: "1N4AL11D75C109151",
    Type: "Sedan",
    Year: 2011,
    Make: "Audi",
    Model: "A5",
    Color: "Silver"
},
{
    VIN: "KM8SRDHF6EU074761",
    Type: "Sedan",
    Year: 2015,
    Make: "Tesla",
    Model: "Model S",
    Color: "Blue"
}

重要

在 PartiQL 中，您可以使用单引号来表示数据操作语言 (DML) 或查询语句中的字符串。但是QLDB控制台和QLDB外壳程序以 Amazon Ion 文本格式返回查询结果，因此您会看到用双引号括起来的字符串。

此语法允许 PartiQL 查询语言保持SQL兼容性，并允许 Amazon Ion 文本格式保持JSON兼容性。

投影和筛选

您可以进行预测（定向SELECT）和其他标准筛选条件（WHERE条款）。以下查询返回 VehicleRegistration 表中文档字段的子集。它可筛选符合以下标准的车辆：

字符串筛选条件 — 它已在西雅图注册。
十进制筛选条件 — 它的待处理工单数量小于 100.0。
日期筛选退傲剑 — 其注册日期在 2019 年 9 月 4 日或之后有效。


SELECT r.VIN, r.PendingPenaltyTicketAmount, r.Owners
FROM VehicleRegistration AS r
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')
AND r.City = 'Seattle' --string
AND r.PendingPenaltyTicketAmount < 100.0 --decimal
AND r.ValidToDate >= `2019-09-04T` --timestamp with day precision


{
    VIN: "1N4AL11D75C109151",
    PendingPenaltyTicketAmount: 90.25,
    Owners: {
        PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
        SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
    }
}

联接

您也可编写内部联接查询。以下示例显示了隐式内部联接查询，该查询返回所有注册文件以及已注册车辆的属性。


SELECT * FROM VehicleRegistration AS r, Vehicle AS v
WHERE r.VIN = v.VIN
AND r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')


{
    VIN: "1N4AL11D75C109151",
    LicensePlateNumber: "LEWISR261LL",
    State: "WA",
    City: "Seattle",
    PendingPenaltyTicketAmount: 90.25,
    ValidFromDate: 2017-08-21T,
    ValidToDate: 2020-05-11T,
    Owners: {
        PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
        SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
    },
    Type: "Sedan",
    Year: 2011,
    Make: "Audi",
    Model: "A5",
    Color: "Silver"
},
{
    VIN: "KM8SRDHF6EU074761",
    LicensePlateNumber: "CA762X",
    State: "WA",
    City: "Kent",
    PendingPenaltyTicketAmount: 130.75,
    ValidFromDate: 2017-09-14T,
    ValidToDate: 2020-06-25T,
    Owners: {
        PrimaryOwner: { PersonId: "IN7MvYtUjkp1GMZu0F6CG9" },
        SecondaryOwners: []
    },
    Type: "Sedan",
    Year: 2015,
    Make: "Tesla",
    Model: "Model S",
    Color: "Blue"
}

或者，您可使用如下显式语法编写相同的内部联接查询。


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

嵌套数据

您可以在中使用 PartiQL QLDB 来查询文档中的嵌套数据。以下示例展示了用于扁平化嵌套数据的相关子查询。此处的 @ 字符在技术上是可选的。但它明确表示你想在里面放置一个Owners结构VehicleRegistration，而不是一个名为不同的集合Owners（如有）。


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


{
    VIN: "1N4AL11D75C109151",
    SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
},
{
    VIN: "KM8SRDHF6EU074761",
    SecondaryOwners: []
}

下图展示了SELECT 列表中的子查询，除了内部联接外，该查询还投射嵌套数据。


SELECT 
    v.Make, 
    v.Model, 
    (SELECT VALUE o.PrimaryOwner.PersonId FROM @r.Owners AS o) AS PrimaryOwner
FROM 
    VehicleRegistration AS r, Vehicle AS v
WHERE 
    r.VIN = v.VIN AND r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')


{
    Make: "Audi",
    Model: "A5",
    PrimaryOwner: ["294jJ3YUoH1IEEm8GSabOs"]
},
{
    Make: "Tesla",
    Model: "Model S",
    PrimaryOwner: ["IN7MvYtUjkp1GMZu0F6CG9"]
}

以下查询返回表 VehicleRegistration 文档的 Owners.SecondaryOwners 列表中每个人的 PersonId 和索引（序数）。


SELECT s.PersonId, owner_idx
FROM VehicleRegistration AS r, @r.Owners.SecondaryOwners AS s AT owner_idx
WHERE r.VIN = '1N4AL11D75C109151'

{
    PersonId: "5Ufgdlnj06gF5CWcOIu64s",
    owner_idx: 0
}

要了解如何查询您的文档元数据，请继续查询文档元数据。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

创建带有索引的表和插入文档

查询文档元数据