Interface Aggregate<T>

interface Aggregate<T> {
    groupBy: AggregateGroupBy<T>;
    nearImage<M>(image, opts?): Promise<AggregateResult<T, M>>;
    nearObject<M>(id, opts?): Promise<AggregateResult<T, M>>;
    nearText<M>(query, opts?): Promise<AggregateResult<T, M>>;
    nearVector<M>(vector, opts?): Promise<AggregateResult<T, M>>;
    overAll<M>(opts?): Promise<AggregateResult<T, M>>;
}

Type Parameters

  • T

Properties

This namespace contains methods perform a group by search while aggregating metrics.

Methods

  • Aggregate metrics over the objects returned by a near image vector search on this collection.

    At least one of certainty, distance, or object_limit must be specified here for the vector search.

    This method requires a vectorizer capable of handling base64-encoded images, e.g. img2vec-neural, multi2vec-clip, and multi2vec-bind.

    Type Parameters

    Parameters

    • image: string | Buffer

      The image to search on. This can be a base64 string, a file path string, or a buffer.

    • Optional opts: AggregateNearOptions<T, M>

      The options for the request.

    Returns Promise<AggregateResult<T, M>>

    The aggregated metrics for the objects returned by the vector search.

  • Aggregate metrics over the objects returned by a near object search on this collection.

    At least one of certainty, distance, or object_limit must be specified here for the vector search.

    This method requires that the objects in the collection have associated vectors.

    Type Parameters

    Parameters

    • id: string

      The ID of the object to search for.

    • Optional opts: AggregateNearOptions<T, M>

      The options for the request.

    Returns Promise<AggregateResult<T, M>>

    The aggregated metrics for the objects returned by the vector search.

  • Aggregate metrics over the objects returned by a near vector search on this collection.

    At least one of certainty, distance, or object_limit must be specified here for the vector search.

    This method requires that the objects in the collection have associated vectors.

    Type Parameters

    Parameters

    • query: string | string[]

      The text query to search for.

    • Optional opts: AggregateNearOptions<T, M>

      The options for the request.

    Returns Promise<AggregateResult<T, M>>

    The aggregated metrics for the objects returned by the vector search.

  • Aggregate metrics over the objects returned by a near vector search on this collection.

    At least one of certainty, distance, or object_limit must be specified here for the vector search.

    This method requires that the objects in the collection have associated vectors.

    Type Parameters

    Parameters

    • vector: number[]

      The vector to search for.

    • Optional opts: AggregateNearOptions<T, M>

      The options for the request.

    Returns Promise<AggregateResult<T, M>>

    The aggregated metrics for the objects returned by the vector search.