Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Data GClasses

Time-series, graph database, and resource persistence.

Source: kernel/c/root-linux/src/c_tranger.c, c_treedb.c, c_node.c, c_resource2.c


C_TRANGER

Time-range database manager — wraps timeranger2 for CRUD operations on time-series topics.

PropertyValue
StatesST_STOPPED, ST_IDLE

Commands

CommandDescription
topicsList all topics.
create-topicCreate a new topic.
open-topicOpen an existing topic.
delete-topicDelete a topic.
open-list / close-listOpen or close a record list (one-shot snapshot with return_data=1, else a live list collecting realtime appends).
get-list-dataRetrieve an open list’s data.
list-keysList a topic’s keys with their record counts ([{key, records}]).
open-iterator / close-iteratorOpen/close a stateful per-key iterator (row index only, no upfront load) for cursor pagination.
get-pageGet a page {total_rows, pages, data} from an open iterator (from_rowid 1-based, limit, optional backward).
open-rt / close-rtOpen/close a realtime feed on a topic key (no history load); new appends are published as EV_TRANGER_RECORD_ADDED to subscribers.
add-recordAppend a record.
print-trangerDump tranger state.
descDescribe topic schema.

C_TREEDB

Hierarchical tree database manager — manages TreeDB instances on top of timeranger with JSON schema support.

PropertyValue
StatesST_STOPPED, ST_IDLE

Key attributes

AttributeTypeDescription
pathstringStorage path.
filename_maskstringFilename pattern.
masterboolTRUE for master, FALSE for read-only replica.
exit_on_errorboolExit on schema errors.

Commands

CommandDescription
open-treedb / close-treedbOpen or close a treedb instance.
delete-treedbDelete a treedb and its data.
create-topic / delete-topicManage topics within a treedb.

C_NODE

Node resource interface for TreeDB — full CRUD and graph operations on tree nodes with linking, snapshots, and import/export.

PropertyValue
StatesST_STOPPED, ST_IDLE

Commands

CommandDescription
create-node / update-node / delete-nodeCRUD operations on nodes.
get-node / list-nodesRetrieve nodes.
link-nodes / unlink-nodesManage parent-child relationships.
parents / childrenNavigate the graph.
hooks / linksInspect hook and fkey relationships.
jtreeGet a node’s full subtree as JSON.
shoot-snap / activate-snap / deactivate-snapSnapshot management.
list-snaps / snap-contentInspect snapshots.
import-db / export-dbBulk import/export.
descDescribe topic schema.

C_RESOURCE2

Simple resource persistence — stores each resource as a flat JSON file.

PropertyValue
StatesST_STOPPED, ST_IDLE

Key attributes

AttributeTypeDescription
strictboolEnable schema validation.
json_descjsonResource schema descriptor.
persistentboolPersist to disk.
servicestringService name.
databasestringDatabase name.