mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-14 17:05:28 +00:00
99 lines
3.5 KiB
Text
99 lines
3.5 KiB
Text
NAME
|
|
gcloud vector-search collections data-objects batch-search - batch search
|
|
data objects from a Vector Search collection
|
|
|
|
SYNOPSIS
|
|
gcloud 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
|
|
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 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 variant is also available:
|
|
|
|
$ gcloud beta vector-search collections data-objects batch-search
|
|
|