mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-11 23:49:35 +00:00
137 lines
4.5 KiB
Text
137 lines
4.5 KiB
Text
NAME
|
|
gcloud beta vector-search collections data-objects create - create a data
|
|
object
|
|
|
|
SYNOPSIS
|
|
gcloud beta vector-search collections data-objects create
|
|
(DATA_OBJECT : --collection=COLLECTION --location=LOCATION)
|
|
[--data=DATA] [--etag=ETAG] [--vectors=[VECTORS,...]]
|
|
[GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
(BETA) Create a data object.
|
|
|
|
EXAMPLES
|
|
To create a data object my-do-1 in collection my-collection, project
|
|
my-project and location us-central1, run:
|
|
|
|
$ gcloud beta vector-search collections data-objects create \
|
|
my-do-1 --collection=my-collection --location=us-central1 \
|
|
--data='{"director":"Frank
|
|
Darabont","genre":"Drama","title":"The Shawshank
|
|
Redemption","year":1994}' \
|
|
--vectors='{"genre_embedding":{"dense":{"values":[0.4,0.5,0.6,0.\
|
|
7]}},"plot_embedding":{"dense":{"values":[0.1,0.2,0.3]}},"sparse_emb\
|
|
edding":{"sparse":{"indices":[1,5,10],"values":[0.1,0.5,0.21]}}}' \
|
|
--project=my-project
|
|
|
|
POSITIONAL ARGUMENTS
|
|
DataObject resource - Identifier. The fully qualified resource name of the
|
|
dataObject.
|
|
|
|
Format:
|
|
projects/{project}/locations/{location}/collections/{collection}/dataObjects/{data_object_id}
|
|
The data_object_id must be 1-63 characters long, and comply with RFC1035
|
|
(https://www.ietf.org/rfc/rfc1035.txt). The arguments in this group can be
|
|
used to specify the attributes of this resource. (NOTE) Some attributes
|
|
are not given arguments in this group but can be set in other ways.
|
|
|
|
To set the project attribute:
|
|
◆ provide the argument data_object on the command line with a fully
|
|
specified name;
|
|
◆ provide the argument --project on the command line;
|
|
◆ set the property core/project.
|
|
|
|
This must be specified.
|
|
|
|
DATA_OBJECT
|
|
ID of the dataObject or fully qualified identifier for the
|
|
dataObject.
|
|
|
|
To set the data_object attribute:
|
|
▸ provide the argument data_object on the command line.
|
|
|
|
This positional argument must be specified if any of the other
|
|
arguments in this group are specified.
|
|
|
|
--collection=COLLECTION
|
|
The collection id of the dataObject resource.
|
|
|
|
To set the collection attribute:
|
|
▸ provide the argument data_object on the command line with a fully
|
|
specified name;
|
|
▸ provide the argument --collection on the command line.
|
|
|
|
--location=LOCATION
|
|
The location id of the dataObject resource.
|
|
|
|
To set the location attribute:
|
|
▸ provide the argument data_object on the command line with a fully
|
|
specified name;
|
|
▸ provide the argument --location on the command line.
|
|
|
|
FLAGS
|
|
--data=DATA
|
|
The data of the dataObject.
|
|
|
|
--etag=ETAG
|
|
The etag of the dataObject.
|
|
|
|
--vectors=[VECTORS,...]
|
|
The vectors of the dataObject.
|
|
|
|
KEY
|
|
Sets KEY value.
|
|
|
|
VALUE
|
|
Sets VALUE value.
|
|
|
|
dense
|
|
A dense vector.
|
|
|
|
values
|
|
The values of the vector.
|
|
|
|
sparse
|
|
A sparse vector.
|
|
|
|
indices
|
|
The corresponding indices for the values.
|
|
|
|
values
|
|
The values of the vector.
|
|
|
|
values
|
|
Deprecated: Use dense or sparse instead.
|
|
|
|
Shorthand Example:
|
|
|
|
--vectors=string={dense={values=[float]},sparse={indices=[int],values=[float]},values=[float]}
|
|
|
|
JSON Example:
|
|
|
|
--vectors='{"string": {"dense": {"values": [float]}, "sparse": {"indices": [int], "values": [float]}, "values": [float]}}'
|
|
|
|
File Example:
|
|
|
|
--vectors=path_to_file.(yaml|json)
|
|
|
|
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.
|
|
|
|
API REFERENCE
|
|
This command uses the vectorsearch/v1beta API. The full documentation for
|
|
this API can be found at:
|
|
https://docs.cloud.google.com/vertex-ai/docs/vector-search-2/overview
|
|
|
|
NOTES
|
|
This command is currently in beta and might change without notice. This
|
|
variant is also available:
|
|
|
|
$ gcloud vector-search collections data-objects create
|
|
|