graph
ontology.freeze
Freeze the graph ontology.
strata graph ontology freezedb.graphs.ontology.freeze(graph: 'str') -> 'Any'wire graph_freeze_ontology
Validates the draft ontology and freezes it. Validation requires at least one declared type and rejects link types whose source or target reference undeclared object types (`failed_precondition.engine.graph_ontology_freeze`). After freezing, writes enforce declared node object types, required properties, and link-type endpoint rules; the ontology itself can no longer change (`failed_precondition.engine.graph_ontology_frozen`).
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 ontology freeze --helphelp(db.graphs.ontology.freeze)
Example
Freeze the ontology so its types can no longer change.
strata graph create gcreated graph gstrata graph ontology define-object-type g personcreated object type person in gstrata graph ontology freeze gfroze ontology of g (1 object type, 0 link types)strata graph ontology get ggraph gstatus frozenversion …object_types NAME PROPERTIES person -link_types -
_ = db.graphs.create("g")_ = db.graphs.ontology.define_object_type("g", "person")_ = db.graphs.ontology.freeze("g")db.graphs.ontology.get("g").status
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| graph | string | yes | Graph name. |
| 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 |
| failed_precondition.engine.graph_ontology_freeze | never | not_started |
| failed_precondition.engine.graph_ontology_frozen | never | not_started |