构建第一个图

用已安装的 Linux 命令行和两个小文件,把账户和转账映射成图,并核对查询结果。

本页目录

1. 获取样例文件

先完成Linux 安装。本例将三个文件放在同一个目录,无需准备数据库。

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
  1. 打开 http://127.0.0.1:7347,以 admin 登录。服务在远程主机时,通过 SSH 转发 7347 端口。
  2. 在图模型中确认 graph 已发布。打开查询,粘贴前面的 Cypher,在查询选项中填入 {"account_id":1}。

换成实际输入时,从连接数据开始。先核对键的类型和样例行,再发布生产映射。