Nebular 节点查询

在大规模图数据库nebula中，如何查询节点属性，并列举10个节点数据，同时避免爆内存.

下面给你一份 Nebula Graph 专用 的“查节点属性 + 只取 10 条 + 不爆内存”做法，拿去即用。

结论先行（推荐姿势）

1. 用 LOOKUP 走属性索引 缩小候选，再 LIMIT 10 提前限流。
2. 只 YIELD 必要字段；若需要完整点属性，再把 VID 管道到 FETCH PROP ON。
3. 务必有索引（没索引会退化为扫描）。MATCH 能写，但通常不如 LOOKUP 直接、可推下限流。(docs.nebula-graph.io)

---

一键可跑的 nGQL 模板

0) 建索引（只示例，按你的 Tag/属性改名）

-- 在当前图空间
CREATE TAG INDEX IF NOT EXISTS idx_user_name ON User(name);
CREATE TAG INDEX IF NOT EXISTS idx_user_age  ON User(age);
REBUILD TAG INDEX idx_user_name;
REBUILD TAG INDEX idx_user_age;

说明：LOOKUP 依赖索引；不建索引就无法按属性高效定位顶点。(docs.nebula-graph.io)

1) 精确/范围查询：列举 10 个点 + 只取必要字段

-- 精确属性匹配（只取 VID、name、age）
LOOKUP ON User WHERE User.name == "Alice"
YIELD id(vertex) AS vid, User.name AS name, User.age AS age
| LIMIT 10;

-- 范围过滤（age ∈ [18, 30)），同样只取必要字段
LOOKUP ON User WHERE User.age >= 18 AND User.age < 30
YIELD id(vertex) AS vid, User.name AS name, User.age AS age
| LIMIT 10;

LOOKUP 基于索引执行，可把 LIMIT 推到存储层，减少传输与内存占用。(docs.nebula-graph.io)

2) 若需要完整属性：先找 VID，再 FETCH（仍只 10 个）

-- 第一步：按属性命中索引并限流 10 个 VID
LOOKUP ON User WHERE User.age >= 18 AND User.age < 30
YIELD id(vertex) AS vid
| LIMIT 10
-- 第二步：用 VID 取该 Tag 的所有/指定属性（按需 YIELD）
| FETCH PROP ON User $-.vid
YIELD properties(vertex) AS props;

或指定属性：

| FETCH PROP ON User $-.vid
YIELD User.name AS name, User.age AS age;

FETCH PROP ON 用 VID 直取属性，适合在拿到小批 VID 后获取所需字段。(docs.nebula-graph.io)

3) 需要“模糊/前缀/通配”搜索名字？

先配置 全文索引（ES + Listener），再用 LOOKUP ... WHERE FUZZY()/PREFIX() 等：

LOOKUP ON User
WHERE FUZZY(User.name, "Alce", AUTO, OR)   -- 模糊匹配
YIELD id(vertex) AS vid, User.name AS name
| LIMIT 10;

Nebula 的全文索引支持 prefix/wildcard/regexp/fuzzy 等，需要外部 ES 与 Listener。(docs.nebula-graph.io)

---

为什么不直接用 MATCH？

MATCH (v:User) WHERE v.age>=18 AND v.age<30 RETURN id(v), v.name, v.age LIMIT 10; 语法可行，但常见优化建议是优先用 LOOKUP/GO 做起点过滤与遍历，命中索引且容易把 LIMIT 推下去，减少扫描量与内存占用。(docs.nebula-graph.io)

---

防“爆内存”清单（服务端 + 客户端）

• 服务端

  • 用 LOOKUP 命中索引 + 把 LIMIT 放在最前链路（示例中就在第一步）。这能让结果在存储层就截断。(docs.nebula-graph.io)
  • 升级到含 Memory Tracker 的版本并配置阈值，防止 OOM 影响 graphd/storaged。(NebulaGraph)

• 客户端

  • 驱动侧不要把大结果一次性 list() 全部拉回；示例已经在服务端 LIMIT 10，客户端只需迭代结果集即可。
  • 仅请求需要的列（如上 YIELD vid, name, age），避免把整个点/边的所有属性都取回。

• 查询层

  • 需要更多字段时，用 “LOOKUP → FETCH”两段法，而不是一次把海量属性搬回。
  • 如果还要继续遍历边，再基于这 10 个起点用 GO 扩展，而不是对全图做 MATCH。(docs.nebula-graph.io)

---

小贴士

• 首次建好索引后记得 REBUILD TAG INDEX 才能被查询使用。(docs.nebula-graph.io)
• 全文检索前请确认 ES 与 Listener 已部署并同步。(docs.nebula-graph.io)

需要我把上述模板改成你 具体的 Tag/属性名（比如 Person(name, age, city)），或给你 Python/Java 驱动 的最小示例吗？我可以直接按你的表结构改好。