Class FindNeighborsRequest.Query.Builder (3.25.0)

public static final class FindNeighborsRequest.Query.Builder extends GeneratedMessageV3.Builder<FindNeighborsRequest.Query.Builder> implements FindNeighborsRequest.QueryOrBuilder

A query to find a number of the nearest neighbors (most similar vectors) of a vector.

Protobuf type google.cloud.aiplatform.v1.FindNeighborsRequest.Query

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public FindNeighborsRequest.Query.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

build()

public FindNeighborsRequest.Query build()
Returns
TypeDescription
FindNeighborsRequest.Query

buildPartial()

public FindNeighborsRequest.Query buildPartial()
Returns
TypeDescription
FindNeighborsRequest.Query

clear()

public FindNeighborsRequest.Query.Builder clear()
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

clearApproximateNeighborCount()

public FindNeighborsRequest.Query.Builder clearApproximateNeighborCount()

The number of neighbors to find via approximate search before exact reordering is performed. If not set, the default value from scam config is used; if set, this value must be > 0.

int32 approximate_neighbor_count = 4;

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

This builder for chaining.

clearDatapoint()

public FindNeighborsRequest.Query.Builder clearDatapoint()

Required. The datapoint/vector whose nearest neighbors should be searched for.

.google.cloud.aiplatform.v1.IndexDatapoint datapoint = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

clearField(Descriptors.FieldDescriptor field)

public FindNeighborsRequest.Query.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

clearFractionLeafNodesToSearchOverride()

public FindNeighborsRequest.Query.Builder clearFractionLeafNodesToSearchOverride()

The fraction of the number of leaves to search, set at query time allows user to tune search performance. This value increase result in both search accuracy and latency increase. The value should be between 0.0 and 1.0. If not set or set to 0.0, query uses the default value specified in NearestNeighborSearchConfig.TreeAHConfig.fraction_leaf_nodes_to_search.

double fraction_leaf_nodes_to_search_override = 5;

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

This builder for chaining.

clearNeighborCount()

public FindNeighborsRequest.Query.Builder clearNeighborCount()

