Deprecate topK for search/hybridSearch/iterator, replaced with limit (#1438)

Signed-off-by: yhmo <yihua.mo@zilliz.com>

examples/src/main/java/io/milvus/v1/BinaryVectorExample.java

@@ -157,7 +157,7 @@ public class BinaryVectorExample {
             R<SearchResults> searchRet = milvusClient.search(SearchParam.newBuilder()
                     .withCollectionName(COLLECTION_NAME)
                     .withMetricType(MetricType.HAMMING)
-                    .withTopK(3)
+                    .withLimit(3L)
                     .withBinaryVectors(Collections.singletonList(targetVector))
                     .withVectorFieldName(VECTOR_FIELD)
                     .addOutField(VECTOR_FIELD)

examples/src/main/java/io/milvus/v1/ClientPoolExample.java

@@ -163,7 +163,7 @@ public class ClientPoolExample {
                     R<SearchResults> searchRet = client.search(SearchParam.newBuilder()
                             .withCollectionName(CollectionName)
                             .withMetricType(MetricType.L2)
-                            .withTopK(10)
+                            .withLimit(10L)
                             .withFloatVectors(Collections.singletonList(CommonUtils.generateFloatVector(DIM)))
                             .withVectorFieldName(VectorFieldName)
                             .withParams("{}")

examples/src/main/java/io/milvus/v1/ConsistencyLevelExample.java

@@ -137,7 +137,7 @@ public class ConsistencyLevelExample {
                 .withCollectionName(collectionName)
                 .withVectorFieldName("vector")
                 .withFloatVectors(Collections.singletonList(CommonUtils.generateFloatVector(VECTOR_DIM)))
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withMetricType(MetricType.L2)
                 .build());
         CommonUtils.handleResponseStatus(searchR);
@@ -204,7 +204,7 @@ public class ConsistencyLevelExample {
                     .withCollectionName(collectionName)
                     .withVectorFieldName("vector")
                     .withFloatVectors(Collections.singletonList(vector))
-                    .withTopK(1)
+                    .withLimit(1L)
                     .withMetricType(MetricType.L2)
                     .build());
             pool.returnClient(clientName2, client2); // don't forget to return the client to pool

examples/src/main/java/io/milvus/v1/Float16VectorExample.java

@@ -184,7 +184,7 @@ public class Float16VectorExample {
             SearchParam.Builder builder = SearchParam.newBuilder()
                     .withCollectionName(COLLECTION_NAME)
                     .withMetricType(MetricType.L2)
-                    .withTopK(3)
+                    .withLimit(3L)
                     .withVectorFieldName(VECTOR_FIELD)
                     .addOutField(VECTOR_FIELD)
                     .withParams("{\"nprobe\":32}");

examples/src/main/java/io/milvus/v1/GeneralExample.java

@@ -64,7 +64,7 @@ public class GeneralExample {
     private static final IndexType INDEX_TYPE = IndexType.IVF_FLAT;
     private static final String INDEX_PARAM = "{\"nlist\":128}";
 
-    private static final Integer SEARCH_K = 5;
+    private static final Long SEARCH_K = 5L;
     private static final String SEARCH_PARAM = "{\"nprobe\":10}";
     
 
@@ -331,7 +331,7 @@ public class GeneralExample {
                 .withCollectionName(COLLECTION_NAME)
                 .withMetricType(MetricType.L2)
                 .withOutFields(outFields)
-                .withTopK(SEARCH_K)
+                .withLimit(SEARCH_K)
                 .withFloatVectors(vectors)
                 .withVectorFieldName(VECTOR_FIELD)
                 .withExpr(expr)

examples/src/main/java/io/milvus/v1/HybridSearchExample.java

@@ -226,14 +226,14 @@ public class HybridSearchExample {
                 .withFloatVectors(CommonUtils.generateFloatVectors(FLOAT_VECTOR_DIM, NQ))
                 .withMetricType(FLOAT_VECTOR_METRIC)
                 .withParams("{\"nprobe\": 32}")
-                .withTopK(10)
+                .withLimit(10L)
                 .build();
 
         AnnSearchParam req2 = AnnSearchParam.newBuilder()
                 .withVectorFieldName(BINARY_VECTOR_FIELD)
                 .withBinaryVectors(CommonUtils.generateBinaryVectors(BINARY_VECTOR_DIM, NQ))
                 .withMetricType(BINARY_VECTOR_METRIC)
-                .withTopK(15)
+                .withLimit(15L)
                 .build();
 
         AnnSearchParam req3 = AnnSearchParam.newBuilder()
@@ -241,7 +241,7 @@ public class HybridSearchExample {
                 .withFloat16Vectors(CommonUtils.generateFloat16Vectors(FLOAT16_VECTOR_DIM, NQ, false))
                 .withMetricType(FLOAT16_VECTOR_METRIC)
                 .withParams("{\"ef\":64}")
-                .withTopK(20)
+                .withLimit(20L)
                 .build();
 
         AnnSearchParam req4 = AnnSearchParam.newBuilder()
@@ -249,7 +249,7 @@ public class HybridSearchExample {
                 .withSparseFloatVectors(CommonUtils.generateSparseVectors(NQ))
                 .withMetricType(SPARSE_VECTOR_METRIC)
                 .withParams("{\"drop_ratio_search\":0.2}")
-                .withTopK(20)
+                .withLimit(20L)
                 .build();
 
         HybridSearchParam searchParam = HybridSearchParam.newBuilder()
@@ -262,7 +262,7 @@ public class HybridSearchExample {
                 .addSearchRequest(req2)
                 .addSearchRequest(req3)
                 .addSearchRequest(req4)
-                .withTopK(5)
+                .withLimit(5L)
                 .withConsistencyLevel(ConsistencyLevelEnum.STRONG)
                 .withRanker(RRFRanker.newBuilder()
                         .withK(2)

examples/src/main/java/io/milvus/v1/IteratorExample.java

@@ -239,16 +239,18 @@ public class IteratorExample {
 
     private void iterateQueryResult(QueryIterator queryIterator) {
         int pageIdx = 0;
+        int iterateCount = 0;
         while (true) {
             List<QueryResultsWrapper.RowRecord> res = queryIterator.next();
             if (res.isEmpty()) {
-                System.out.println("query iteration finished, close");
+                System.out.printf("query iteration finished, %d rows iterated, iterator close\n", iterateCount);
                 queryIterator.close();
                 break;
             }
 
             for (QueryResultsWrapper.RowRecord re : res) {
                 System.out.println(re);
+                iterateCount++;
             }
             pageIdx++;
             System.out.printf("page%s-------------------------%n", pageIdx);
@@ -257,16 +259,18 @@ public class IteratorExample {
 
     private void iterateSearchResult(SearchIterator searchIterator) {
         int pageIdx = 0;
+        int iterateCount = 0;
         while (true) {
             List<QueryResultsWrapper.RowRecord> res = searchIterator.next();
             if (res.isEmpty()) {
-                System.out.println("search iteration finished, close");
+                System.out.printf("search iteration finished, %d rows iterated, iterator close\n", iterateCount);
                 searchIterator.close();
                 break;
             }
 
             for (QueryResultsWrapper.RowRecord re : res) {
                 System.out.println(re);
+                iterateCount++;
             }
             pageIdx++;
             System.out.printf("page%s-------------------------%n", pageIdx);
@@ -302,7 +306,7 @@ public class IteratorExample {
                 .withMetricType(MetricType.L2);
 
         if (topK != null) {
-            searchIteratorParamBuilder.withTopK(topK);
+            searchIteratorParamBuilder.withLimit(topK.longValue());
         }
 
         R<SearchIterator> response = milvusClient.searchIterator(searchIteratorParamBuilder.build());

examples/src/main/java/io/milvus/v1/SimpleExample.java

@@ -144,8 +144,8 @@ public class SimpleExample {
         R<SearchResults> searchRet = milvusClient.search(SearchParam.newBuilder()
                 .withCollectionName(COLLECTION_NAME)
                 .withMetricType(MetricType.L2)
-                .withTopK(5)
-                .withFloatVectors(Arrays.asList(vector))
+                .withLimit(5L)
+                .withFloatVectors(Collections.singletonList(vector))
                 .withVectorFieldName(VECTOR_FIELD)
                 .withParams("{}")
                 .addOutField(VECTOR_FIELD)

examples/src/main/java/io/milvus/v1/SparseVectorExample.java

@@ -153,7 +153,7 @@ public class SparseVectorExample {
             R<SearchResults> searchRet = milvusClient.search(SearchParam.newBuilder()
                     .withCollectionName(COLLECTION_NAME)
                     .withMetricType(MetricType.IP)
-                    .withTopK(3)
+                    .withLimit(3L)
                     .withSparseFloatVectors(Collections.singletonList(targetVector))
                     .withVectorFieldName(VECTOR_FIELD)
                     .addOutField(VECTOR_FIELD)

examples/src/main/java/io/milvus/v2/BinaryVectorExample.java

@@ -136,7 +136,7 @@ public class BinaryVectorExample {
                     .annsField(VECTOR_FIELD)
                     .outputFields(Collections.singletonList(VECTOR_FIELD))
                     .searchParams(params)
-                    .topK(3)
+                    .limit(3)
                     .build());
 
             // The search() allows multiple target vectors to search in a batch.

examples/src/main/java/io/milvus/v2/ClientPoolExample.java

@@ -132,7 +132,7 @@ public class ClientPoolExample {
                             .collectionName(CollectionName)
                             .consistencyLevel(ConsistencyLevel.EVENTUALLY)
                             .annsField(VectorFieldName)
-                            .topK(10)
+                            .limit(10)
                             .data(Collections.singletonList(new FloatVec(CommonUtils.generateFloatVector(DIM))))
                             .build());
                     System.out.println("A search request completed");

examples/src/main/java/io/milvus/v2/ConsistencyLevelExample.java

@@ -100,7 +100,7 @@ public class ConsistencyLevelExample {
         SearchResp searchR = client.search(SearchReq.builder()
                 .collectionName(collectionName)
                 .data(Collections.singletonList(new FloatVec(CommonUtils.generateFloatVector(VECTOR_DIM))))
-                .topK(topK)
+                .limit(topK)
                 .build());
         List<List<SearchResp.SearchResult>> searchResults = searchR.getSearchResults();
         return searchResults.get(0);
@@ -162,7 +162,7 @@ public class ConsistencyLevelExample {
             SearchResp searchR = client2.search(SearchReq.builder()
                     .collectionName(collectionName)
                     .data(Collections.singletonList(new FloatVec(vector)))
-                    .topK(1)
+                    .limit(1)
                     .build());
             pool.returnClient(clientName2, client2); // don't forget to return the client to pool
             List<List<SearchResp.SearchResult>> searchResults = searchR.getSearchResults();

examples/src/main/java/io/milvus/v2/Float16VectorExample.java

@@ -139,7 +139,7 @@ public class Float16VectorExample {
                 .collectionName(COLLECTION_NAME)
                 .data(targetVectors)
                 .annsField(vectorFieldName)
-                .topK(topK)
+                .limit(topK)
                 .outputFields(Collections.singletonList(vectorFieldName))
                 .consistencyLevel(ConsistencyLevel.BOUNDED)
                 .build());

examples/src/main/java/io/milvus/v2/FullTextSearchExample.java

@@ -31,7 +31,7 @@ public class FullTextSearchExample {
         SearchResp searchResp = client.search(SearchReq.builder()
                 .collectionName(COLLECTION_NAME)
                 .data(Collections.singletonList(new EmbeddedText(text)))
-                .topK(3)
+                .limit(3)
                 .outputFields(Collections.singletonList("text"))
                 .build());
         System.out.println("\nSearch by text: " + text);

examples/src/main/java/io/milvus/v2/GeneralExample.java

@@ -187,7 +187,7 @@ public class GeneralExample {
         params.put("nprobe",10);
         SearchResp resp = client.search(SearchReq.builder()
                 .collectionName(COLLECTION_NAME)
-                .topK(SEARCH_K)
+                .limit(SEARCH_K)
                 .data(vectors)
                 .annsField(VECTOR_FIELD)
                 .filter(filter)

examples/src/main/java/io/milvus/v2/HybridSearchExample.java

@@ -197,24 +197,24 @@ public class HybridSearchExample {
                 .vectorFieldName("float_vector")
                 .vectors(floatVectors)
                 .params("{\"nprobe\": 10}")
-                .topK(10)
+                .limit(10)
                 .build());
         searchRequests.add(AnnSearchReq.builder()
                 .vectorFieldName("binary_vector")
                 .vectors(binaryVectors)
-                .topK(50)
+                .limit(50)
                 .build());
         searchRequests.add(AnnSearchReq.builder()
                 .vectorFieldName("sparse_vector")
                 .vectors(sparseVectors)
-                .topK(100)
+                .limit(100)
                 .build());
 
         HybridSearchReq hybridSearchReq = HybridSearchReq.builder()
                 .collectionName(COLLECTION_NAME)
                 .searchRequests(searchRequests)
                 .ranker(new WeightedRanker(Arrays.asList(0.2f, 0.5f, 0.6f)))
-                .topK(5)
+                .limit(5)
                 .consistencyLevel(ConsistencyLevel.BOUNDED)
                 .build();
         SearchResp searchResp = client.hybridSearch(hybridSearchReq);

examples/src/main/java/io/milvus/v2/Int8VectorExample.java

@@ -127,7 +127,7 @@ public class Int8VectorExample {
                     .data(Collections.singletonList(new Int8Vec(targetVector)))
                     .annsField(VECTOR_FIELD)
                     .outputFields(Collections.singletonList(VECTOR_FIELD))
-                    .topK(3)
+                    .limit(3)
                     .build());
 
             // The search() allows multiple target vectors to search in a batch.

examples/src/main/java/io/milvus/v2/IteratorExample.java

@@ -171,7 +171,7 @@ public class IteratorExample {
                 .vectors(Collections.singletonList(new FloatVec(CommonUtils.generateFloatVector(VECTOR_DIM))))
                 .expr(expr)
                 .params(StringUtils.isEmpty(params) ? "{}" : params)
-                .topK(topK)
+                .limit(topK)
                 .metricType(IndexParam.MetricType.L2)
                 .consistencyLevel(ConsistencyLevel.BOUNDED)
                 .build());
@@ -210,7 +210,7 @@ public class IteratorExample {
                 .vectors(Collections.singletonList(new FloatVec(CommonUtils.generateFloatVector(VECTOR_DIM))))
                 .filter(filter)
                 .searchParams(params==null ? new HashMap<>() : params)
-                .topK(topK)
+                .limit(topK)
                 .metricType(IndexParam.MetricType.L2)
                 .consistencyLevel(ConsistencyLevel.BOUNDED)
                 .externalFilterFunc(externalFilterFunc)

examples/src/main/java/io/milvus/v2/SimpleExample.java

@@ -93,7 +93,7 @@ public class SimpleExample {
                 .collectionName(collectionName)
                 .data(Collections.singletonList(new FloatVec(new float[]{1.0f, 1.0f, 1.0f, 1.0f})))
                 .filter("id < 100")
-                .topK(10)
+                .limit(10)
                 .outputFields(Collections.singletonList("*"))
                 .build());
         List<List<SearchResp.SearchResult>> searchResults = searchR.getSearchResults();
@@ -119,7 +119,7 @@ public class SimpleExample {
             SearchReq request = SearchReq.builder()
                     .collectionName(collectionName)
                     .data(Collections.singletonList(new FloatVec(new float[]{1.0f, 1.0f, 1.0f, 1.0f})))
-                    .topK(10)
+                    .limit(10)
                     .filter(key)
                     .filterTemplateValues(value)
                     .outputFields(Collections.singletonList("*"))

examples/src/main/java/io/milvus/v2/SparseVectorExample.java

@@ -128,7 +128,7 @@ public class SparseVectorExample {
                     .annsField(VECTOR_FIELD)
                     .outputFields(Collections.singletonList(VECTOR_FIELD))
                     .searchParams(params)
-                    .topK(3)
+                    .limit(3)
                     .build());
 
             // The search() allows multiple target vectors to search in a batch.

examples/src/main/java/io/milvus/v2/TextMatchExample.java

@@ -47,7 +47,7 @@ public class TextMatchExample {
                 .collectionName(COLLECTION_NAME)
                 .data(Collections.singletonList(new FloatVec(CommonUtils.generateFloatVector(VECTOR_DIM))))
                 .filter(filter)
-                .topK(10)
+                .limit(10)
                 .outputFields(Collections.singletonList("text"))
                 .build());
         System.out.println("\nSearch by filter: " + filter);

sdk-core/src/main/java/io/milvus/orm/iterator/IteratorAdapterV2.java

@@ -70,7 +70,7 @@ public class IteratorAdapterV2 {
                 .withPartitionNames(searchIteratorReq.getPartitionNames())
                 .withVectorFieldName(searchIteratorReq.getVectorFieldName())
                 .withMetricType(metricType)
-                .withTopK(searchIteratorReq.getTopK())
+                .withLimit(searchIteratorReq.getLimit())
                 .withExpr(searchIteratorReq.getExpr())
                 .withOutFields(searchIteratorReq.getOutputFields())
                 .withRoundDecimal(searchIteratorReq.getRoundDecimal())

sdk-core/src/main/java/io/milvus/orm/iterator/SearchIterator.java

@@ -64,7 +64,7 @@ public class SearchIterator {
 
     private final SearchIteratorParam searchIteratorParam;
     private final int batchSize;
-    private final int topK;
+    private final long topK;
     private final String expr;
     private final String metricType;
 
@@ -127,9 +127,9 @@ public class SearchIterator {
         if (!initSuccess || checkReachedLimit()) {
             return Lists.newArrayList();
         }
-        int retLen = batchSize;
+        long retLen = batchSize;
         if (topK != UNLIMITED) {
-            int leftLen = topK - returnedCount;
+            long leftLen = topK - returnedCount;
             retLen = Math.min(leftLen, retLen);
         }
 
@@ -387,12 +387,12 @@ public class SearchIterator {
         return true;
     }
 
-    private boolean isCacheEnough(int count) {
+    private boolean isCacheEnough(long count) {
         List<QueryResultsWrapper.RowRecord> cachedPage = iteratorCache.fetchCache(cacheId);
         return cachedPage != null && cachedPage.size() >= count;
     }
 
-    private List<QueryResultsWrapper.RowRecord> extractPageFromCache(int count) {
+    private List<QueryResultsWrapper.RowRecord> extractPageFromCache(long count) {
         List<QueryResultsWrapper.RowRecord> cachedPage = iteratorCache.fetchCache(cacheId);
         if (cachedPage == null || cachedPage.size() < count) {
             String msg = String.format("Wrong, try to extract %s result from cache, more than %s there must be sth wrong with code",
@@ -400,8 +400,8 @@ public class SearchIterator {
             throw new ParamException(msg);
         }
 
-        List<QueryResultsWrapper.RowRecord> retPageRes = cachedPage.subList(0, count);
-        List<QueryResultsWrapper.RowRecord> leftCachePage = cachedPage.subList(count, cachedPage.size());
+        List<QueryResultsWrapper.RowRecord> retPageRes = cachedPage.subList(0, (int)count);
+        List<QueryResultsWrapper.RowRecord> leftCachePage = cachedPage.subList((int)count, cachedPage.size());
 
         iteratorCache.cache(cacheId, leftCachePage);
         return retPageRes;

sdk-core/src/main/java/io/milvus/param/Constant.java

@@ -97,6 +97,7 @@ public class Constant {
     public static final int MAX_BATCH_SIZE = 16384;
     public static final int NO_CACHE_ID = -1;
     public static final int UNLIMITED = -1;
+    public static final long UNLIMITED_L = -1;
     public static final int DEFAULT_SEARCH_EXTENSION_RATE = 10;
     public static final int MAX_FILTERED_IDS_COUNT_ITERATION = 100000;
     public static final int MAX_TRY_TIME = 20;

sdk-core/src/main/java/io/milvus/param/ParamUtils.java

@@ -1049,9 +1049,9 @@ public class ParamUtils {
         // set ranker
         BaseRanker ranker = requestParam.getRanker();
         Map<String, String> props = ranker.getProperties();
-        props.put(Constant.LIMIT, String.format("%d", requestParam.getTopK()));
-        props.put(Constant.ROUND_DECIMAL, String.format("%d", requestParam.getRoundDecimal()));
-        props.put(Constant.OFFSET, String.format("%d", requestParam.getOffset()));
+        props.put(Constant.LIMIT, String.valueOf(requestParam.getTopK()));
+        props.put(Constant.ROUND_DECIMAL, String.valueOf(requestParam.getRoundDecimal()));
+        props.put(Constant.OFFSET, String.valueOf(requestParam.getOffset()));
         List<KeyValuePair> propertiesList = ParamUtils.AssembleKvPair(props);
         if (CollectionUtils.isNotEmpty(propertiesList)) {
             propertiesList.forEach(builder::addRankParams);

sdk-core/src/main/java/io/milvus/param/dml/AnnSearchParam.java

@@ -40,7 +40,7 @@ public class AnnSearchParam {
 
     private final String metricType;
     private final String vectorFieldName;
-    private final int topK;
+    private final Long topK;
     private final String expr;
     private final List<?> vectors;
     private final Long NQ;
@@ -68,7 +68,7 @@ public class AnnSearchParam {
     public static class Builder {
         private MetricType metricType = MetricType.None;
         private String vectorFieldName;
-        private Integer topK;
+        private Long topK;
         private String expr = "";
         private List<?> vectors;
         private Long NQ;
@@ -110,8 +110,14 @@ public class AnnSearchParam {
          * @param topK topK value
          * @return <code>Builder</code>
          */
+        @Deprecated
         public Builder withTopK(@NonNull Integer topK) {
-            this.topK = topK;
+            this.topK = topK.longValue();
+            return this;
+        }
+
+        public Builder withLimit(@NonNull Long limit) {
+            this.topK = limit;
             return this;
         }
 

sdk-core/src/main/java/io/milvus/param/dml/HybridSearchParam.java

@@ -42,7 +42,7 @@ public class HybridSearchParam {
     private final List<String> partitionNames;
     private final List<AnnSearchParam> searchRequests;
     private final BaseRanker ranker;
-    private final int topK;
+    private final Long topK;
     private final List<String> outFields;
     private final long offset;
     private final int roundDecimal;
@@ -81,7 +81,7 @@ public class HybridSearchParam {
         private final List<String> partitionNames = Lists.newArrayList();
         private final List<AnnSearchParam> searchRequests = Lists.newArrayList();
         private BaseRanker ranker = null;
-        private Integer topK;
+        private Long topK;
         private final List<String> outFields = Lists.newArrayList();
         private Long offset = 0L;
         private Integer roundDecimal = -1;
@@ -174,12 +174,19 @@ public class HybridSearchParam {
 
         /**
          * Sets topK value of ANN search.
+         * withTopK() is deprecated, replaced by withLimit()
          *
          * @param topK topK value
          * @return <code>Builder</code>
          */
+        @Deprecated
         public Builder withTopK(@NonNull Integer topK) {
-            this.topK = topK;
+            this.topK = topK.longValue();
+            return this;
+        }
+
+        public Builder withLimit(@NonNull Long limit) {
+            this.topK = limit;
             return this;
         }
 

sdk-core/src/main/java/io/milvus/param/dml/SearchIteratorParam.java

@@ -35,8 +35,6 @@ import java.nio.ByteBuffer;
 import java.util.List;
 import java.util.SortedMap;
 
-import static io.milvus.param.Constant.UNLIMITED;
-
 /**
  * Parameters for <code>searchIterator</code> interface.
  */
@@ -48,7 +46,7 @@ public class SearchIteratorParam {
     private final List<String> partitionNames;
     private final String metricType;
     private final String vectorFieldName;
-    private final int topK;
+    private final Long topK;
     private final String expr;
     private final List<String> outFields;
     private final List<?> vectors;
@@ -102,7 +100,7 @@ public class SearchIteratorParam {
         private final List<String> partitionNames = Lists.newArrayList();
         private MetricType metricType = MetricType.None;
         private String vectorFieldName;
-        private Integer topK = UNLIMITED;
+        private Long topK = Constant.UNLIMITED_L;
         private String expr = "";
         private final List<String> outFields = Lists.newArrayList();
         private List<?> vectors;
@@ -207,12 +205,19 @@ public class SearchIteratorParam {
 
         /**
          * Sets topK value of ANN search.
+         * withTopK() is deprecated, replaced by withLimit()
          *
          * @param topK topK value
          * @return <code>Builder</code>
          */
+        @Deprecated
         public Builder withTopK(@NonNull Integer topK) {
-            this.topK = topK;
+            this.topK = topK.longValue();
+            return this;
+        }
+
+        public Builder withLimit(@NonNull Long limit) {
+            this.topK = limit;
             return this;
         }
 
@@ -406,7 +411,7 @@ public class SearchIteratorParam {
             ParamUtils.CheckNullEmptyString(collectionName, "Collection name");
             ParamUtils.CheckNullEmptyString(vectorFieldName, "Target field name");
 
-            if (topK != UNLIMITED && topK <= 0) {
+            if (topK != Constant.UNLIMITED_L && topK <= 0) {
                 throw new ParamException("TopK value is illegal");
             }
 

sdk-core/src/main/java/io/milvus/param/dml/SearchParam.java

@@ -43,7 +43,7 @@ public class SearchParam {
     private final List<String> partitionNames;
     private final String metricType;
     private final String vectorFieldName;
-    private final int topK;
+    private final Long topK;
     private final String expr;
     private final List<String> outFields;
     private final List<?> vectors;
@@ -97,7 +97,7 @@ public class SearchParam {
         private final List<String> partitionNames = Lists.newArrayList();
         private MetricType metricType = MetricType.None;
         private String vectorFieldName;
-        private Integer topK;
+        private Long topK;
         private String expr = "";
         private final List<String> outFields = Lists.newArrayList();
         private List<?> vectors;
@@ -202,12 +202,18 @@ public class SearchParam {
 
         /**
          * Sets topK value of ANN search.
+         * withTopK() is deprecated, replaced by withLimit()
          *
          * @param topK topK value
          * @return <code>Builder</code>
          */
+        @Deprecated
         public Builder withTopK(@NonNull Integer topK) {
-            this.topK = topK;
+            this.topK = topK.longValue();
+            return this;
+        }
+        public Builder withLimit(@NonNull Long limit) {
+            this.topK = limit;
             return this;
         }
 

sdk-core/src/main/java/io/milvus/v2/service/vector/request/AnnSearchReq.java

@@ -31,7 +31,11 @@ import java.util.List;
 @SuperBuilder
 public class AnnSearchReq {
     private String vectorFieldName;
-    private int topK;
+    @Builder.Default
+    @Deprecated
+    private int topK = 0;
+    @Builder.Default
+    private long limit = 0L;
     @Builder.Default
     private String expr = "";
     private List<BaseVector> vectors;
@@ -39,4 +43,23 @@ public class AnnSearchReq {
 
     @Builder.Default
     private IndexParam.MetricType metricType = null;
+
+    public static abstract class AnnSearchReqBuilder<C extends AnnSearchReq, B extends AnnSearchReq.AnnSearchReqBuilder<C, B>> {
+        // topK is deprecated, topK and limit must be the same value
+        public B topK(int val) {
+            this.topK$value = val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+
+        public B limit(long val) {
+            this.topK$value = (int)val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+    }
 }

sdk-core/src/main/java/io/milvus/v2/service/vector/request/HybridSearchReq.java

@@ -20,6 +20,7 @@
 package io.milvus.v2.service.vector.request;
 
 import io.milvus.v2.common.ConsistencyLevel;
+import io.milvus.v2.service.collection.request.LoadCollectionReq;
 import io.milvus.v2.service.vector.request.ranker.BaseRanker;
 import lombok.Builder;
 import lombok.Data;
@@ -36,7 +37,11 @@ public class HybridSearchReq
     private List<String> partitionNames;
     private List<AnnSearchReq> searchRequests;
     private BaseRanker ranker;
-    private int topK;
+    @Builder.Default
+    @Deprecated
+    private int topK = 0; // deprecated, replaced by "limit"
+    @Builder.Default
+    private long limit = 0L;
     private List<String> outFields;
     private long offset;
     @Builder.Default
@@ -48,4 +53,22 @@ public class HybridSearchReq
     private Integer groupSize;
     private Boolean strictGroupSize;
 
+    public static abstract class HybridSearchReqBuilder<C extends HybridSearchReq, B extends HybridSearchReq.HybridSearchReqBuilder<C, B>> {
+        // topK is deprecated, topK and limit must be the same value
+        public B topK(int val) {
+            this.topK$value = val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+
+        public B limit(long val) {
+            this.topK$value = (int)val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+    }
 }

sdk-core/src/main/java/io/milvus/v2/service/vector/request/SearchIteratorReq.java

@@ -1,6 +1,7 @@
 package io.milvus.v2.service.vector.request;
 
 import com.google.common.collect.Lists;
+import io.milvus.param.Constant;
 import io.milvus.v2.common.ConsistencyLevel;
 import io.milvus.v2.common.IndexParam;
 import io.milvus.v2.service.vector.request.data.BaseVector;
@@ -21,7 +22,10 @@ public class SearchIteratorReq {
     private IndexParam.MetricType metricType = IndexParam.MetricType.INVALID;
     private String vectorFieldName;
     @Builder.Default
-    private int topK = -1;
+    @Deprecated
+    private int topK = Constant.UNLIMITED;
+    @Builder.Default
+    private long limit = Constant.UNLIMITED_L;
     @Builder.Default
     private String expr = "";
     @Builder.Default
@@ -40,4 +44,22 @@ public class SearchIteratorReq {
     private String groupByFieldName = "";
     @Builder.Default
     private long batchSize = 1000L;
+
+    public static abstract class SearchIteratorReqBuilder<C extends SearchIteratorReq, B extends SearchIteratorReq.SearchIteratorReqBuilder<C, B>> {
+        // topK is deprecated, topK and limit must be the same value
+        public B topK(int val) {
+            this.topK$value = val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+        public B limit(long val) {
+            this.topK$value = (int)val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+    }
 }

sdk-core/src/main/java/io/milvus/v2/service/vector/request/SearchIteratorReqV2.java

@@ -1,6 +1,7 @@
 package io.milvus.v2.service.vector.request;
 
 import com.google.common.collect.Lists;
+import io.milvus.param.Constant;
 import io.milvus.v2.common.ConsistencyLevel;
 import io.milvus.v2.common.IndexParam;
 import io.milvus.v2.service.vector.request.data.BaseVector;
@@ -25,7 +26,10 @@ public class SearchIteratorReqV2 {
     private IndexParam.MetricType metricType = IndexParam.MetricType.INVALID;
     private String vectorFieldName;
     @Builder.Default
-    private int topK = -1;
+    @Deprecated
+    private int topK = Constant.UNLIMITED;
+    @Builder.Default
+    private long limit = Constant.UNLIMITED_L;
     @Builder.Default
     private String filter = "";
     @Builder.Default
@@ -46,4 +50,22 @@ public class SearchIteratorReqV2 {
     private long batchSize = 1000L;
     @Builder.Default
     private Function<List<SearchResp.SearchResult>, List<SearchResp.SearchResult>> externalFilterFunc = null;
+
+    public static abstract class SearchIteratorReqV2Builder<C extends SearchIteratorReqV2, B extends SearchIteratorReqV2.SearchIteratorReqV2Builder<C, B>> {
+        // topK is deprecated, topK and limit must be the same value
+        public B topK(int val) {
+            this.topK$value = val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+        public B limit(long val) {
+            this.topK$value = (int)val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+    }
 }

sdk-core/src/main/java/io/milvus/v2/service/vector/request/SearchReq.java

@@ -22,6 +22,7 @@ package io.milvus.v2.service.vector.request;
 import io.milvus.v2.common.ConsistencyLevel;
 import io.milvus.v2.common.IndexParam;
 import io.milvus.v2.service.vector.request.data.BaseVector;
+
 import lombok.Builder;
 import lombok.Data;
 import lombok.experimental.SuperBuilder;
@@ -41,13 +42,16 @@ public class SearchReq {
     @Builder.Default
     private String annsField = "";
     private IndexParam.MetricType metricType;
-    private int topK;
+    @Builder.Default
+    @Deprecated
+    private int topK = 0;
     private String filter;
     @Builder.Default
     private List<String> outputFields = new ArrayList<>();
     private List<BaseVector> data;
     private long offset;
-    private long limit;
+    @Builder.Default
+    private long limit = 0L;
 
     @Builder.Default
     private int roundDecimal = -1;
@@ -73,4 +77,22 @@ public class SearchReq {
     //     Boolean, Long, Double, String, List<Boolean>, List<Long>, List<Double>, List<String>
     @Builder.Default
     private Map<String, Object> filterTemplateValues = new HashMap<>();
+
+    public static abstract class SearchReqBuilder<C extends SearchReq, B extends SearchReq.SearchReqBuilder<C, B>> {
+        // topK is deprecated, topK and limit must be the same value
+        public B topK(int val) {
+            this.topK$value = val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+        public B limit(long val) {
+            this.topK$value = (int)val;
+            this.topK$set = true;
+            this.limit$value = val;
+            this.limit$set = true;
+            return self();
+        }
+    }
 }

sdk-core/src/main/java/io/milvus/v2/utils/VectorUtils.java

@@ -184,10 +184,11 @@ public class VectorUtils {
                             .build());
         }
 
+        // topK value is deprecated, always use "limit" to set the topK
         builder.addSearchParams(
                         KeyValuePair.newBuilder()
                                 .setKey(Constant.TOP_K)
-                                .setValue(String.valueOf(request.getTopK()))
+                                .setValue(String.valueOf(request.getLimit()))
                                 .build())
                 .addSearchParams(
                         KeyValuePair.newBuilder()
@@ -415,7 +416,7 @@ public class VectorUtils {
                 .addSearchParams(
                         KeyValuePair.newBuilder()
                                 .setKey(Constant.TOP_K)
-                                .setValue(String.valueOf(annSearchReq.getTopK()))
+                                .setValue(String.valueOf(annSearchReq.getLimit()))
                                 .build());
         if (annSearchReq.getMetricType() != null) {
             builder.addSearchParams(
@@ -466,10 +467,11 @@ public class VectorUtils {
             throw new MilvusClientException(ErrorCode.INVALID_PARAMS, "Ranker is null.");
         }
 
+        // topK value is deprecated, always use "limit" to set the topK
         Map<String, String> props = ranker.getProperties();
-        props.put(Constant.LIMIT, String.format("%d", request.getTopK()));
-        props.put(Constant.ROUND_DECIMAL, String.format("%d", request.getRoundDecimal()));
-        props.put(Constant.OFFSET, String.format("%d", request.getOffset()));
+        props.put(Constant.LIMIT, String.valueOf(request.getLimit()));
+        props.put(Constant.ROUND_DECIMAL, String.valueOf(request.getRoundDecimal()));
+        props.put(Constant.OFFSET, String.valueOf(request.getOffset()));
         List<KeyValuePair> propertiesList = ParamUtils.AssembleKvPair(props);
         if (CollectionUtils.isNotEmpty(propertiesList)) {
             propertiesList.forEach(builder::addRankParams);

sdk-core/src/test/java/io/milvus/client/MilvusClientDockerTest.java

@@ -651,7 +651,7 @@ class MilvusClientDockerTest {
         SearchParam searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.L2)
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withFloatVectors(targetVectors)
                 .withVectorFieldName(DataType.FloatVector.name())
                 .withParams("{\"ef\":64}")
@@ -854,7 +854,7 @@ class MilvusClientDockerTest {
         SearchParam searchOneParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.JACCARD)
-                .withTopK(5)
+                .withLimit(5L)
                 .withBinaryVectors(Collections.singletonList(targetVector))
                 .withVectorFieldName(DataType.BinaryVector.name())
                 .addOutField(DataType.BinaryVector.name())
@@ -921,7 +921,7 @@ class MilvusClientDockerTest {
         SearchParam searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.HAMMING)
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withBinaryVectors(targetVectors)
                 .withVectorFieldName(DataType.BinaryVector.name())
                 .withParams("{\"nprobe\":8}")
@@ -1038,7 +1038,7 @@ class MilvusClientDockerTest {
         SearchParam searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.IP)
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withSparseFloatVectors(targetVectors)
                 .withVectorFieldName(DataType.SparseFloatVector.name())
                 .addOutField(DataType.SparseFloatVector.name())
@@ -1241,7 +1241,7 @@ class MilvusClientDockerTest {
         R<SearchResults> searchR = client.search(SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.COSINE)
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withFloat16Vectors(Collections.singletonList(fp16Vector))
                 .withVectorFieldName(DataType.Float16Vector.name())
                 .addOutField(DataType.Float16Vector.name())
@@ -1269,7 +1269,7 @@ class MilvusClientDockerTest {
         searchR = client.search(SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.COSINE)
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withParams("{\"nprobe\": 16}")
                 .withBFloat16Vectors(Collections.singletonList(bf16Vector))
                 .withVectorFieldName(DataType.BFloat16Vector.name())
@@ -1377,7 +1377,7 @@ class MilvusClientDockerTest {
                 .withFloatVectors(utils.generateFloatVectors(1))
                 .withMetricType(MetricType.COSINE)
                 .withParams("{\"nprobe\": 32}")
-                .withTopK(10)
+                .withLimit(10L)
                 .build();
 
         AnnSearchParam param2 = AnnSearchParam.newBuilder()
@@ -1385,7 +1385,7 @@ class MilvusClientDockerTest {
                 .withBinaryVectors(utils.generateBinaryVectors(1))
                 .withMetricType(MetricType.HAMMING)
                 .withParams("{}")
-                .withTopK(5)
+                .withLimit(5L)
                 .build();
 
         AnnSearchParam param3 = AnnSearchParam.newBuilder()
@@ -1393,7 +1393,7 @@ class MilvusClientDockerTest {
                 .withSparseFloatVectors(utils.generateSparseVectors(1))
                 .withMetricType(MetricType.IP)
                 .withParams("{\"drop_ratio_search\":0.2}")
-                .withTopK(7)
+                .withLimit(7L)
                 .build();
 
         HybridSearchParam searchParam = HybridSearchParam.newBuilder()
@@ -1402,7 +1402,7 @@ class MilvusClientDockerTest {
                 .addSearchRequest(param1)
                 .addSearchRequest(param2)
                 .addSearchRequest(param3)
-                .withTopK(3)
+                .withLimit(3L)
                 .withConsistencyLevel(ConsistencyLevelEnum.STRONG)
                 .withRanker(WeightedRanker.newBuilder()
                         .withWeights(Lists.newArrayList(0.5f, 0.5f, 1.0f))
@@ -1528,7 +1528,7 @@ class MilvusClientDockerTest {
         SearchParam searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.IP)
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withVectors(targetVectors)
                 .withVectorFieldName(DataType.FloatVector.name())
                 .build();
@@ -1775,7 +1775,7 @@ class MilvusClientDockerTest {
         SearchParam searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.IP)
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withFloatVectors(targetVectors)
                 .withVectorFieldName(DataType.FloatVector.name())
                 .addOutField(DataType.Int64.name())
@@ -2012,7 +2012,7 @@ class MilvusClientDockerTest {
         SearchParam searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.COSINE)
-                .withTopK(topK)
+                .withLimit((long)topK)
                 .withFloatVectors(targetVectors)
                 .withVectorFieldName(DataType.FloatVector.name())
                 .withParams("{}")
@@ -2187,7 +2187,7 @@ class MilvusClientDockerTest {
         SearchParam searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.L2)
-                .withTopK(5)
+                .withLimit(5L)
                 .withFloatVectors(searchVectors)
                 .withVectorFieldName(DataType.FloatVector.name())
                 .addOutField(varcharArrayName)
@@ -2218,7 +2218,7 @@ class MilvusClientDockerTest {
         searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.L2)
-                .withTopK(10)
+                .withLimit(10L)
                 .withExpr(String.format("array_contains_any(%s, [450038, 680015])", intArrayName))
                 .withFloatVectors(searchVectors)
                 .withVectorFieldName(DataType.FloatVector.name())
@@ -2789,7 +2789,7 @@ class MilvusClientDockerTest {
                 .withBatchSize(10L)
                 .withVectorFieldName(DataType.FloatVector.name())
                 .withFloatVectors(vectors)
-                .withTopK(50)
+                .withLimit(50L)
                 .withMetricType(MetricType.L2);
 
         R<SearchIterator> sResponse = client.searchIterator(searchIteratorParamBuilder.build());
@@ -3099,7 +3099,7 @@ class MilvusClientDockerTest {
         SearchParam searchParam = SearchParam.newBuilder()
                 .withCollectionName(randomCollectionName)
                 .withMetricType(MetricType.L2)
-                .withTopK(10)
+                .withLimit(10L)
                 .withFloatVectors(searchVectors)
                 .withVectorFieldName("vector")
                 .withParams("{}")

sdk-core/src/test/java/io/milvus/v2/client/MilvusClientV2DockerTest.java

@@ -455,7 +455,7 @@ class MilvusClientV2DockerTest {
                 .partitionNames(Collections.singletonList(partitionName))
                 .annsField(vectorFieldName)
                 .data(Collections.singletonList(new FloatVec(utils.generateFloatVector())))
-                .topK(10)
+                .limit(10)
                 .build());
         List<List<SearchResp.SearchResult>> searchResults = searchResp.getSearchResults();
         Assertions.assertEquals(1, searchResults.size());
@@ -501,7 +501,7 @@ class MilvusClientV2DockerTest {
                 .collectionName(randomCollectionName)
                 .annsField(vectorFieldName)
                 .data(targetVectors)
-                .topK(10)
+                .limit(topk)
                 .outputFields(Collections.singletonList("*"))
                 .build());
         searchResults = searchResp.getSearchResults();
@@ -586,7 +586,7 @@ class MilvusClientV2DockerTest {
                 .collectionName(randomCollectionName)
                 .annsField(vectorFieldName)
                 .data(targetVectors)
-                .topK(10)
+                .limit(topk)
                 .outputFields(Collections.singletonList(vectorFieldName))
                 .build());
         List<List<SearchResp.SearchResult>> searchResults = searchResp.getSearchResults();
@@ -688,7 +688,7 @@ class MilvusClientV2DockerTest {
                     .collectionName(randomCollectionName)
                     .annsField(float16Field)
                     .data(Collections.singletonList(new Float16Vec(originVector)))
-                    .topK(topk)
+                    .limit(topk)
                     .consistencyLevel(ConsistencyLevel.STRONG)
                     .outputFields(Collections.singletonList(float16Field))
                     .build());
@@ -714,7 +714,7 @@ class MilvusClientV2DockerTest {
                     .collectionName(randomCollectionName)
                     .annsField(bfloat16Field)
                     .data(Collections.singletonList(new BFloat16Vec(originVector)))
-                    .topK(topk)
+                    .limit(topk)
                     .consistencyLevel(ConsistencyLevel.STRONG)
                     .outputFields(Collections.singletonList(bfloat16Field))
                     .build());
@@ -797,7 +797,7 @@ class MilvusClientV2DockerTest {
                 .collectionName(randomCollectionName)
                 .annsField(vectorFieldName)
                 .data(targetVectors)
-                .topK(topk)
+                .limit(topk)
                 .build());
         List<List<SearchResp.SearchResult>> searchResults = searchResp.getSearchResults();
         Assertions.assertEquals(nq, searchResults.size());
@@ -911,7 +911,7 @@ class MilvusClientV2DockerTest {
                 .collectionName(randomCollectionName)
                 .annsField(vectorFieldName)
                 .data(targetVectors)
-                .topK(topK)
+                .limit(topK)
                 .outputFields(Collections.singletonList("*"))
                 .consistencyLevel(ConsistencyLevel.STRONG)
                 .build());
@@ -1029,24 +1029,24 @@ class MilvusClientV2DockerTest {
                 .vectorFieldName("float_vector")
                 .vectors(floatVectors)
                 .params("{\"nprobe\": 10}")
-                .topK(10)
+                .limit(10)
                 .build());
         searchRequests.add(AnnSearchReq.builder()
                 .vectorFieldName("binary_vector")
                 .vectors(binaryVectors)
-                .topK(50)
+                .limit(50)
                 .build());
         searchRequests.add(AnnSearchReq.builder()
                 .vectorFieldName("sparse_vector")
                 .vectors(sparseVectors)
-                .topK(100)
+                .limit(100)
                 .build());
 
         HybridSearchReq hybridSearchReq = HybridSearchReq.builder()
                 .collectionName(randomCollectionName)
                 .searchRequests(searchRequests)
                 .ranker(new RRFRanker(20))
-                .topK(topk)
+                .limit(topk)
                 .consistencyLevel(ConsistencyLevel.BOUNDED)
                 .build();
         SearchResp searchResp = client.hybridSearch(hybridSearchReq);
@@ -1606,7 +1606,7 @@ class MilvusClientV2DockerTest {
                 .vectors(Collections.singletonList(new FloatVec(utils.generateFloatVector())))
                 .expr("int64_field > 500 && int64_field < 1000")
                 .params("{\"range_filter\": 5.0, \"radius\": 50.0}")
-                .topK(1000)
+                .limit(1000)
                 .metricType(IndexParam.MetricType.L2)
                 .consistencyLevel(ConsistencyLevel.EVENTUALLY)
                 .build());
@@ -2211,7 +2211,7 @@ class MilvusClientV2DockerTest {
                 .collectionName(randomCollectionName)
                 .annsField("vector")
                 .data(Collections.singletonList(new FloatVec(utils.generateFloatVector(dim))))
-                .topK(10)
+                .limit(10)
                 .outputFields(Lists.newArrayList("*"))
                 .consistencyLevel(ConsistencyLevel.BOUNDED)
                 .build());
@@ -2341,7 +2341,7 @@ class MilvusClientV2DockerTest {
                 .collectionName(randomCollectionName)
                 .annsField("sparse")
                 .data(Collections.singletonList(new EmbeddedText("milvus AI")))
-                .topK(10)
+                .limit(10)
                 .outputFields(Lists.newArrayList("*"))
                 .metricType(IndexParam.MetricType.BM25)
                 .build());

sdk-core/src/test/java/io/milvus/v2/service/vector/VectorTest.java

@@ -96,7 +96,7 @@ class VectorTest extends BaseTest {
         SearchReq request = SearchReq.builder()
                 .collectionName("test2")
                 .data(Collections.singletonList(new FloatVec(vectorList)))
-                .topK(10)
+                .limit(10)
                 .offset(0L)
                 .build();
         SearchResp statusR = client_v2.search(request);
@@ -123,7 +123,7 @@ class VectorTest extends BaseTest {
             SearchReq request = SearchReq.builder()
                     .collectionName("test")
                     .data(Collections.singletonList(new FloatVec(vectorList)))
-                    .topK(10)
+                    .limit(10)
                     .offset(0L)
                     .filter(key)
                     .filterTemplateValues(value)