Cosmos DB Graph API：Gremlin查询边存在性检查与更新方法

我来帮你梳理下Cosmos DB Graph API里关于边的存在性检查、预检查创建，以及直接更新的常用操作，都是实际开发中常用的Gremlin写法，直接就能套用：

一、检查边是否存在并更新 #

要更新一条边，首先得精准定位到它——通常是通过两端顶点的标识（ID或属性）加上边的标签来筛选。找到后直接用property就能更新，不用删了重建。

举个例子：假设我们有person类型的顶点，标签为knows的边表示好友关系。现在要找到Alice到Bob的knows边，把它的weight（亲密度）属性更新为0.8：

// 方式1：通过顶点属性匹配
g.V().has('person', 'name', 'Alice').outE('knows')
  .where(inV().has('person', 'name', 'Bob'))
  .property('weight', 0.8)

// 方式2：直接用顶点ID（更高效）
g.V('alice-vertex-id').outE('knows')
  .where(inV().hasId('bob-vertex-id'))
  .property('weight', 0.8)

如果这条边不存在，查询不会执行任何更新操作，也不会报错——完全安全。

二、创建边前先检查是否已存在 #

如果想避免重复创建同一条边，用Gremlin的coalesce方法就可以实现“存在则跳过，不存在则创建”的逻辑，这是Graph数据库里的经典模式。

还是用Alice和Bob的例子：只有当他俩之间没有knows边时，才创建这条边并设置初始亲密度0.5：

g.V('alice-vertex-id').as('source')
  .V('bob-vertex-id').as('target')
  .coalesce(
    // 先检查边是否存在：从target找指向source的knows边（反向匹配）
    __.inE('knows').where(outV().as('source')),
    // 如果不存在，就创建这条边
    __.addE('knows').from('source').to('target').property('weight', 0.5)
  )

coalesce会优先执行第一个参数的查询，如果能找到边就直接返回它；找不到的话才执行第二个参数的创建操作，完美避免重复。

如果你更习惯正向检查，也可以这么写：

g.V('alice-vertex-id').as('source')
  .V('bob-vertex-id').as('target')
  // 用not判断：source没有指向target的knows边时，才执行创建
  .not(outE('knows').where(inV().as('target')))
  .addE('knows').from('source').to('target').property('weight', 0.5)

三、直接更新现有边（无需删除重建） #

其实前面的更新操作已经是直接修改了——Gremlin的property方法就是专门用来更新边（或顶点）属性的，完全不需要先删除再重建。

比如要同时更新边的多个属性，比如亲密度和最后更新时间：

g.V('alice-vertex-id').outE('knows')
  .where(inV().has('person', 'name', 'Bob'))
  .property('weight', 0.9)
  .property('lastUpdated', datetime('2024-05-20T14:30:00'))

这条查询会直接定位到目标边，把指定属性更新成新值。如果边不存在，什么都不会发生，不会有任何异常。

如果你的场景需要确保边一定存在（比如必须更新已有的边，不存在就报错），可以用fold()+coalesce()的组合来判断，但大部分普通更新场景，直接定位+property就足够用了。

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