在亞馬遜 QLDB 中創建索引命令 - Amazon Quantum Ledger Database (Amazon QLDB)

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

在亞馬遜 QLDB 中創建索引命令

在 Amazon QLDB 中,使用命CREATE INDEX令為表格上的文件欄位建立索引。

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

重要

QLDB 需要一個索引來有效地查找文檔。如果沒有索引,QLDB 需要在讀取文檔時進行全表掃描。這可能會造成大型資料表的效能問題,包括並行衝突和交易逾時。

若要避免資料表掃描,您必須在索引欄位或文件 ID 上使用相等運算子 (=IN) 執行具有述WHERE詞子句的陳述式。如需詳細資訊,請參閱最佳化查詢效能

建立索引時,請注意下列條件約束:

  • 索引只能在單一頂層欄位上建立。不支援複合、巢狀、唯一和以函數為基礎的索引。

  • 您可以在任何 Ion 資料類型上建立索引,包括liststruct。但是,無論 Ion 類型如何,您都只能通過整個 Ion 值的相等性來進行索引查找。例如,當使用list類型作為索引時,您不能通過列表中的一個項目進行索引查找。

  • 只有在您使用相等述詞時才會改善查詢效能;例如,WHERE indexedField = 123WHERE indexedField IN (456, 789)

    QLDB 不尊重查詢謂詞中的不等式。因此,範圍篩選的掃描不會實作。

  • 索引欄位的名稱區分大小寫,且最大長度可為 128 個字元。

  • QLDB 中的索引建立是非同步的。完成建立非空資料表所需的時間量。如需詳細資訊,請參閱 管理索引

語法

CREATE INDEX ON table_name (field)

參數

table_name

要在其中建立索引的資料表的名稱。索資料表必須已存在。

資料表名稱區分大小寫。

欄位

要為其建立索引的文件欄位名稱。欄位必須是頂層屬性。

索引欄位的名稱區分大小寫,且最大長度可為 128 個字元。

您可以在任何 Amazon Ion 資料類型上建立索引,包括liststruct。但是,無論 Ion 類型如何,您都只能通過整個 Ion 值的相等性來進行索引查找。例如,當使用list類型作為索引時,您不能通過列表中的一個項目進行索引查找。

傳回值

tableId— 您建立索引之資料表的唯一 ID。

範例

CREATE INDEX ON VehicleRegistration (LicensePlateNumber)
CREATE INDEX ON Vehicle (VIN)

以編程方式使用驅動程序

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