io.pinecone.clients

Class AsyncIndex

java.lang.Object

io.pinecone.clients.AsyncIndex

All Implemented Interfaces:

IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>, java.lang.AutoCloseable

public class AsyncIndex
extends java.lang.Object
implements IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

A client for interacting with a Pinecone index via GRPC asynchronously. Allows for upserting, querying, fetching, updating, and deleting vectors. This class provides a direct interface to interact with a specific index, encapsulating network communication and request validation.

Example:

     import io.pinecone.clients.Pinecone;
     import io.pinecone.clients.AsyncIndex;

     Pinecone client = new Pinecone.Builder(System.getenv("PINECONE_API_KEY")).build();
     AsyncIndex asyncIndex = client.getAsyncIndexConnection("my-index");
 

Constructor Summary

Constructors

Constructor and Description
AsyncIndex(PineconeConnection connection, java.lang.String indexName) Constructs an AsyncIndex instance for interacting with a Pinecone index.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the current index connection gracefully, releasing any resources associated with it.
com.google.common.util.concurrent.ListenableFuture<DeleteResponse>	delete(java.util.List<java.lang.String> ids, boolean deleteAll, java.lang.String namespace, com.google.protobuf.Struct filter) A flexible delete operation allowing for the deletion of vectors by ID, by filter, or all vectors in a namespace.
com.google.common.util.concurrent.ListenableFuture<DeleteResponse>	deleteAll(java.lang.String namespace) Deletes all vectors within a specified namespace.
com.google.common.util.concurrent.ListenableFuture<DeleteResponse>	deleteByFilter(com.google.protobuf.Struct filter) Deletes vectors matching a specific metadata filter criteria from the default namespace.
com.google.common.util.concurrent.ListenableFuture<DeleteResponse>	deleteByFilter(com.google.protobuf.Struct filter, java.lang.String namespace) Deletes vectors matching a specific metadata filter criteria from a specified namespace.
com.google.common.util.concurrent.ListenableFuture<DeleteResponse>	deleteByIds(java.util.List<java.lang.String> ids) Deletes a list of vectors by ID from the default namespace.
com.google.common.util.concurrent.ListenableFuture<DeleteResponse>	deleteByIds(java.util.List<java.lang.String> ids, java.lang.String namespace) Deletes vectors identified by a list of unique IDs from a specified namespace.
com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>	describeIndexStats() Retrieves statistics about the index's contents, such as vector count per namespace, and number of dimensions.
com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>	describeIndexStats(com.google.protobuf.Struct filter) Retrieves statistics about the index's contents for vectors that satisfy the applied metadata filter.
com.google.common.util.concurrent.ListenableFuture<FetchResponse>	fetch(java.util.List<java.lang.String> ids) Looks up vectors by ID from the default namespace.
com.google.common.util.concurrent.ListenableFuture<FetchResponse>	fetch(java.util.List<java.lang.String> ids, java.lang.String namespace) Looks up vectors by ID from a specified namespace.
com.google.common.util.concurrent.ListenableFuture<ListResponse>	list() Retrieves up to 100 vector IDs from an index from the default namespace.
com.google.common.util.concurrent.ListenableFuture<ListResponse>	list(java.lang.String namespace) Retrieves up to 100 vector IDs from a given namespace.
com.google.common.util.concurrent.ListenableFuture<ListResponse>	list(java.lang.String namespace, int limit) Retrieves up to n vector IDs from a given namespace, where limit == n.
com.google.common.util.concurrent.ListenableFuture<ListResponse>	list(java.lang.String namespace, int limit, java.lang.String paginationToken) Retrieves up to n vector IDs from a given namespace, targeted with a specific paginationToken, where limit == n.
com.google.common.util.concurrent.ListenableFuture<ListResponse>	list(java.lang.String namespace, java.lang.String prefix) Retrieves up to 100 vector IDs from a given namespace, filtered by a given prefix.
com.google.common.util.concurrent.ListenableFuture<ListResponse>	list(java.lang.String namespace, java.lang.String prefix, int limit) Retrieves up to n vector IDs from a given namespace, filtered by a given prefix, where limit` == n.
com.google.common.util.concurrent.ListenableFuture<ListResponse>	list(java.lang.String namespace, java.lang.String prefix, java.lang.String paginationToken) Retrieves up to 100 vector IDs from a given namespace, filtered by a given prefix, targeted with a specific paginationToken.
com.google.common.util.concurrent.ListenableFuture<ListResponse>	list(java.lang.String namespace, java.lang.String prefix, java.lang.String paginationToken, int limit) Base method that retrieves a list of vector IDs from a specific namespace within an index.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	query(int topK, java.util.List<java.lang.Float> vector, java.util.List<java.lang.Long> sparseIndices, java.util.List<java.lang.Float> sparseValues, java.lang.String id, java.lang.String namespace, com.google.protobuf.Struct filter, boolean includeValues, boolean includeMetadata) Queries a namespace using a provided query vector.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVector(int topK, java.util.List<java.lang.Float> vector) Queries the default namespace using a provided query vector.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVector(int topK, java.util.List<java.lang.Float> vector, boolean includeValues, boolean includeMetadata) Queries the default namespace using a provided query vector, with options to include values and metadata in the results.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVector(int topK, java.util.List<java.lang.Float> vector, java.lang.String namespace) Queries a specified namespace using a provided query vector.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVector(int topK, java.util.List<java.lang.Float> vector, java.lang.String namespace, boolean includeValues, boolean includeMetadata) Queries a specified namespace using a provided query vector, with options to include values and metadata in the results.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVector(int topK, java.util.List<java.lang.Float> vector, java.lang.String namespace, com.google.protobuf.Struct filter) Queries a specified namespace using a provided query vector and a custom filter.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVector(int topK, java.util.List<java.lang.Float> vector, java.lang.String namespace, com.google.protobuf.Struct filter, boolean includeValues, boolean includeMetadata) Queries a specified namespace using a provided query vector, a custom filter, and options to include values and metadata in the results.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVectorId(int topK, java.lang.String id) Queries a namespace using a query vector.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVectorId(int topK, java.lang.String id, boolean includeValues, boolean includeMetadata) Queries a namespace using a query vector identified by an ID, with options to include values and metadata in the results.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVectorId(int topK, java.lang.String id, java.lang.String namespace) Queries a specified namespace using a vector ID.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVectorId(int topK, java.lang.String id, java.lang.String namespace, boolean includeValues, boolean includeMetadata) Queries a specified namespace using a vector ID, with options to include values and metadata in the results.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVectorId(int topK, java.lang.String id, java.lang.String namespace, com.google.protobuf.Struct filter) Queries a specified namespace using a vector ID and a custom filter.
com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>	queryByVectorId(int topK, java.lang.String id, java.lang.String namespace, com.google.protobuf.Struct filter, boolean includeValues, boolean includeMetadata) Queries a specified namespace using a vector ID, a custom filter, and options to include values and metadata in the results.
com.google.common.util.concurrent.ListenableFuture<UpdateResponse>	update(java.lang.String id, java.util.List<java.lang.Float> values) Updates an existing vector by ID with new values in the default namespace.
com.google.common.util.concurrent.ListenableFuture<UpdateResponse>	update(java.lang.String id, java.util.List<java.lang.Float> values, java.lang.String namespace) Updates an existing vector by ID with new values in a specified namespace.
com.google.common.util.concurrent.ListenableFuture<UpdateResponse>	update(java.lang.String id, java.util.List<java.lang.Float> values, com.google.protobuf.Struct metadata, java.lang.String namespace, java.util.List<java.lang.Long> sparseIndices, java.util.List<java.lang.Float> sparseValues) Updates an existing vector by ID in a specified namespace.
com.google.common.util.concurrent.ListenableFuture<UpsertResponse>	upsert(java.util.List<VectorWithUnsignedIndices> vectorList, java.lang.String namespace) Performs an upsert operation for a list of vectors within a namespace.
com.google.common.util.concurrent.ListenableFuture<UpsertResponse>	upsert(java.lang.String id, java.util.List<java.lang.Float> values) Performs an upsert operation for a single vector in the default namespace.
com.google.common.util.concurrent.ListenableFuture<UpsertResponse>	upsert(java.lang.String id, java.util.List<java.lang.Float> values, java.util.List<java.lang.Long> sparseIndices, java.util.List<java.lang.Float> sparseValues, com.google.protobuf.Struct metadata, java.lang.String namespace) Upserts a vector with both dense and sparse components, and optional metadata, into a specified namespace.
com.google.common.util.concurrent.ListenableFuture<UpsertResponse>	upsert(java.lang.String id, java.util.List<java.lang.Float> values, java.lang.String namespace) Performs an upsert operation for a single vector in the specified namespace.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.pinecone.commons.IndexInterface

buildUpsertVector, buildUpsertVectorWithUnsignedIndices, validateDeleteRequest, validateDescribeIndexStatsRequest, validateFetchRequest, validateListEndpointParameters, validateQueryRequest, validateUpdateRequest, validateUpsertRequest, validateUpsertRequest

Constructor Detail

AsyncIndex

public AsyncIndex(PineconeConnection connection,
                  java.lang.String indexName)

Constructs an AsyncIndex instance for interacting with a Pinecone index.

Example:

     import io.pinecone.clients.Pinecone;
     import io.pinecone.clients.AsyncIndex;

     Pinecone client = new Pinecone.Builder(System.getenv("PINECONE_API_KEY")).build();
     AsyncIndex asyncIndex = client.getAsyncIndexConnection("my-index");
 

Parameters:

connection - The PineconeConnection configuration to be used for this index.

indexName - The name of the index to interact with. The index host will be automatically resolved.

Throws:

PineconeValidationException - if the connection object is null.

Method Detail

upsert

public com.google.common.util.concurrent.ListenableFuture<UpsertResponse> upsert(java.util.List<VectorWithUnsignedIndices> vectorList,
                                                                                 java.lang.String namespace)

Performs an upsert operation for a list of vectors within a namespace. If namespace is empty a default namespace is used.

Example:

     import io.pinecone.proto.UpsertResponse;
     import io.pinecone.unsigned_indices_model.VectorWithUnsignedIndices;
     import static io.pinecone.commons.IndexInterface.buildUpsertVectorWithUnsignedIndices;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     // Vector ids to be upserted
     List<String> upsertIds = Arrays.asList("v1", "v2", "v3");

     // List of values to be upserted
     List<List<Float>> values = new ArrayList<>();
     values.add(Arrays.asList(1.0f, 2.0f, 3.0f));
     values.add(Arrays.asList(4.0f, 5.0f, 6.0f));
     values.add(Arrays.asList(7.0f, 8.0f, 9.0f));

     // List of sparse indices to be upserted
     List<List<Long>> sparseIndices = new ArrayList<>();
     sparseIndices.add(Arrays.asList(1L, 2L, 3L));
     sparseIndices.add(Arrays.asList(4L, 5L, 6L));
     sparseIndices.add(Arrays.asList(7L, 8L, 9L));

     // List of sparse values to be upserted
     List<List<Float>> sparseValues = new ArrayList<>();
     sparseValues.add(Arrays.asList(1000f, 2000f, 3000f));
     sparseValues.add(Arrays.asList(4000f, 5000f, 6000f));
     sparseValues.add(Arrays.asList(7000f, 8000f, 9000f));

     List<VectorWithUnsignedIndices> vectors = new ArrayList<>(3);

     // metadata
     Struct metadataStruct1 = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build())
         .putFields("year", Value.newBuilder().setNumberValue(2019).build())
         .build();

     Struct metadataStruct2 = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("thriller").build())
         .putFields("year", Value.newBuilder().setNumberValue(2020).build())
         .build();

     Struct metadataStruct3 = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("comedy").build())
         .putFields("year", Value.newBuilder().setNumberValue(2021).build())
         .build();
     List<Struct> metadataStructList =
     Arrays.asList(metadataStruct1, metadataStruct2, metadataStruct3);

     List<VectorWithUnsignedIndices> vectors = new ArrayList<>(3);

     for (int i=0; i<upsertIds.size(); i++) {
         vectors.add(
             buildUpsertVectorWithUnsignedIndices(upsertIds.get(i),
                 values.get(i),
                 sparseIndices.get(i),
                 sparseValues.get(i),
                 metadataStructList.get(i)));
     }

     ListenableFuture<UpsertResponse> listenableFuture = asyncIndex.upsert(vectors, "example-namespace");
 

Specified by:

upsert in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

vectorList - A list of vectors with unsigned indices to upsert.

namespace - The namespace where the vectors should be upserted. This is optional.

Returns:

A generic type T indicating the result of the upsert operation.

upsert

public com.google.common.util.concurrent.ListenableFuture<UpsertResponse> upsert(java.lang.String id,
                                                                                 java.util.List<java.lang.Float> values)

Performs an upsert operation for a single vector in the default namespace.

Example:

     import io.pinecone.proto.UpsertResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<UpsertResponse> listenableFuture =
     asyncIndex.upsert("my-vector-id", Arrays.asList(1.0f, 2.0f, 3.0f));
 

Specified by:

upsert in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

id - The unique identifier of the vector.

values - The list of floating-point values that represent the vector.

Returns:

A generic type T indicating the result of the upsert operation.

upsert

public com.google.common.util.concurrent.ListenableFuture<UpsertResponse> upsert(java.lang.String id,
                                                                                 java.util.List<java.lang.Float> values,
                                                                                 java.lang.String namespace)

Performs an upsert operation for a single vector in the specified namespace.

Example:

     import io.pinecone.proto.UpsertResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<UpsertResponse> listenableFuture =
     asyncIndex.upsert("my-vector-id", Arrays.asList(1.0f, 2.0f, 3.0f), "example-namespace");
 

Specified by:

upsert in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

id - The unique identifier of the vector.

values - The list of floating-point values that represent the vector.

namespace - The namespace where the vector should be upserted. This is optional.

Returns:

A generic type T indicating the result of the upsert operation.

upsert

public com.google.common.util.concurrent.ListenableFuture<UpsertResponse> upsert(java.lang.String id,
                                                                                 java.util.List<java.lang.Float> values,
                                                                                 java.util.List<java.lang.Long> sparseIndices,
                                                                                 java.util.List<java.lang.Float> sparseValues,
                                                                                 com.google.protobuf.Struct metadata,
                                                                                 java.lang.String namespace)

Upserts a vector with both dense and sparse components, and optional metadata, into a specified namespace.

Example:

     import io.pinecone.proto.UpsertResponse;
     import io.pinecone.unsigned_indices_model.VectorWithUnsignedIndices;
     import static io.pinecone.commons.IndexInterface.buildUpsertVectorWithUnsignedIndices;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     // metadata
     Struct metadataStruct = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build())
         .putFields("year", Value.newBuilder().setNumberValue(2019).build())
         .build();

     ListenableFuture<UpsertResponse> listenableFuture =
     asyncIndex.upsert("my-vector-id",
         Arrays.asList(1.0f, 2.0f, 3.0f),
         Arrays.asList(1L, 2L, 3L),
         Arrays.asList(1000f, 2000f, 3000f),
         metadataStruct,
         "example-namespace");
 

Specified by:

upsert in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

id - The unique identifier for the vector.

values - The dense vector values.

sparseIndices - Indices for sparse vector representation.

sparseValues - Values for the sparse indices.

metadata - Metadata associated with the vector.

namespace - The namespace to upsert the vector into. This is optional.

Returns:

A generic type T indicating the result of the upsert operation.

query

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> query(int topK,
                                                                                                  java.util.List<java.lang.Float> vector,
                                                                                                  java.util.List<java.lang.Long> sparseIndices,
                                                                                                  java.util.List<java.lang.Float> sparseValues,
                                                                                                  java.lang.String id,
                                                                                                  java.lang.String namespace,
                                                                                                  com.google.protobuf.Struct filter,
                                                                                                  boolean includeValues,
                                                                                                  boolean includeMetadata)

Queries a namespace using a provided query vector. Retrieves the IDs of the most similar items, along with their similarity scores.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.query(10,
         Arrays.asList(1.0f, 2.0f, 3.0f),
         Arrays.asList(1L, 2L, 3L),
         Arrays.asList(1000f, 2000f, 3000f),
         null,
         "example-namespace",
         null,
         true,
         true);
 

Specified by:

query in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

vector - The dense query vector as a list of floating-point values. Each query can contain only one of the parameters: vector or id.

sparseIndices - The indices of the sparse vector representation, if applicable.

sparseValues - The values at the specified indices of the sparse vector representation.

id - The unique ID of a vector to be used as a query vector. Each query can contain only one of the parameters: vector or id.

namespace - The namespace within which the query is performed.

filter - A Struct defining additional filtering criteria for the query.

includeValues - Flag indicating whether to include the vector values in the query results.

includeMetadata - Flag indicating whether to include the vector metadata in the query results.

Returns:

A generic type U representing the query results containing a list of the closest vectors and a namespace name.

queryByVectorId

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVectorId(int topK,
                                                                                                            java.lang.String id,
                                                                                                            java.lang.String namespace,
                                                                                                            com.google.protobuf.Struct filter,
                                                                                                            boolean includeValues,
                                                                                                            boolean includeMetadata)

Queries a specified namespace using a vector ID, a custom filter, and options to include values and metadata in the results. Retrieves the IDs of the most similar items, along with their similarity scores, and optionally, their values and metadata, all while applying a filter.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVectorId(10,
         "my-vector-id",
         "example-namespace",
         null,
         true,
         true);
 

Specified by:

queryByVectorId in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

id - The unique ID of a vector to be used as a query vector.

namespace - The namespace within which the query is performed.

filter - A Struct defining additional filtering criteria for the query.

includeValues - Flag indicating whether to include the vector values in the query results.

includeMetadata - Flag indicating whether to include the vector metadata in the query results.

Returns:

A generic type U representing the query results, including optional values and metadata based on parameters and filtered according to the provided criteria.

queryByVectorId

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVectorId(int topK,
                                                                                                            java.lang.String id,
                                                                                                            java.lang.String namespace,
                                                                                                            com.google.protobuf.Struct filter)

Queries a specified namespace using a vector ID and a custom filter. Retrieves the IDs of the most similar items, along with their similarity scores.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     Struct filter = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build()).build();
     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVectorId(10,
         "my-vector-id",
         "example-namespace",
         filter);
 

Specified by:

queryByVectorId in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

id - The unique ID of a vector to be used as a query vector.

namespace - The namespace within which the query is performed.

filter - A Struct defining additional filtering criteria for the query.

Returns:

A generic type U representing the query results, filtered according to the provided criteria.

queryByVectorId

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVectorId(int topK,
                                                                                                            java.lang.String id,
                                                                                                            java.lang.String namespace,
                                                                                                            boolean includeValues,
                                                                                                            boolean includeMetadata)

Queries a specified namespace using a vector ID, with options to include values and metadata in the results. Retrieves the IDs of the most similar items, along with their similarity scores, and optionally, their values and metadata.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVectorId(10,
         "my-vector-id",
         "example-namespace",
         true,
         true);
 

Specified by:

queryByVectorId in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

id - The unique ID of a vector to be used as a query vector.

namespace - The namespace within which the query is performed.

includeValues - Flag indicating whether to include the vector values in the query results.

includeMetadata - Flag indicating whether to include the vector metadata in the query results.

Returns:

A generic type U representing the query results, including optional values and metadata based on parameters.

queryByVectorId

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVectorId(int topK,
                                                                                                            java.lang.String id,
                                                                                                            java.lang.String namespace)

Queries a specified namespace using a vector ID. Retrieves the IDs of the most similar items, along with their similarity scores.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVectorId(10, "my-vector-id", "example-namespace");
 

Specified by:

queryByVectorId in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

id - The unique ID of a vector to be used as a query vector.

namespace - The namespace within which the query is performed.

Returns:

A generic type U representing the query results.

queryByVectorId

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVectorId(int topK,
                                                                                                            java.lang.String id,
                                                                                                            boolean includeValues,
                                                                                                            boolean includeMetadata)

Queries a namespace using a query vector identified by an ID, with options to include values and metadata in the results. Retrieves the IDs of the most similar items, along with their similarity scores, and optionally, their values and metadata.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVectorId(10, "my-vector-id", true, true);
 

Specified by:

queryByVectorId in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

id - The unique ID of a vector to be used as a query vector.

includeValues - Flag indicating whether to include the vector values in the query results.

includeMetadata - Flag indicating whether to include the vector metadata in the query results.

Returns:

A generic type U representing the query results, including optional values and metadata based on parameters.

queryByVectorId

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVectorId(int topK,
                                                                                                            java.lang.String id)

Queries a namespace using a query vector. Retrieves the ids of the most similar items, along with their similarity scores.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVectorId(10, "my-vector-id");
 

Specified by:

queryByVectorId in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

id - The unique id of a vector to be used as a query vector.

Returns:

A generic type U representing the query results.

queryByVector

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVector(int topK,
                                                                                                          java.util.List<java.lang.Float> vector,
                                                                                                          java.lang.String namespace,
                                                                                                          com.google.protobuf.Struct filter,
                                                                                                          boolean includeValues,
                                                                                                          boolean includeMetadata)

Queries a specified namespace using a provided query vector, a custom filter, and options to include values and metadata in the results. Retrieves the IDs of the most similar topK items, along with their similarity scores.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     Struct filter = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build()).build();
     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVector(10,
         Arrays.asList(1.0f, 2.0f, 3.0f),
         "example-namespace",
         filter,
         true,
         true);
 

Specified by:

queryByVector in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

vector - The query vector as a list of floating-point values.

namespace - The namespace within which the query is performed.

filter - A Struct defining additional filtering criteria for the query.

includeValues - Flag indicating whether to include the vector values in the query results.

includeMetadata - Flag indicating whether to include the vector metadata in the query results.

Returns:

A generic type U representing the query results, including optional values and metadata based on parameters and filtered according to the provided criteria.

queryByVector

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVector(int topK,
                                                                                                          java.util.List<java.lang.Float> vector,
                                                                                                          java.lang.String namespace,
                                                                                                          com.google.protobuf.Struct filter)

Queries a specified namespace using a provided query vector and a custom filter. Retrieves the IDs of the most similar items, along with their similarity scores.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     Struct filter = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build()).build();
     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVector(10,
         Arrays.asList(1.0f, 2.0f, 3.0f),
         "example-namespace",
         filter);
 

Specified by:

queryByVector in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

vector - The query vector as a list of floating-point values.

namespace - The namespace within which the query is performed.

filter - A Struct defining additional filtering criteria for the query.

Returns:

A generic type U representing the query results, filtered according to the provided criteria.

queryByVector

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVector(int topK,
                                                                                                          java.util.List<java.lang.Float> vector,
                                                                                                          java.lang.String namespace,
                                                                                                          boolean includeValues,
                                                                                                          boolean includeMetadata)

Queries a specified namespace using a provided query vector, with options to include values and metadata in the results. Retrieves the IDs of the most similar items, along with their similarity scores, and optionally, their values and metadata.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     index.queryByVector(10,
         Arrays.asList(1.0f, 2.0f, 3.0f),
         "example-namespace",
         true,
         true);
 

Specified by:

queryByVector in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

vector - The query vector as a list of floating-point values.

namespace - The namespace within which the query is performed.

includeValues - Flag indicating whether to include the vector values in the query results.

includeMetadata - Flag indicating whether to include the vector metadata in the query results.

Returns:

A generic type U representing the query results, including optional values and metadata based on parameters.

queryByVector

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVector(int topK,
                                                                                                          java.util.List<java.lang.Float> vector,
                                                                                                          java.lang.String namespace)

Queries a specified namespace using a provided query vector. Retrieves the IDs of the most similar items, along with their similarity scores.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVector(10, Arrays.asList(1.0f, 2.0f, 3.0f), "example-namespace");
 

Specified by:

queryByVector in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

vector - The query vector as a list of floating-point values.

namespace - The namespace within which the query is performed.

Returns:

A generic type U representing the query results.

queryByVector

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVector(int topK,
                                                                                                          java.util.List<java.lang.Float> vector,
                                                                                                          boolean includeValues,
                                                                                                          boolean includeMetadata)

Queries the default namespace using a provided query vector, with options to include values and metadata in the results. Retrieves the IDs of the most similar items, along with their similarity scores, and optionally, their values and metadata.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVector(10, Arrays.asList(1.0f, 2.0f, 3.0f), true, true);
 

Specified by:

queryByVector in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

vector - The query vector as a list of floating-point values.

includeValues - Flag indicating whether to include the vector values in the query results.

includeMetadata - Flag indicating whether to include the vector metadata in the query results.

Returns:

A generic type U representing the query results, including optional values and metadata based on parameters.

queryByVector

public com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices> queryByVector(int topK,
                                                                                                          java.util.List<java.lang.Float> vector)

Queries the default namespace using a provided query vector. Retrieves the IDs of the most similar items, along with their similarity scores.

Example:

     import io.pinecone.unsigned_indices_model.QueryResponseWithUnsignedIndices;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<QueryResponseWithUnsignedIndices> listenableFuture =
     asyncIndex.queryByVector(10, Arrays.asList(1.0f, 2.0f, 3.0f));
 

Specified by:

queryByVector in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

topK - The number of top similar vectors to retrieve.

vector - The query vector as a list of floating-point values.

Returns:

A generic type U representing the query results.

fetch

public com.google.common.util.concurrent.ListenableFuture<FetchResponse> fetch(java.util.List<java.lang.String> ids)

Looks up vectors by ID from the default namespace.

Example:

     import io.pinecone.proto.FetchResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<FetchResponse> listenableFuture =
     asyncIndex.fetch(Arrays.asList("v1", "v2", "v3"));
 

Specified by:

fetch in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

ids - A list of unique identifiers for the vectors to fetch.

Returns:

A generic type V representing the fetched vectors and the namespace.

fetch

public com.google.common.util.concurrent.ListenableFuture<FetchResponse> fetch(java.util.List<java.lang.String> ids,
                                                                               java.lang.String namespace)

Looks up vectors by ID from a specified namespace.

Example:

     import io.pinecone.proto.FetchResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<FetchResponse> listenableFuture =
     asyncIndex.fetch(Arrays.asList("v1", "v2", "v3"), "example-namespace");
 

Specified by:

fetch in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

ids - A list of unique identifiers for the vectors to fetch.

namespace - The namespace to fetch vectors from.

Returns:

A generic type V representing the fetched vectors and the namespace.

update

public com.google.common.util.concurrent.ListenableFuture<UpdateResponse> update(java.lang.String id,
                                                                                 java.util.List<java.lang.Float> values)

Updates an existing vector by ID with new values in the default namespace.

Example:

     import io.pinecone.proto.UpdateResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<UpdateResponse> listenableFuture =
     asyncIndex.update("my-vector-id", Arrays.asList(1.0f, 2.0f, 3.0f));
 

Specified by:

update in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

id - The unique identifier of the vector to update.

values - The new list of vector values to assign to set.

Returns:

A generic type W representing the result of the update operation.

update

public com.google.common.util.concurrent.ListenableFuture<UpdateResponse> update(java.lang.String id,
                                                                                 java.util.List<java.lang.Float> values,
                                                                                 java.lang.String namespace)

Updates an existing vector by ID with new values in a specified namespace.

Example:

     import io.pinecone.proto.UpdateResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<UpdateResponse> listenableFuture =
     asyncIndex.update("my-vector-id",Arrays.asList(1.0f, 2.0f, 3.0f),"example-namespace");
 

Specified by:

update in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

id - The unique identifier of the vector to update.

values - The new list of vector values to assign to set.

namespace - The namespace in which to update the vector.

Returns:

A generic type W representing the result of the update operation.

update

public com.google.common.util.concurrent.ListenableFuture<UpdateResponse> update(java.lang.String id,
                                                                                 java.util.List<java.lang.Float> values,
                                                                                 com.google.protobuf.Struct metadata,
                                                                                 java.lang.String namespace,
                                                                                 java.util.List<java.lang.Long> sparseIndices,
                                                                                 java.util.List<java.lang.Float> sparseValues)

Updates an existing vector by ID in a specified namespace. Allows updating the vector's values, metadata, and sparse representation.

Example:

     import io.pinecone.proto.UpdateResponse;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     Struct metadata = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build())
         .putFields("year", Value.newBuilder().setNumberValue(2019).build())
         .build();

     ListenableFuture<UpdateResponse> listenableFuture =
     asyncIndex.update("my-vector-id",
         Arrays.asList(1.0f, 2.0f, 3.0f),
         metadata,
         "example-namespace",
         Arrays.asList(1L, 2L, 3L),
         Arrays.asList(1000f, 2000f, 3000f));
 

Specified by:

update in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

id - The unique identifier of the vector to be updated.

values - The new list of floating-point values for the vector's dense representation. Previous values are overwritten.

metadata - Optional new metadata to associate with the vector. If provided, it replaces the existing metadata.

namespace - The namespace in which the vector resides and will be updated.

sparseIndices - Indices for the sparse vector representation, if applicable.

sparseValues - Values for the sparse vector representation. Must correspond to the provided indices.

Returns:

A generic type W representing the result of the update operation.

deleteByIds

public com.google.common.util.concurrent.ListenableFuture<DeleteResponse> deleteByIds(java.util.List<java.lang.String> ids,
                                                                                      java.lang.String namespace)

Deletes vectors identified by a list of unique IDs from a specified namespace.

Example:

     import io.pinecone.proto.DeleteResponse;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<DeleteResponse> listenableFuture =
     asyncIndex.deleteByIds(Arrays.asList("v1", "v2", "v3"), "example-namespace");
 

Specified by:

deleteByIds in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

ids - A list of unique vector IDs to be deleted.

namespace - The namespace from which the vectors will be deleted.

Returns:

A generic type X indicating the result of the delete operation.

deleteByIds

public com.google.common.util.concurrent.ListenableFuture<DeleteResponse> deleteByIds(java.util.List<java.lang.String> ids)

Deletes a list of vectors by ID from the default namespace.

Example:

     import io.pinecone.proto.DeleteResponse;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<DeleteResponse> listenableFuture =
     asyncIndex.deleteByIds(Arrays.asList("v1", "v2", "v3"));
 

Specified by:

deleteByIds in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

ids - A list of unique vector IDs to be deleted.

Returns:

A generic type X indicating the result of the delete operation.

deleteByFilter

public com.google.common.util.concurrent.ListenableFuture<DeleteResponse> deleteByFilter(com.google.protobuf.Struct filter,
                                                                                         java.lang.String namespace)

Deletes vectors matching a specific metadata filter criteria from a specified namespace.

Example:

     import io.pinecone.proto.DeleteResponse;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     Struct filter = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build()).build();
     ListenableFuture<DeleteResponse> listenableFuture =
     asyncIndex.deleteByFilter(filter, "example-namespace");
 

Specified by:

deleteByFilter in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

filter - The metadata filter used to select vectors to delete.

namespace - The namespace from which the vectors matching the filter will be deleted.

Returns:

A generic type X indicating the result of the delete operation.

deleteByFilter

public com.google.common.util.concurrent.ListenableFuture<DeleteResponse> deleteByFilter(com.google.protobuf.Struct filter)

Deletes vectors matching a specific metadata filter criteria from the default namespace.

Example:

     import io.pinecone.proto.DeleteResponse;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     Struct filter = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build()).build();
     ListenableFuture<DeleteResponse> listenableFuture = asyncIndex.deleteByFilter(filter);
 

Specified by:

deleteByFilter in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

filter - The metadata filter used to select vectors to delete.

Returns:

A generic type X indicating the result of the delete operation.

deleteAll

public com.google.common.util.concurrent.ListenableFuture<DeleteResponse> deleteAll(java.lang.String namespace)

Deletes all vectors within a specified namespace. If null is passed, all vectors in the default namespace are deleted.

Example:

     import io.pinecone.proto.DeleteResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<DeleteResponse> listenableFuture = asyncIndex.deleteAll("example-namespace");
 

Specified by:

deleteAll in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

namespace - The namespace from which all vectors will be deleted. If not specified the default will be used.

Returns:

A generic type X indicating the result of the delete all operation.

delete

public com.google.common.util.concurrent.ListenableFuture<DeleteResponse> delete(java.util.List<java.lang.String> ids,
                                                                                 boolean deleteAll,
                                                                                 java.lang.String namespace,
                                                                                 com.google.protobuf.Struct filter)

A flexible delete operation allowing for the deletion of vectors by ID, by filter, or all vectors in a namespace.

Example:

     import io.pinecone.proto.DeleteResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<DeleteResponse> listenableFuture =
     asyncIndex.delete(Arrays.asList("v1", "v2", "v3"),false,"example-namespace",null);
 

Specified by:

delete in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

ids - A list of unique identifiers for specific vectors to be deleted. Ignored if deleteAll is true.

deleteAll - A boolean flag indicating whether to delete all vectors in the specified namespace.

namespace - The namespace from which vectors will be deleted. If not specified, the default namespace is used.

filter - An optional Struct defining additional filtering criteria for vectors to be deleted. Ignored if deleteAll is true.

Returns:

A generic type X indicating the result of the delete operation.

describeIndexStats

public com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse> describeIndexStats()

Retrieves statistics about the index's contents, such as vector count per namespace, and number of dimensions.

Example:

     import io.pinecone.proto.DescribeIndexStatsResponse;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<DescribeIndexStatsResponse> listenableFuture = asyncIndex.describeIndexStats();
 

Specified by:

describeIndexStats in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Returns:

A generic type Y that contains the stats about the index.

describeIndexStats

public com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse> describeIndexStats(com.google.protobuf.Struct filter)

Retrieves statistics about the index's contents for vectors that satisfy the applied metadata filter.

Example:

     import io.pinecone.proto.DescribeIndexStatsResponse;
     import com.google.protobuf.Struct;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     Struct filter = Struct.newBuilder()
         .putFields("genre", Value.newBuilder().setStringValue("action").build()).build();
     ListenableFuture<DescribeIndexStatsResponse> listenableFuture = asyncIndex.describeIndexStats();
 

Specified by:

describeIndexStats in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

filter - A metadata filter used to select vectors that satisfy the filter criteria.

Returns:

A generic type Y that contains the stats about the index.

list

public com.google.common.util.concurrent.ListenableFuture<ListResponse> list()

Retrieves up to 100 vector IDs from an index from the default namespace.

Example:

     import io.pinecone.proto.ListResponse;
     import com.google.common.util.concurrent.Futures;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

      ListenableFuture<ListResponse> futureResponse = asyncIndex.list("");
      ListResponse asyncListResponse = Futures.getUnchecked(futureResponse);
  

Specified by:

list in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Returns:

A generic type Y that contains vector IDs.

list

public com.google.common.util.concurrent.ListenableFuture<ListResponse> list(java.lang.String namespace)

Retrieves up to 100 vector IDs from a given namespace.

Example:

     import io.pinecone.proto.ListResponse;
     import com.google.common.util.concurrent.Futures;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

      ListenableFuture<ListResponse> futureResponse = asyncIndex.list("example-namespace");
      ListResponse asyncListResponse = Futures.getUnchecked(futureResponse);
  

Specified by:

list in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

namespace - The namespace that holds the vector IDs you want to retrieve.

Returns:

A generic type Y that contains vector IDs.

list

public com.google.common.util.concurrent.ListenableFuture<ListResponse> list(java.lang.String namespace,
                                                                             int limit,
                                                                             java.lang.String paginationToken)

Retrieves up to n vector IDs from a given namespace, targeted with a specific paginationToken, where limit == n.

Example:

     import io.pinecone.proto.ListResponse;

     ...

     ListenableFuture<ListResponse> futureResponse = asyncIndex.list("example-namespace", 10, "some-pagToken");
     ListResponse asyncListResponse = Futures.getUnchecked(futureResponse);
  

Specified by:

list in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

namespace - The namespace that holds the vector IDs you want to retrieve.

limit - The maximum number of vector IDs to retrieve.

paginationToken - The token to paginate through the list of vector IDs.

Returns:

A generic type Y that contains vector IDs.

list

public com.google.common.util.concurrent.ListenableFuture<ListResponse> list(java.lang.String namespace,
                                                                             int limit)

Retrieves up to n vector IDs from a given namespace, where limit == n.

Example:

     import io.pinecone.proto.ListResponse;
     import com.google.common.util.concurrent.Futures;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

      ListenableFuture<ListResponse> futureResponse = asyncIndex.list("example-namespace", 10);
      ListResponse asyncListResponse = Futures.getUnchecked(futureResponse);
  

Specified by:

list in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

namespace - The namespace that holds the vector IDs you want to retrieve.

limit - The maximum number of vector IDs to retrieve.

Returns:

A generic type Y that contains vector IDs.

list

public com.google.common.util.concurrent.ListenableFuture<ListResponse> list(java.lang.String namespace,
                                                                             java.lang.String prefix)

Retrieves up to 100 vector IDs from a given namespace, filtered by a given prefix.

Example:

     import io.pinecone.proto.ListResponse;
     import com.google.common.util.concurrent.Futures;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<ListResponse> futureResponse = asyncIndex.list("example-namespace", "prefix-");
     ListResponse asyncListResponse = Futures.getUnchecked(futureResponse);
  

Specified by:

list in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

namespace - The namespace that holds the vector IDs you want to retrieve.

Returns:

A generic type Y that contains vector IDs.

list

public com.google.common.util.concurrent.ListenableFuture<ListResponse> list(java.lang.String namespace,
                                                                             java.lang.String prefix,
                                                                             int limit)

Retrieves up to n vector IDs from a given namespace, filtered by a given prefix, where limit` == n.

