vector
history
Read retained vector history for one key.
strata vector historydb.vectors.history(collection: 'str', key: 'str') -> 'Optional[list]'wire vector_history
Returns retained history rows for one vector key, including vector revision facts and tombstones when present.
Optional reads distinguish present data from missing data. When version or timestamp facts exist on the executor output, SDK mappings should preserve them.
To see the complete help for this command, run:
strata vector history --helphelp(db.vectors.history)
Example
A key that never existed has no history.
strata vector collection create docs 3 --metric cosinestrata vector history docs absent
_ = db.vectors.create_collection("docs", 3, metric="cosine")db.vectors.history("docs", "absent") is None
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| collection | string | yes | Collection name. |
| key | string | yes | Vector key. |
| branch | string or null | no | Target branch. Defaults to the executor handle branch. |
| space | string or null | no | Target product space. Defaults to `"default"`. |
Returns
Maybe<Vec<VectorHistoryItem>>
- dataany
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| invalid_argument.engine.product_space | never | not_started |
| invalid_argument.engine.vector_collection | never | not_started |
| invalid_argument.engine.vector_key | never | not_started |
| not_found.engine.vector_collection | never | not_applicable |