核心概念

理解图模型如何映射数据、发布后何时生效,以及一次查询读取的是哪一份数据。

本页目录

来源、表与图模型

数据源是 GraphLake 可读取的连接或文件集合。表是来源中具名的输入。图模型将一个或多个输入表中的行映射成节点和有向关系。

例如,PostgreSQL 的账户表定义 Account 节点,Parquet 中的转账表定义 Transfer 边。边的来源列和目标列引用账户的业务键,把两份数据连接起来。

需要直接查询时参见连接数据,需要定时刷新 Parquet 副本时参见本地表与同步。

键、端点和属性

节点标签
用于区分节点类型,例如 Account。业务键在同一标签内标识一个节点。
关系类型
用于区分有向连接,例如 Transfer。起点和终点列按顺序对应两端节点的完整业务键。
属性
用于展示、筛选和汇总的映射列,例如 amount。不同转账号能区分同一对账户间的多笔转账。

账号 ID 在各租户间重复时,使用 [tenant_id, account_id] 这样的复合键。边的两端都应包含租户列,类型也要一致。可在第一个图模型中试用这套映射方法。

草稿、已发布版本与数据新鲜度

草稿用于编辑和校验。发布后,客户端才能查询生效版本。响应会记录模型版本和来源信息。回退仅切换已发布的映射,源数据仍由来源系统管理。

本地表读取最近成功发布的副本。CSR 索引对应构建时的图范围和来源状态。查询需要最新数据时,先核对本地表和 CSR 的新鲜度,再选择执行范围。

发布步骤见建立图模型,CSR 的使用见图算法。