Entity 和 Relation 是运行时数据。它们实例化 EntitySet 和 EntitySetLink 定义的对象图。
模型层与运行时层
| 模型定义 | 运行时数据 |
|---|---|
entity_set |
Entity records |
entity_set_link |
Relation records |
data_link |
查询时实体与数据集的绑定 |
storage_link |
查询时数据集与存储的路由 |
写入 Entity
REST：
POST /api/v1/entitystore/{workspace}/entities:write
CLI：
go run ./cmd/umctl --addr http://localhost:8080 entity write demo examples/quickstart-multidomain/sample-data/entities.json
读取：
go run ./cmd/umctl --addr http://localhost:8080 query run demo ".entity with(domain='devops', name='devops.service') | limit 20"
写入 Relation
REST：
POST /api/v1/entitystore/{workspace}/relations:write
CLI：
go run ./cmd/umctl --addr http://localhost:8080 topo write demo examples/quickstart-multidomain/sample-data/relations.json
读取拓扑：
go run ./cmd/umctl --addr http://localhost:8080 query run demo ".topo | graph-call getDirectRelations([(:\"devops@devops.service\" {__entity_id__: '10000000000000000000000000000101'})]) | limit 20"
Visibility
EntityStore 支持 write、expire 和 delete-style 操作。本地查询默认隐藏 expired/deleted records，provider 保留历史后支持 time-aware 查询。
Identity
运行时记录需要稳定 entity IDs。UModel 在 topology calls 和 provider storage 中使用经过校验的 entity identifiers。示例 ID 保持确定，教程和测试即可直接复制运行。
设计规则
- 先导入模型定义，再写运行时数据。
- Entity 字段要和 EntitySet 定义一致。
- Relation 类型要和 EntitySetLink 语义一致。
- 使用
.entity找到 ID，再使用.topo做拓扑查询。 - 样例数据应足够小，便于人工检查，同时也要足够丰富，能展示拓扑。