vector
collection.delete
Delete a vector collection.
strata vector collection deletedb.vectors.delete_collection(name: 'str') -> 'Any'wire vector_delete_collection
Deletes the selected vector collection from the current branch and space. The current wire response is a transitional boolean status.
Successful mutations return an acknowledgement of the outcome: for a state-changing write, the affected target with the mutation effect and commit facts; for mutations that produce a domain result (such as a branch or a promotion outcome), that result object.
To see the complete help for this command, run:
strata vector collection delete --helphelp(db.vectors.delete_collection)
Example
Delete a collection.
strata vector collection create temp 3 --metric cosinecreated collection temp (3 dimensions, cosine)strata vector collection delete tempdeleted collection tempstrata vector collection list(empty)
_ = db.vectors.create_collection("temp", 3, metric="cosine")_ = db.vectors.delete_collection("temp")[c.name for c in db.vectors.list_collections()]
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| collection | string | yes | Collection name. |
| branch | string or null | no | Target branch. Defaults to the executor handle branch. |
| force | boolean | no | Delete the collection's vectors before dropping it. A populated collection is refused without this. |
| space | string or null | no | Target product space. Defaults to `"default"`. |
Returns
MutationAck
- databoolean
- 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 |
| failed_precondition.engine.vector_collection_not_empty | never | not_started |