gcloud beta vector-search collections data-objects batch-search

NAME
gcloud beta vector-search collections data-objects batch-search - batch search data objects from a Vector Search collection
SYNOPSIS
gcloud beta vector-search collections data-objects batch-search --collection=COLLECTION --location=LOCATION --searches-from-file=SEARCHES_FROM_FILE [[--rrf-weights=[WEIGHT,…] : --combine-output-data-fields=[DATA_OUTPUT_FIELD,…] --combine-output-metadata-fields=[METADATA_OUTPUT_FIELD,…] --combine-output-vector-fields=[VECTOR_OUTPUT_FIELD,…] --combine-top-k=COMBINE_TOP_K]] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA) Batch search data objects from a Vector Search collection. Searches can be specified in a JSON file via --searches-from-file.
EXAMPLES
To batch search data objects from collection my-collection in location us-central1 using searches defined in searches.json, run: 
gcloud beta vector-search collections data-objects batch-search --collection=my-collection --location=us-central1 --searches-from-file=searches.json

Example searches.json: 

[
  {
    "semanticSearch": {
      "searchText": "sci-fi movie",
      "searchField": "vector1",
      "topK": 10
    }
  },
  {
    "vectorSearch": {
      "searchField": "vector2",
      "topK": 5,
      "vector": { "values": [0.1, 0.2, 0.3] }
    }
  }
]
REQUIRED FLAGS
--collection=COLLECTION
The collection to batch search data objects from.
--location=LOCATION
Location of the collection.
--searches-from-file=SEARCHES_FROM_FILE
Path to a JSON file containing a list of searches. Each element in list should be a JSON object representing a Search message, e.g., {"semanticSearch": {"searchText": "…", "searchField": "…"}}. Keys must be camelCase as in API definition. Example file content: 
[
  {
    "vectorSearch": {
      "vector": {
        "values": [
          1,
          2,
          3,
          4
        ]
      },
      "searchField": "genre_embedding",
      "topK": 10,
      "outputFields": {
        "dataFields": [
          "director",
          "genre",
          "title",
          "year"
        ]
      }
    }
  },
  {
    "semanticSearch": {
      "searchText": "sci-fi movie",
      "searchField": "plot_embedding",
      "taskType": "SEMANTIC_SIMILARITY",
      "topK": 10
    }
  },
  {
    "textSearch": {
      "searchText": "movie 1",
      "dataFieldNames": ["title"],
      "topK": 10
    }
  }
]
OPTIONAL FLAGS
Combine Results Options
Ranker

This must be specified.

RRF Ranker
--rrf-weights=[WEIGHT,…]
RRF weights for combining results.
--combine-output-data-fields=[DATA_OUTPUT_FIELD,…]
List of data fields to include in combined output.
--combine-output-metadata-fields=[METADATA_OUTPUT_FIELD,…]
List of metadata fields to include in combined output.
--combine-output-vector-fields=[VECTOR_OUTPUT_FIELD,…]
List of vector fields to include in combined output.
--combine-top-k=COMBINE_TOP_K
Top K results to return when combining results.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES
This command is currently in beta and might change without notice. This variant is also available: 
gcloud vector-search collections data-objects batch-search