Package com.mongodb.client.model.search

Interface VectorSearchOptions

All Superinterfaces:

Bson

@Sealed
@Beta(SERVER)
public interface VectorSearchOptions
extends Bson

Represents optional fields of the $vectorSearch pipeline stage of an aggregation pipeline.

Since:

4.11

See Also:

• Aggregates.vectorSearch(FieldSearchPath, Iterable, String, long, long, VectorSearchOptions)

MongoDB Atlas documentation

$vectorSearch

Since server release

6.0.10

Field Summary

Fields inherited from interface org.bson.conversions.Bson

DEFAULT_CODEC_REGISTRY

Method Summary

Modifier and Type	Method	Description
VectorSearchOptions	filter(Bson filter)	Creates a new VectorSearchOptions with the filter specified.
VectorSearchOptions	option(String name, Object value)	Creates a new VectorSearchOptions with the specified option in situations when there is no builder method that better satisfies your needs.
static VectorSearchOptions	vectorSearchOptions()	Returns VectorSearchOptions that represents server defaults.

Methods inherited from interface org.bson.conversions.Bson

toBsonDocument, toBsonDocument

Method Details

filter

VectorSearchOptions filter(Bson filter)

Creates a new VectorSearchOptions with the filter specified.

Parameters:

filter - A filter that is applied before applying the queryVector. One may use Filters to create this filter, though not all filters may be supported. See the MongoDB documentation for the list of supported filters.

Note that for now one has to use Filters.eqFull(String, Object) instead of Filters.eq(String, Object).

Returns:

A new VectorSearchOptions.

option

VectorSearchOptions option(String name,
 Object value)

Creates a new VectorSearchOptions with the specified option in situations when there is no builder method that better satisfies your needs. This method cannot be used to validate the syntax.

Example
The following code creates two functionally equivalent VectorSearchOptions objects, though they may not be equal.

  VectorSearchOptions options1 = VectorSearchOptions.vectorSearchOptions()
      .filter(Filters.lt("fieldName", 1));
  VectorSearchOptions options2 = VectorSearchOptions.vectorSearchOptions()
      .option("filter", Filters.lt("fieldName", 1));
 

Parameters:

name - The option name.

value - The option value.

Returns:

A new VectorSearchOptions.

vectorSearchOptions

static VectorSearchOptions vectorSearchOptions()

Returns VectorSearchOptions that represents server defaults.

Returns:

VectorSearchOptions that represents server defaults.