本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在亞馬遜 QLDB 中創建索引命令
在 Amazon QLDB 中,使用命CREATE INDEX
令為表格上的文件欄位建立索引。
若要瞭解如何控制在特定資料表上執行此 PartiQL 命令的存取權,請參閱開始使用 Amazon QLDB 中的標準許可模式。
重要
QLDB 需要一個索引來有效地查找文檔。如果沒有索引,QLDB 需要在讀取文檔時進行全表掃描。這可能會造成大型資料表的效能問題,包括並行衝突和交易逾時。
若要避免資料表掃描,您必須在索引欄位或文件 ID 上使用相等運算子 (=
或IN
) 執行具有述WHERE
詞子句的陳述式。如需詳細資訊,請參閱最佳化查詢效能。
建立索引時,請注意下列條件約束:
-
索引只能在單一頂層欄位上建立。不支援複合、巢狀、唯一和以函數為基礎的索引。
-
您可以在任何 Ion 資料類型上建立索引,包括
list
和struct
。但是,無論 Ion 類型如何,您都只能通過整個 Ion 值的相等性來進行索引查找。例如,當使用list
類型作為索引時,您不能通過列表中的一個項目進行索引查找。 -
只有在您使用相等述詞時才會改善查詢效能;例如,
WHERE indexedField = 123
或WHERE indexedField IN (456, 789)
。QLDB 不尊重查詢謂詞中的不等式。因此,範圍篩選的掃描不會實作。
-
索引欄位的名稱區分大小寫,且最大長度可為 128 個字元。
-
QLDB 中的索引建立是非同步的。完成建立非空資料表所需的時間量。如需詳細資訊,請參閱 管理索引。
語法
CREATE INDEX ON
table_name
(field
)
參數
table_name
-
要在其中建立索引的資料表的名稱。索資料表必須已存在。
資料表名稱區分大小寫。
欄位
-
要為其建立索引的文件欄位名稱。欄位必須是頂層屬性。
索引欄位的名稱區分大小寫,且最大長度可為 128 個字元。
您可以在任何 Amazon Ion 資料類型上建立索引,包括
list
和struct
。但是,無論 Ion 類型如何,您都只能通過整個 Ion 值的相等性來進行索引查找。例如,當使用list
類型作為索引時,您不能通過列表中的一個項目進行索引查找。
傳回值
tableId
— 您建立索引之資料表的唯一 ID。
範例
CREATE INDEX ON VehicleRegistration (LicensePlateNumber)
CREATE INDEX ON Vehicle (VIN)
以編程方式使用驅動程序
若要了解如何以程式設計方式使用 QLDB 驅動程式執行此陳述式,請參閱開始使用驅動程式中的下列教學課程: