Reads one visible vector entry. The optional timestamp reads the vector visible at that point in time when retained history allows it.

Optional reads distinguish present data from missing data. When version or timestamp facts exist on the executor output, SDK mappings should preserve them.

Examples

Read a stored vector, or nothing if the key is absent.

CLI

$ strata vector collection create docs 3 cosine
$ strata vector upsert docs a [1.0,0.0,0.0]
$ strata vector get docs a
$ strata vector get docs absent

Wire

{"collection":"docs","dimension":3,"metric":"cosine","type":"vector_create_collection"}
{"collection":"docs","key":"a","type":"vector_upsert","vector":[1.0,0.0,0.0]}
{"collection":"docs","key":"a","type":"vector_get"}
{"collection":"docs","key":"absent","type":"vector_get"}

Parameters

Name	Type	Required	Description
as_of	integer	no	Optional timestamp in microseconds.
collection	string	yes	Collection name.
key	string	yes	Vector key.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

Maybe<VectorVersionedData> — a miss returns nothing rather than raising.

Errors

• failed_precondition.engine.runtime_closed
• not_found.engine.branch
• invalid_argument.engine.product_space
• invalid_argument.engine.vector_collection
• invalid_argument.engine.vector_key
• not_found.engine.vector_collection

Invocation

• CLI: strata vector get
• Wire type: vector_get