Package io.milvus.param.dml

Class SearchIteratorParam.Builder

java.lang.Object

io.milvus.param.dml.SearchIteratorParam.Builder

Enclosing class:

SearchIteratorParam

public static class SearchIteratorParam.Builder
extends Object

Builder for SearchIteratorParam class.

Method Summary

Modifier and Type	Method	Description
SearchIteratorParam.Builder	addOutField(@NonNull String fieldName)	Specifies an output field (Optional).
SearchIteratorParam.Builder	addPartitionName(@NonNull String partitionName)	Adds a partition to specify search scope (Optional).
SearchIteratorParam	build()	Verifies parameters and creates a new SearchIteratorParam instance.
SearchIteratorParam.Builder	withBatchSize(Long batchSize)	Specify a value to control the number of entities returned per batch.
SearchIteratorParam.Builder	withBFloat16Vectors(@NonNull List<ByteBuffer> vectors)	Sets the target vectors to search on BFloat16Vector field.
SearchIteratorParam.Builder	withBinaryVectors(@NonNull List<ByteBuffer> vectors)	Sets the target vectors to search on BinaryVector field.
SearchIteratorParam.Builder	withCollectionName(@NonNull String collectionName)	Sets the collection name.
SearchIteratorParam.Builder	withConsistencyLevel(ConsistencyLevelEnum consistencyLevel)	ConsistencyLevel of consistency level.
SearchIteratorParam.Builder	withDatabaseName(String databaseName)	Sets the database name.
SearchIteratorParam.Builder	withExpr(@NonNull String expr)	Sets expression to filter out entities before searching (Optional).
SearchIteratorParam.Builder	withFloat16Vectors(@NonNull List<ByteBuffer> vectors)	Sets the target vectors to search on Float16Vector field.
SearchIteratorParam.Builder	withFloatVectors(@NonNull List<List<Float>> vectors)	Sets the target vectors to search on FloatVector field.
SearchIteratorParam.Builder	withGroupByFieldName(@NonNull String groupByFieldName)	Sets field name to do grouping.
SearchIteratorParam.Builder	withIgnoreGrowing(@NonNull Boolean ignoreGrowing)	Ignore the growing segments to get best search performance.
SearchIteratorParam.Builder	withMetricType(@NonNull MetricType metricType)	Sets metric type of ANN searching.
SearchIteratorParam.Builder	withOutFields(@NonNull List<String> outFields)	Specifies output fields (Optional).
SearchIteratorParam.Builder	withParams(@NonNull String params)	Sets the search parameters specific to the index type.
SearchIteratorParam.Builder	withPartitionNames(@NonNull List<String> partitionNames)	Sets partition names list to specify search scope (Optional).
SearchIteratorParam.Builder	withRoundDecimal(@NonNull Integer decimal)	Specifies the decimal place of the returned results.
SearchIteratorParam.Builder	withSparseFloatVectors(@NonNull List<SortedMap<Long,Float>> vectors)	Sets the target vectors to search on SparseFloatVector field.
SearchIteratorParam.Builder	withTopK(@NonNull Integer topK)	Sets topK value of ANN search.
SearchIteratorParam.Builder	withVectorFieldName(@NonNull String vectorFieldName)	Sets target vector field by name.
SearchIteratorParam.Builder	withVectors(@NonNull List<?> vectors)	Deprecated.

Methods inherited from class java.lang.Object

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

Method Detail

withDatabaseName

public SearchIteratorParam.Builder withDatabaseName(String databaseName)

Sets the database name. database name can be nil.

Parameters:

databaseName - database name

Returns:

Builder

withCollectionName

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

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

Parameters:

collectionName - collection name

Returns:

Builder

withPartitionNames

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

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

Parameters:

partitionNames - partition names list

Returns:

Builder

withConsistencyLevel

public SearchIteratorParam.Builder withConsistencyLevel(ConsistencyLevelEnum consistencyLevel)

ConsistencyLevel of consistency level.

Parameters:

consistencyLevel - consistency level

Returns:

Builder

addPartitionName

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

Adds a partition to specify search scope (Optional).

