建立图模型
把实体映射为节点,把关联映射为有向边,发布后团队即可查询。
定义节点和边的键
为每个节点标签选择稳定的行标识。如果账号 ID 在不同租户中重复,将租户 ID 纳入复合键。边的起点和终点列必须按相同顺序对应完整的节点键。
下面的映射片段使用 PostgreSQL 中的账户表和 Parquet 中的转账表。查询可返回 amount 和 event_time,也可用它们做过滤。
YAML
nodes:
Account:
source: crm.public.accounts
key: [tenant_id, account_id]
properties: [status]
edges:
Transfer:
source: lake.finance.transfers
key: [tenant_id, transfer_id]
from: {node: Account, columns: [tenant_id, from_account_id]}
to: {node: Account, columns: [tenant_id, to_account_id]}
properties: [amount, event_time]在完整示例中查看数据源定义,并按实际环境替换连接设置。
保存、校验并发布
- 在图模型(Graph Models)中创建模型,添加数据源后配置节点标签和边类型。
- 保存草稿并校验。如果发现列缺失、类型不匹配、键重复或边端点无法解析,检查来源表和键映射。
- 准备好后发布草稿,用查询(Query)在生效版本上运行一条结果已知的小查询。
管理模型版本
编辑草稿时,查询仍使用已发布的版本。有发布权限的用户可在版本历史比较变更、回退到归档版本或将模型下线。模型回退会切换映射。需要恢复源数据时,请使用独立的数据快照。
多表映射、过滤及业务时间规则见模型参考。