vector
delete_by_filter
Delete vectors matching a metadata filter.
strata vector delete-by-filterdb.vectors.delete_by_filter(collection: 'str', filter: 'Any') -> 'Any'wire vector_delete_by_filter
Scans the collection for visible vectors matching the metadata filter and deletes the matching rows as a bulk mutation.
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 delete-by-filter --helphelp(db.vectors.delete_by_filter)
Example
Delete every vector whose metadata matches a filter.
strata vector collection create docs 3 --metric cosinestrata vector upsert docs a [1.0,0.0,0.0] --metadata {"tag":"keep"}strata vector upsert docs b [0.0,1.0,0.0] --metadata {"tag":"drop"}strata vector delete-by-filter docs --filter {"conditions":[{"field":"tag","op":"eq","value":{"type":"string","value":"drop"}}]}strata vector count docs
_ = db.vectors.create_collection("docs", 3, metric="cosine")_ = db.vectors.upsert("docs", "a", [1.0, 0.0, 0.0], metadata={"tag": "keep"})_ = db.vectors.upsert("docs", "b", [0.0, 1.0, 0.0], metadata={"tag": "drop"})_ = db.vectors.delete_by_filter("docs", stratadb.filters.eq("tag", "drop"))db.vectors.count("docs")
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| collection | string | yes | Collection name. |
| filter | VectorMetadataFilter | yes | Metadata filter. |
| 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
MutationAck<VectorBulkDelete>
- dataobject
- 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 |
| invalid_argument.engine.vector_filter | never | not_started |