Parameters:

partitionName - partition name

Returns:

Builder

withMetricType

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

Sets metric type of ANN searching.

Parameters:

metricType - metric type

Returns:

Builder

withVectorFieldName

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

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

Parameters:

vectorFieldName - vector field name

Returns:

Builder

withTopK

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

Sets topK value of ANN search.

Parameters:

topK - topK value

Returns:

Builder

withExpr

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

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

Parameters:

expr - filtering expression

Returns:

Builder

See Also:

Boolean Expression Rules

withOutFields

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

Specifies output fields (Optional).

Parameters:

outFields - output fields

Returns:

Builder

addOutField

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

Specifies an output field (Optional).

Parameters:

fieldName - filed name

Returns:

Builder

withVectors

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

Deprecated.

Sets the target vectors. Note: Deprecated in v2.4.0, for the reason that the sdk cannot know a ByteBuffer is a BinarVector or Float16Vector/BFloat16Vector. Replaced by withFloatVectors/withBinaryVectors/withFloat16Vectors/withBFloat16Vectors/withSparseFloatVectors. It still works for FloatVector/BinarVector/SparseVector, don't use it for Float16Vector/BFloat16Vector.

Parameters:

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; if vector type is SparseFloatVector, values is List of SortedMap[Long, Float];

Returns:

Builder

withFloatVectors

public SearchIteratorParam.Builder withFloatVectors(@NonNull
                                                    @NonNull List<List<Float>> vectors)

Sets the target vectors to search on FloatVector field.

Parameters:

vectors - target vectors to search

Returns:

Builder

withBinaryVectors

public SearchIteratorParam.Builder withBinaryVectors(@NonNull
                                                     @NonNull List<ByteBuffer> vectors)

Sets the target vectors to search on BinaryVector field.

Parameters:

vectors - target vectors to search

Returns:

Builder

withFloat16Vectors

public SearchIteratorParam.Builder withFloat16Vectors(@NonNull
                                                      @NonNull List<ByteBuffer> vectors)

Sets the target vectors to search on Float16Vector field.

Parameters:

vectors - target vectors to search

Returns:

Builder

withBFloat16Vectors

public SearchIteratorParam.Builder withBFloat16Vectors(@NonNull
                                                       @NonNull List<ByteBuffer> vectors)

Sets the target vectors to search on BFloat16Vector field.

Parameters:

vectors - target vectors to search

Returns:

Builder

withSparseFloatVectors

public SearchIteratorParam.Builder withSparseFloatVectors(@NonNull
                                                          @NonNull List<SortedMap<Long,Float>> vectors)

Sets the target vectors to search on SparseFloatVector field.

Parameters:

vectors - target vectors to search

Returns:

Builder

withRoundDecimal

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

Specifies the decimal place of the returned results.

Parameters:

decimal - how many digits after the decimal point

Returns:

Builder

withParams

public SearchIteratorParam.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

Parameters:

params - extra parameters in json format

Returns:

Builder

withIgnoreGrowing

public SearchIteratorParam.Builder withIgnoreGrowing(@NonNull
                                                     @NonNull Boolean ignoreGrowing)

Ignore the growing segments to get best search performance. Default is False. For the user case that don't require data visibility.

Parameters:

ignoreGrowing - Boolean.TRUE ignore, Boolean.FALSE is not

Returns:

Builder

withGroupByFieldName

public SearchIteratorParam.Builder withGroupByFieldName(@NonNull
                                                        @NonNull String groupByFieldName)

Sets field name to do grouping.

Parameters:

groupByFieldName - field name to do grouping

Returns:

Builder

withBatchSize

public SearchIteratorParam.Builder withBatchSize(@NotNull
                                                 Long batchSize)

Specify a value to control the number of entities returned per batch. Must be a positive value. Default value is 1000, will return without batchSize.

Parameters:

batchSize - a value to define the number of entities returned per batch

Returns:

Builder

build

public SearchIteratorParam build()
                          throws ParamException

Verifies parameters and creates a new SearchIteratorParam instance.

Returns:

SearchIteratorParam

Throws:

ParamException