PHPSDK多元索引如何使用摺疊 -

當資料查詢的結果中含有某種類型的資料較多時，可以使用摺疊（Collapse）功能按照某一列對結果集做摺疊，使對應類型的資料在結果展示中只出現一次，保證結果展示中類型的多樣性。

前提條件

已初始化OTSClient。具體操作，請參見初始化OTSClient。
已建立資料表並寫入資料。具體操作，請參見建立資料表和寫入資料。
已在資料表上建立多元索引。具體操作，請參見建立多元索引。

注意事項

摺疊功能只能使用offset+limit方式翻頁，不能使用token方式。
對結果集同時使用統計彙總與摺疊功能時，統計彙總功能只作用於使用摺疊功能前的結果集。
使用摺疊功能後，返回的總分組數取決於offset+limit的最大值，目前支援返回的總分組數最大為50000。
執行結果中返回的總行數是使用摺疊功能前的匹配行數，使用摺疊功能後的總分組數無法擷取。

參數

參數	說明
table_name	資料表名稱。
index_name	多元索引名稱。
query	可以是任意Query類型。
collapse	摺疊參數設定，包含field_name設定。 field_name：列名，按該列對結果集做摺疊，只支援應用於整型、浮點數和Keyword類型的列，不支援數群組類型的列。
offset	本次查詢的開始位置。
limit	本次查詢需要返回的最大數量。如果只為了擷取行數，無需具體資料，可以設定limit=0，即不返回任意一行資料。

樣本

以下樣本用於在php_sdk_test表中尋找資料，通過索引快速擷取最多10條不重複keyword的記錄，同時返回col1、col2兩列的資料。

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 10,
        'get_total_count' => true,
        'collapse' => array(
            'field_name' => 'keyword'
        ),
        'query' => array(
            'query_type' => QueryTypeConst::MATCH_ALL_QUERY
        ),
//        'sort' => array(//如果需要特定排序。
//            array(
//                'field_sort' => array(
//                    'field_name' => 'keyword',
//                    'order' => SortOrderConst::SORT_ORDER_ASC
//                )
//            ),
//        ),
        'token' => null,
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('col1', 'col2')
    )
);
$response = $otsClient->search($request);

：摺疊（去重）

前提條件

注意事項

參數

樣本

常見問題

相關文檔