Gremlin查询获取完整父子层级图及节点属性（CosmosDB+Gremlin.NET）

一、直接通过Gremlin查询返回嵌套结构 #

如果你的层级深度在CosmosDB Gremlin API支持范围内（默认最大32层，可调整），可以用递归投影直接生成嵌套格式的结果，返回节点属性和子节点列表：

查询示例（简洁属性版） #

g.V("some_id")
  .project("id", "name", "type", "children")
    .by(id())          // 节点ID
    .by("name")        // 自定义属性：名称
    .by("type")        // 自定义属性：节点类型
    .by(out()
         .repeat(project("id", "name", "type", "children")
                   .by(id())
                   .by("name")
                   .by("type")
                   .by(out().fold()))
         .fold())

查询说明 #

• project 用来定义每个节点要返回的字段，按需添加/删除你的自定义属性；
• out() 表示遍历父到子的边（对应你的父子层级关系，若方向相反用in()）；
• repeat(...) 递归处理所有子节点，fold() 将子节点列表收拢到children字段；
• 如果需要包含所有系统属性和自定义属性，可替换为 valueMap().with(WithOptions.tokens) 替代逐个属性提取，比如：

  g.V("some_id")
    .project("node", "children")
      .by(valueMap().with(WithOptions.tokens))
      .by(out()
           .repeat(project("node", "children")
                     .by(valueMap().with(WithOptions.tokens))
                     .by(out().fold()))
           .fold())
  

二、若递归查询受限，在.NET端构建嵌套结构 #

如果层级过深或Gremlin查询无法满足需求，可先获取所有相关节点的扁平数据，再在代码中组装成嵌套结构：

1. 查询扁平节点数据 #

g.V("some_id")
  .emit()
  .repeat(out())
  .project("id", "properties", "parentId")
    .by(id())
    .by(valueMap().by(unfold()))  // 直接返回属性值而非列表，更简洁
    .by(coalesce(in().id(), constant(null)))  // 根节点parentId为null

2. .NET端代码处理示例 #

假设你用Gremlin.NET获取到的结果是List<Dictionary<string, object>>，可以这样组装：

// 先将所有节点存入字典，方便查找
var nodeDict = nodes.ToDictionary(n => n["id"].ToString(), n => new
{
    Id = n["id"].ToString(),
    Properties = (Dictionary<string, object>)n["properties"],
    Children = new List<object>()
});

// 遍历节点，将子节点挂载到父节点下
foreach (var node in nodes)
{
    var nodeId = node["id"].ToString();
    var parentId = node["parentId"]?.ToString();
    if (!string.IsNullOrEmpty(parentId) && nodeDict.ContainsKey(parentId))
    {
        nodeDict[parentId].Children.Add(nodeDict[nodeId]);
    }
}

// 根节点即为结果
var nestedResult = nodeDict["some_id"];

三、操作步骤 #

1. 测试查询兼容性：先在Azure CosmosDB数据资源管理器的Gremlin控制台执行查询，确认能返回预期结构，排查语法或权限问题；
2. 集成到Gremlin.NET代码：创建GremlinClient连接CosmosDB，提交查询并接收结果；
3. 处理返回结果：若用直接嵌套查询，可直接序列化返回；若用扁平查询，按上述.NET代码组装成嵌套结构；
4. 调整递归深度：若层级超过32层，需在CosmosDB账户设置中调整Gremlin的最大递归深度。

四、你之前查询的问题说明 #

• g.V("some_id").repeat(out()).emit().tree().path()：返回的是Gremlin原生树结构，格式为节点作为键、子节点作为值的嵌套键值对，不符合你需要的属性+子列表格式；
• g.V("some_id").emit().repeat(both().simplePath()).dedup()：返回的是所有相关节点的扁平列表，没有层级关系。

内容的提问来源于stack exchange，提问作者Rahul Anand