graph
edge.remove
Remove a graph edge.
strata graph remove-edgedb.graphs.remove_edge(graph: 'str', src: 'str', edge_type: 'str', dst: 'str') -> 'Any'wire graph_remove_edge
Removes one directed edge by its `(src, edge_type, dst)` triple. The endpoints are untouched. Removing an edge that does not exist is not an error: the acknowledgement reports `deleted: false`.
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 graph remove-edge --helphelp(db.graphs.remove_edge)
Example
Remove an edge.
strata graph create socialcreated graph socialstrata graph add-node social alicecreated node alice in socialstrata graph add-node social bobcreated node bob in socialstrata graph add-edge social alice knows bobcreated edge alice -[knows]-> bob in socialstrata graph remove-edge social alice knows bobdeleted edge alice -[knows]-> bob in socialstrata graph get-edge social alice knows bob(nil)
_ = db.graphs.create("social")_ = db.graphs.add_node("social", "alice")_ = db.graphs.add_node("social", "bob")_ = db.graphs.add_edge("social", "alice", "knows", "bob")_ = db.graphs.remove_edge("social", "alice", "knows", "bob")db.graphs.get_edge("social", "alice", "knows", "bob") is None
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| dst | string | yes | Destination node id. |
| edge_type | string | yes | Edge type. |
| graph | string | yes | Graph name. |
| src | string | yes | Source node id. |
| 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
- 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.graph_name | never | not_started |
| not_found.engine.graph | never | not_applicable |
| invalid_argument.engine.graph_node_id | never | not_started |
| invalid_argument.engine.graph_edge_type | never | not_started |