Example:

     import io.pinecone.proto.ListResponse;
     import com.google.common.util.concurrent.Futures;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<ListResponse> futureResponse = asyncIndex.list("example-namespace", "prefix-", 10);
     ListResponse asyncListResponse = Futures.getUnchecked(futureResponse);
  

Specified by:

list in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

namespace - The namespace that holds the vector IDs you want to retrieve.

prefix - The prefix to filter the vector IDs by.

limit - The maximum number of vector IDs to retrieve.

Returns:

A generic type Y that contains vector IDs.

list

public com.google.common.util.concurrent.ListenableFuture<ListResponse> list(java.lang.String namespace,
                                                                             java.lang.String prefix,
                                                                             java.lang.String paginationToken)

Retrieves up to 100 vector IDs from a given namespace, filtered by a given prefix, targeted with a specific paginationToken.

Example:

     import io.pinecone.proto.ListResponse;
     import com.google.common.util.concurrent.Futures;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<ListResponse> futureResponse = asyncIndex.list("example-namespace", "prefix-", "some-pagToken");
     ListResponse asyncListResponse = Futures.getUnchecked(futureResponse);
  

Specified by:

list in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

namespace - The namespace that holds the vector IDs you want to retrieve.

paginationToken - The token to paginate through the list of vector IDs.

