构建第一个图
用已安装的 Linux 命令行和两个小文件,把账户和转账映射成图,并核对查询结果。
1. 获取样例文件
先完成Linux 安装。本例将三个文件放在同一个目录,无需准备数据库。
- accounts.csv 包含 Alice、Bob、Carol 三个账户。
- transfers.jsonl 包含两笔有方向的转账。
- graph.yaml 将文件定义为一个节点标签与一个关系类型。
Shell
demo_dir=$(mktemp -d)
cd "$demo_dir"
demo_base=https://graphlake-docs.pages.dev/assets/examples/transfer
curl -fLO "$demo_base/graph.yaml"
curl -fLO "$demo_base/accounts.csv"
curl -fLO "$demo_base/transfers.jsonl"2. 读懂映射
files 按 graph.yaml 所在目录解析。业务键和端点声明为 Int64,金额用 Decimal128(18, 2)。CSV 列的声明顺序与表头一致。
查看完整 graph.yaml
YAML
graph: text-files
sources:
people:
type: csv
tables:
accounts:
files: [accounts.csv]
columns:
- {name: id, data_type: Int64, nullable: false}
- {name: name, data_type: Utf8}
payments:
type: jsonl
tables:
transfers:
files: [transfers.jsonl]
columns:
- {name: id, data_type: Int64, nullable: false}
- {name: src, data_type: Int64}
- {name: dst, data_type: Int64}
- {name: amount, data_type: 'Decimal128(18, 2)'}
nodes:
Account: {source: people.accounts, key: [id], properties: [name]}
edges:
Transfer:
source: payments.transfers
key: [id]
from: {node: Account, columns: [src]}
to: {node: Account, columns: [dst]}
properties: [amount]src 和 dst 都指向 Account.id。转账本身的 id 标识这条边。同一对账户可以有多条边,只要每笔转账的 ID 不同。
3. 核对已知结果
在样例目录中查询账户 1 的转出记录。将账户 ID 作为参数,方便复用同一查询。
Shell
/opt/graphlake/current/bin/graphlake --catalog graph.yaml query \
--parameters '{"account_id":1}' \
'MATCH (a:Account)-[t:Transfer]->(b:Account)
WHERE a.id = $account_id
RETURN a.name AS sender, b.name AS recipient, t.amount AS amount
ORDER BY t.id'预期结果 Alice 向 Bob 转了 12.25。把 account_id 改成 3,应看到 Carol 没有转出记录。
成功后,继续用这套数据运行查询示例。
4. 在控制台查看模型
继续在同一个终端中,把样例目录用作独立 catalog。初始化一次管理员密码,再将安装包自带的控制台启动在 7347 端口。
Shell
/opt/graphlake/current/bin/graphlake-admin --catalog-dir "$demo_dir" auth init
/opt/graphlake/current/bin/graphlake-admin --catalog-dir "$demo_dir" \
--assets-dir /opt/graphlake/current/web --port 7347- 打开 http://127.0.0.1:7347,以
admin登录。服务在远程主机时,通过 SSH 转发7347端口。 - 在图模型中确认
graph已发布。打开查询,粘贴前面的 Cypher,在查询选项中填入{"account_id":1}。
换成实际输入时,从连接数据开始。先核对键的类型和样例行,再发布生产映射。