前提條件

• 已初始化Client。具體操作，請參見初始化OTSClient。

• 已創建數據表并寫入數據。具體操作，請參見創建數據表和寫入數據。

• 已在數據表上創建多元索引。具體操作，請參見創建多元索引。

注意事項

• 折疊功能只能使用Offset+Limit方式翻頁，不能使用Token方式。

• 對結果集同時使用統計聚合與折疊功能時，統計聚合功能只作用于使用折疊功能前的結果集。

• 使用折疊功能后，返回的總分組數取決于Offset+Limit的最大值，目前支持返回的總分組數最大為100000。

• 執行結果中返回的總行數是使用折疊功能前的匹配行數，使用折疊功能后的總分組數無法獲取。

參數

示例

以下示例用于查詢表中user_id列的值能夠匹配"00002"的數據，結果集按照product_name列的值做折疊。

func QueryWithCollapse(client *tablestore.TableStoreClient, tableName string, indexName string) {
    searchRequest := &tablestore.SearchRequest{}
    searchRequest.SetTableName(tableName)       //設置數據表名稱。
    searchRequest.SetIndexName(indexName)       //設置多元索引名稱。

    searchQuery := search.NewSearchQuery()
    searchQuery.SetQuery(&search.MatchQuery{    //構造查詢條件。
        FieldName:          "user_id",
        Text:               "00002",
    })
    searchQuery.SetCollapse(&search.Collapse{
        FieldName: "product_name",              //根據"product_name"列對結果集做折疊。

    })
    searchQuery.SetOffset(0)
    searchQuery.SetLimit(100)
    searchRequest.SetColumnsToGet(&tablestore.ColumnsToGet{ReturnAll:true}) //設置為返回所有列。
    searchRequest.SetSearchQuery(searchQuery)

    searchResponse, err := client.Search(searchRequest)   //查詢。
    if err != nil {
        fmt.Println("Failed to search with error:", err)
        return
    }
    for _, row := range searchResponse.Rows {           //打印本次返回的行。
        jsonBody, err := json.Marshal(row)
        if err != nil {
            panic(err)
        }
        fmt.Println("Row: ", string(jsonBody))
    }
}

常見問題

• 使用多元索引Search接口查不到數據

• 如何將多元索引 Search 接口查詢數據的 limit 提高到 1000

• 為什么使用多元索引翻頁查詢時Token失效了？

相關文檔

• 多元索引查詢類型包括精確查詢、多詞精確查詢、全匹配查詢、匹配查詢、短語匹配查詢、前綴查詢、范圍查詢、通配符查詢、多條件組合查詢、地理位置查詢、嵌套類型查詢、向量檢索和列存在性查詢，您可以選擇合適的查詢類型進行多維度數據查詢。

  如果要對結果集進行排序或者翻頁，您可以使用排序和翻頁功能來實現。具體操作，請參見排序和翻頁。

  如果要按照某一列對結果集做折疊，使對應類型的數據在結果展示中只出現一次，您可以使用折疊（去重）功能來實現。具體操作，請參見折疊（去重）。

• 如果要進行數據分析，例如求最值、求和、統計行數等，您可以使用Search接口的統計聚合功能或者SQL查詢來實現。具體操作，請參見統計聚合和SQL查詢。

• 如果要快速導出數據，而不關心整個結果集的順序時，您可以使用ParallelScan接口和ComputeSplits接口實現多并發導出數據。具體操作，請參見并發導出數據。