Returns:

A generic type Y that contains vector IDs.

list

public com.google.common.util.concurrent.ListenableFuture<ListResponse> list(java.lang.String namespace,
                                                                             java.lang.String prefix,
                                                                             java.lang.String paginationToken,
                                                                             int limit)

Base method that retrieves a list of vector IDs from a specific namespace within an index.

The method internally constructs a ListRequest using the provided namespace and the provided limit, which cuts off the response after the specified number of IDs. It filters the retrieve IDs to match a provided prefix. It also can accept a pagination token to deterministically paginate through a list of vector IDs. It then makes a synchronous RPC call to fetch the list of vector IDs.

Example:

     import io.pinecone.proto.ListResponse;
     import com.google.common.util.concurrent.Futures;
     import com.google.common.util.concurrent.ListenableFuture;

     ...

     ListenableFuture<ListResponse> futureResponse = asyncIndex.list("example-namespace", "prefix-", "some-pagToken", 10);
     ListResponse asyncListResponse = Futures.getUnchecked(futureResponse);
  

Specified by:

list in interface IndexInterface<com.google.common.util.concurrent.ListenableFuture<UpsertResponse>,com.google.common.util.concurrent.ListenableFuture<QueryResponseWithUnsignedIndices>,com.google.common.util.concurrent.ListenableFuture<FetchResponse>,com.google.common.util.concurrent.ListenableFuture<UpdateResponse>,com.google.common.util.concurrent.ListenableFuture<DeleteResponse>,com.google.common.util.concurrent.ListenableFuture<DescribeIndexStatsResponse>,com.google.common.util.concurrent.ListenableFuture<ListResponse>>

Parameters:

namespace - The namespace that holds the vector IDs you want to retrieve. If namespace is not specified, * the default namespace is used.

prefix - The prefix with which vector IDs must start to be included in the response.

paginationToken - The token to paginate through the list of vector IDs.

limit - The maximum number of vector IDs you want to retrieve.

Returns:

ListResponse containing the list of vector IDs fetched from the specified namespace. The response includes vector IDs up to 100 items.

Throws:

java.lang.RuntimeException - if there are issues processing the request or communicating with the server. This includes network issues, server errors, or serialization issues with the request or response.

close

public void close()

Closes the current index connection gracefully, releasing any resources associated with it. This method should be called when the index instance is no longer needed, to ensure proper cleanup of network connections and other resources. It closes both the connection to the Pinecone service identified by indexName and any internal resources held by the PineconeConnection object.

Specified by:

close in interface java.lang.AutoCloseable