Reads one node by id, returning its properties, declared object type, entity binding, and last-write commit coordinates. A removed or never-written node reads back as no data. Accepts as_of for time travel.
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 node’s properties, or nothing if absent.
CLI
$ strata graph create social
$ strata graph add-node social alice --object-type person --properties {"age":30}
$ strata graph get-node social alice
$ strata graph get-node social absent
Wire
{"graph":"social","type":"graph_create"}
{"graph":"social","node_id":"alice","object_type":"person","properties":{"age":30},"type":"graph_add_node"}
{"graph":"social","node_id":"alice","type":"graph_get_node"}
{"graph":"social","node_id":"absent","type":"graph_get_node"}
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
as_of | integer | no | Optional timestamp in microseconds. Reads the graph state visible at that instant. |
graph | string | yes | Graph name. |
node_id | string | yes | Node id. |
Plus the optional scope: branch and space (default to the session branch and the "default" space).
Returns
Maybe<GraphNodeDataOutput> — a miss returns nothing rather than raising.
Errors
failed_precondition.engine.runtime_closednot_found.engine.branchinvalid_argument.engine.product_spaceinvalid_argument.engine.graph_namenot_found.engine.graphinvalid_argument.engine.graph_node_id
Invocation
- CLI:
strata graph get-node - Wire type:
graph_get_node