Java SDK建立二級索引 - Tablestore

二級索引相當於把資料表的主鍵查詢能力擴充到了不同的列，當需要使用屬性查詢資料時，您可以通過建立二級索引加快資料查詢的效率。設定預定義列後，在建立二級索引時將預定義列作為索引表的索引列或者屬性列。您可以使用CreateIndex介面在已存在的資料表上建立一個索引表。

說明

二級索引包括全域二級索引和本地二級索引。關於二級索引的更多資訊，請參見二級索引。
您也可以使用CreateTable介面在建立資料表的同時建立一個或者多個索引表。具體操作，請參見建立資料表。

前提條件

已初始化Client。具體操作，請參見初始化OTSClient。
已建立資料表，且資料表的最大版本數（maxVersions）必須為1，資料生命週期（timeToLive）必須滿足如下條件中的任意一個。
- 資料表的資料生命週期為-1（資料永不到期）。
- 資料表的資料生命週期不為-1時，資料表為禁止更新狀態。
資料表已設定預定義列。

注意事項

索引表名稱不能與已存在的時序表名稱和資料表名稱相同。
建立二級索引時，系統會自動將未出現在索引列中的資料表主鍵補齊到索引表主鍵中。
建立本地二級索引時，索引表的第一列主鍵必須與資料表的第一列主鍵相同。

參數

參數	說明
mainTableName	資料表名稱。
indexMeta	索引表的結構資訊，包括如下內容： indexName：索引表名稱。 primaryKey：索引表的索引列，索引列為資料表主鍵和預定義列的組合。使用本地二級索引時，索引表的第一個主鍵列必須與資料表的第一個主鍵列相同。 definedColumns：索引表的屬性列，索引表屬性列為資料表的預定義列的組合。 indexType：索引類型。可選值包括IT_GLOBAL_INDEX和IT_LOCAL_INDEX。當不設定indexType或者設定indexType為IT_GLOBAL_INDEX時，表示使用全域二級索引。使用全域索引時，Table Store以非同步方式將資料表中被索引的列和主鍵列的資料自動同步到索引表中，正常情況下同步延遲達到毫秒層級。當設定indexType為IT_LOCAL_INDEX時，表示使用本地二級索引。使用本地二級索引時，Table Store以同步方式將資料表中被索引的列和主鍵列的資料自動同步到索引表中，當資料寫入資料表後，即可從索引表中查詢到資料。 indexUpdateMode：索引更新模式。可選值包括IUM_ASYNC_INDEX和IUM_SYNC_INDEX。當不設定indexUpdateMode或者設定indexUpdateMode為IUM_ASYNC_INDEX時，表示非同步更新。使用全域二級索引時，索引更新模式必須設定為非同步更新（IUM_ASYNC_INDEX）。當設定indexUpdateMode為IUM_SYNC_INDEX時，表示同步更新。使用本地二級索引時，索引更新模式必須設定為同步更新（IUM_SYNC_INDEX）。
includeBaseData	索引表中是否包含資料表中已存在的資料。當CreateIndexRequest中的最後一個參數includeBaseData設定為true時，表示包含存量資料；設定為false時，表示不包含存量資料。

樣本

建立全域二級索引

以下樣本用於為資料表建立一個全域二級索引。

private static void createIndex(SyncClient client) {
    //設定索引表名稱。
    IndexMeta indexMeta = new IndexMeta("<INDEX_NAME>"); 
    //為索引表添加主鍵列，設定DEFINED_COL_NAME_1列為索引表的第一列主鍵。
    indexMeta.addPrimaryKeyColumn(DEFINED_COL_NAME_1); 
    //為索引表添加主鍵列，設定PRIMARY_KEY_NAME_2列為索引表的第二列主鍵。
    indexMeta.addPrimaryKeyColumn(PRIMARY_KEY_NAME_2); 
    //為索引表添加屬性列，設定DEFINED_COL_NAME_2列為索引表的屬性列。
    indexMeta.addDefinedColumn(DEFINED_COL_NAME_2); 
    //添加索引表到資料表，包含存量資料。
    //CreateIndexRequest request = new CreateIndexRequest("<TABLE_NAME>", indexMeta, true); 
    //添加索引表到資料表，不包含存量資料。
    CreateIndexRequest request = new CreateIndexRequest("<TABLE_NAME>", indexMeta, false); 
    /**通過將IncludeBaseData參數設定為true，建立索引表後會開啟資料表中存量資料的同步，然後可以通過索引表查詢全部資料，
       同步時間和資料量的大小有一定的關係。
    */
    //request.setIncludeBaseData(true);
    //建立索引表。
    client.createIndex(request); 
}

建立本地二級索引

以下樣本用於建立一個本地二級索引。

private static void createIndex(SyncClient client) {
    //設定索引表名稱。
    IndexMeta indexMeta = new IndexMeta("<INDEX_NAME>"); 
    //為索引表添加主鍵列，設定PRIMARY_KEY_NAME_1列為索引表的第一列主鍵。
    //本地二級索引的第一列主鍵必須與資料表的第一列主鍵相同。
    indexMeta.addPrimaryKeyColumn(PRIMARY_KEY_NAME_1); 
    //為索引表添加主鍵列，設定DEFINED_COL_NAME_1列為索引表的第二列主鍵。
    indexMeta.addPrimaryKeyColumn(DEFINED_COL_NAME_1); 
    //為索引表添加屬性列，設定DEFINED_COL_NAME_2列為索引表的屬性列。
    indexMeta.addDefinedColumn(DEFINED_COL_NAME_2); 
    //設定索引類型為IT_LOCAL_INDEX（本地二級索引）。
    indexMeta.setIndexType(IT_LOCAL_INDEX);
    //設定同步模式為IUM_SYNC_INDEX（同步更新）。
    indexMeta.setIndexUpdateMode(IUM_SYNC_INDEX);
    //添加索引表到資料表，包含存量資料。
    //CreateIndexRequest request = new CreateIndexRequest("<TABLE_NAME>", indexMeta, true); 
    //添加索引表到資料表，不包含存量資料。
    CreateIndexRequest request = new CreateIndexRequest("<TABLE_NAME>", indexMeta, false); 
    /**通過將IncludeBaseData參數設定為true，建立索引表後會開啟資料表中存量資料的同步，然後可以通過索引表查詢全部資料，
       同步時間和資料量的大小有一定的關係。
    */
    //request.setIncludeBaseData(true);
    //建立索引表。
    client.createIndex(request); 
}

Tablestore：建立二級索引

前提條件

注意事項

參數

樣本

建立全域二級索引

建立本地二級索引

相關文檔