io.milvus.param.dml

类 SearchParam.Builder

java.lang.Object

io.milvus.param.dml.SearchParam.Builder

封闭类:

SearchParam

public static class SearchParam.Builder
extends Object

Builder for SearchParam class.

方法概要

限定符和类型	方法和说明
SearchParam.Builder	addOutField(@NonNull String fieldName) Specifies an output field (Optional).
SearchParam.Builder	addPartitionName(@NonNull String partitionName) Adds a partition to specify search scope (Optional).
SearchParam	build() Verifies parameters and creates a new SearchParam instance.
SearchParam.Builder	withCollectionName(@NonNull String collectionName) Sets the collection name.
SearchParam.Builder	withConsistencyLevel(ConsistencyLevelEnum consistencyLevel) ConsistencyLevel of consistency level.
SearchParam.Builder	withExpr(@NonNull String expr) Sets expression to filter out entities before searching (Optional).
SearchParam.Builder	withGracefulTime(Long gracefulTime) Graceful time for BOUNDED Consistency Level
SearchParam.Builder	withGuaranteeTimestamp(@NonNull Long ts) Instructs server to see insert/delete operations performed before a provided timestamp.
SearchParam.Builder	withMetricType(@NonNull MetricType metricType) Sets metric type of ANN searching.
SearchParam.Builder	withOutFields(@NonNull List<String> outFields) Specifies output fields (Optional).
SearchParam.Builder	withParams(@NonNull String params) Sets the search parameters specific to the index type.
SearchParam.Builder	withPartitionNames(@NonNull List<String> partitionNames) Sets partition names list to specify search scope (Optional).
SearchParam.Builder	withRoundDecimal(@NonNull Integer decimal) Specifies the decimal place of the returned results.
SearchParam.Builder	withTopK(@NonNull Integer topK) Sets topK value of ANN search.
SearchParam.Builder	withTravelTimestamp(@NonNull Long ts) Specify an absolute timestamp in a search to get results based on a data view at a specified point in time.
SearchParam.Builder	withVectorFieldName(@NonNull String vectorFieldName) Sets target vector field by name.
SearchParam.Builder	withVectors(@NonNull List<?> vectors) Sets the target vectors.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

withCollectionName

public SearchParam.Builder withCollectionName(@NonNull
                                              @NonNull String collectionName)

Sets the collection name. Collection name cannot be empty or null.

参数:

collectionName - collection name

返回:

Builder

withPartitionNames

public SearchParam.Builder withPartitionNames(@NonNull
                                              @NonNull List<String> partitionNames)

Sets partition names list to specify search scope (Optional).

参数:

partitionNames - partition names list

返回:

Builder

withConsistencyLevel

public SearchParam.Builder withConsistencyLevel(ConsistencyLevelEnum consistencyLevel)

ConsistencyLevel of consistency level.

参数:

consistencyLevel - consistency level

返回:

Builder

withGracefulTime

public SearchParam.Builder withGracefulTime(Long gracefulTime)

Graceful time for BOUNDED Consistency Level

参数:

gracefulTime - graceful time

返回:

Builder

addPartitionName

public SearchParam.Builder addPartitionName(@NonNull
                                            @NonNull String partitionName)

Adds a partition to specify search scope (Optional).

参数:

partitionName - partition name

返回:

Builder

withMetricType

public SearchParam.Builder withMetricType(@NonNull
                                          @NonNull MetricType metricType)

Sets metric type of ANN searching.

参数:

metricType - metric type

返回:

Builder

withVectorFieldName

public SearchParam.Builder withVectorFieldName(@NonNull
                                               @NonNull String vectorFieldName)

Sets target vector field by name. Field name cannot be empty or null.

参数:

vectorFieldName - vector field name

返回:

Builder

withTopK

public SearchParam.Builder withTopK(@NonNull
                                    @NonNull Integer topK)

Sets topK value of ANN search.

参数:

topK - topK value

返回:

Builder

withExpr

public SearchParam.Builder withExpr(@NonNull
                                    @NonNull String expr)

Sets expression to filter out entities before searching (Optional).

参数:

expr - filtering expression

返回:

Builder

另请参阅:

Boolean Expression Rules

withOutFields

public SearchParam.Builder withOutFields(@NonNull
                                         @NonNull List<String> outFields)

Specifies output fields (Optional).

参数:

outFields - output fields

返回:

Builder

addOutField

public SearchParam.Builder addOutField(@NonNull
                                       @NonNull String fieldName)

Specifies an output field (Optional).

参数:

fieldName - filed name

返回:

Builder

withVectors

public SearchParam.Builder withVectors(@NonNull
                                       @NonNull List<?> vectors)

Sets the target vectors.

参数:

vectors - list of target vectors: if vector type is FloatVector, vectors is List of List Float; if vector type is BinaryVector, vectors is List of ByteBuffer;

返回:

Builder

withRoundDecimal

public SearchParam.Builder withRoundDecimal(@NonNull
                                            @NonNull Integer decimal)

Specifies the decimal place of the returned results.

参数:

decimal - how many digits after the decimal point

返回:

Builder

withParams

public SearchParam.Builder withParams(@NonNull
                                      @NonNull String params)

Sets the search parameters specific to the index type. For example: IVF index, the search parameters can be "{\"nprobe\":10}" For more information: @see Index Selection

参数:

params - extra parameters in json format

返回:

Builder

withTravelTimestamp

public SearchParam.Builder withTravelTimestamp(@NonNull
                                               @NonNull Long ts)

Specify an absolute timestamp in a search to get results based on a data view at a specified point in time. Default value is 0, server executes search on a full data view.

参数:

ts - a timestamp value

返回:

Builder

withGuaranteeTimestamp

public SearchParam.Builder withGuaranteeTimestamp(@NonNull
                                                  @NonNull Long ts)

Instructs server to see insert/delete operations performed before a provided timestamp. If no such timestamp is specified, the server will wait for the latest operation to finish and search. Note: The timestamp is not an absolute timestamp, it is a hybrid value combined by UTC time and internal flags. We call it TSO, for more information please refer to: https://github.com/milvus-io/milvus/blob/master/docs/design_docs/milvus_hybrid_ts_en.md You can get a TSO from insert/delete operations, see the MutationResultWrapper class. Use an operation's TSO to set this parameter, the server will execute search after this operation is finished. Default value is GUARANTEE_EVENTUALLY_TS, server executes search immediately.

参数:

ts - a timestamp value

返回:

Builder

build

public SearchParam build()
                  throws ParamException

Verifies parameters and creates a new SearchParam instance.

返回:

SearchParam

抛出:

ParamException