The number of nearest neighbors to be retrieved from database for each query. If not set, will use the default from the service configuration (https://cloud.google.com/vertex-ai/docs/matching-engine/configuring-indexes#nearest-neighbor-search-config).

int32 neighbor_count = 2;

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public FindNeighborsRequest.Query.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

clearPerCrowdingAttributeNeighborCount()

public FindNeighborsRequest.Query.Builder clearPerCrowdingAttributeNeighborCount()

Crowding is a constraint on a neighbor list produced by nearest neighbor search requiring that no more than some value k' of the k neighbors returned have the same value of crowding_attribute. It's used for improving result diversity. This field is the maximum number of matches with the same crowding tag.

int32 per_crowding_attribute_neighbor_count = 3;

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

This builder for chaining.

clone()

public FindNeighborsRequest.Query.Builder clone()
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

getApproximateNeighborCount()

public int getApproximateNeighborCount()

The number of neighbors to find via approximate search before exact reordering is performed. If not set, the default value from scam config is used; if set, this value must be > 0.

int32 approximate_neighbor_count = 4;

Returns
TypeDescription
int

The approximateNeighborCount.

getDatapoint()

public IndexDatapoint getDatapoint()

Required. The datapoint/vector whose nearest neighbors should be searched for.

.google.cloud.aiplatform.v1.IndexDatapoint datapoint = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
IndexDatapoint

The datapoint.

getDatapointBuilder()

public IndexDatapoint.Builder getDatapointBuilder()

Required. The datapoint/vector whose nearest neighbors should be searched for.

.google.cloud.aiplatform.v1.IndexDatapoint datapoint = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
IndexDatapoint.Builder

getDatapointOrBuilder()

public IndexDatapointOrBuilder getDatapointOrBuilder()

Required. The datapoint/vector whose nearest neighbors should be searched for.

.google.cloud.aiplatform.v1.IndexDatapoint datapoint = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
IndexDatapointOrBuilder

getDefaultInstanceForType()

public FindNeighborsRequest.Query getDefaultInstanceForType()
Returns
TypeDescription
FindNeighborsRequest.Query

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getFractionLeafNodesToSearchOverride()

public double getFractionLeafNodesToSearchOverride()

The fraction of the number of leaves to search, set at query time allows user to tune search performance. This value increase result in both search accuracy and latency increase. The value should be between 0.0 and 1.0. If not set or set to 0.0, query uses the default value specified in NearestNeighborSearchConfig.TreeAHConfig.fraction_leaf_nodes_to_search.

double fraction_leaf_nodes_to_search_override = 5;

Returns
TypeDescription
double

The fractionLeafNodesToSearchOverride.

getNeighborCount()

public int getNeighborCount()

The number of nearest neighbors to be retrieved from database for each query. If not set, will use the default from the service configuration (https://cloud.google.com/vertex-ai/docs/matching-engine/configuring-indexes#nearest-neighbor-search-config).

int32 neighbor_count = 2;

Returns
TypeDescription
int

The neighborCount.

getPerCrowdingAttributeNeighborCount()

public int getPerCrowdingAttributeNeighborCount()

Crowding is a constraint on a neighbor list produced by nearest neighbor search requiring that no more than some value k' of the k neighbors returned have the same value of crowding_attribute. It's used for improving result diversity. This field is the maximum number of matches with the same crowding tag.

int32 per_crowding_attribute_neighbor_count = 3;

Returns
TypeDescription
int

The perCrowdingAttributeNeighborCount.

hasDatapoint()

public boolean hasDatapoint()

Required. The datapoint/vector whose nearest neighbors should be searched for.

.google.cloud.aiplatform.v1.IndexDatapoint datapoint = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
TypeDescription
boolean

Whether the datapoint field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeDatapoint(IndexDatapoint value)

public FindNeighborsRequest.Query.Builder mergeDatapoint(IndexDatapoint value)

Required. The datapoint/vector whose nearest neighbors should be searched for.

.google.cloud.aiplatform.v1.IndexDatapoint datapoint = 1 [(.google.api.field_behavior) = REQUIRED];

Parameter
NameDescription
valueIndexDatapoint
Returns
TypeDescription
FindNeighborsRequest.Query.Builder

mergeFrom(FindNeighborsRequest.Query other)

public FindNeighborsRequest.Query.Builder mergeFrom(FindNeighborsRequest.Query other)
Parameter
NameDescription
otherFindNeighborsRequest.Query
Returns
TypeDescription
FindNeighborsRequest.Query.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public FindNeighborsRequest.Query.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public FindNeighborsRequest.Query.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

mergeUnknownFields(UnknownFieldSet unknownFields)

public final FindNeighborsRequest.Query.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

setApproximateNeighborCount(int value)

public FindNeighborsRequest.Query.Builder setApproximateNeighborCount(int value)

The number of neighbors to find via approximate search before exact reordering is performed. If not set, the default value from scam config is used; if set, this value must be > 0.

int32 approximate_neighbor_count = 4;

Parameter
NameDescription
valueint

The approximateNeighborCount to set.

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

This builder for chaining.

setDatapoint(IndexDatapoint value)

public FindNeighborsRequest.Query.Builder setDatapoint(IndexDatapoint value)

Required. The datapoint/vector whose nearest neighbors should be searched for.

.google.cloud.aiplatform.v1.IndexDatapoint datapoint = 1 [(.google.api.field_behavior) = REQUIRED];

Parameter
NameDescription
valueIndexDatapoint
Returns
TypeDescription
FindNeighborsRequest.Query.Builder

setDatapoint(IndexDatapoint.Builder builderForValue)

public FindNeighborsRequest.Query.Builder setDatapoint(IndexDatapoint.Builder builderForValue)

Required. The datapoint/vector whose nearest neighbors should be searched for.

.google.cloud.aiplatform.v1.IndexDatapoint datapoint = 1 [(.google.api.field_behavior) = REQUIRED];

Parameter
NameDescription
builderForValueIndexDatapoint.Builder
Returns
TypeDescription
FindNeighborsRequest.Query.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public FindNeighborsRequest.Query.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

setFractionLeafNodesToSearchOverride(double value)

public FindNeighborsRequest.Query.Builder setFractionLeafNodesToSearchOverride(double value)

The fraction of the number of leaves to search, set at query time allows user to tune search performance. This value increase result in both search accuracy and latency increase. The value should be between 0.0 and 1.0. If not set or set to 0.0, query uses the default value specified in NearestNeighborSearchConfig.TreeAHConfig.fraction_leaf_nodes_to_search.

double fraction_leaf_nodes_to_search_override = 5;

Parameter
NameDescription
valuedouble

The fractionLeafNodesToSearchOverride to set.

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

This builder for chaining.

setNeighborCount(int value)

public FindNeighborsRequest.Query.Builder setNeighborCount(int value)

The number of nearest neighbors to be retrieved from database for each query. If not set, will use the default from the service configuration (https://cloud.google.com/vertex-ai/docs/matching-engine/configuring-indexes#nearest-neighbor-search-config).

int32 neighbor_count = 2;

Parameter
NameDescription
valueint

The neighborCount to set.

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

This builder for chaining.

setPerCrowdingAttributeNeighborCount(int value)

public FindNeighborsRequest.Query.Builder setPerCrowdingAttributeNeighborCount(int value)

Crowding is a constraint on a neighbor list produced by nearest neighbor search requiring that no more than some value k' of the k neighbors returned have the same value of crowding_attribute. It's used for improving result diversity. This field is the maximum number of matches with the same crowding tag.

int32 per_crowding_attribute_neighbor_count = 3;

Parameter
NameDescription
valueint

The perCrowdingAttributeNeighborCount to set.

Returns
TypeDescription
FindNeighborsRequest.Query.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public FindNeighborsRequest.Query.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final FindNeighborsRequest.Query.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
FindNeighborsRequest.Query.Builder
Overrides