View a markdown version of this page

在要部署 Gremlin 代码的上下文中对其进行测试 - Amazon Neptune
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

在要部署 Gremlin 代码的上下文中对其进行测试

Gremlin 为客户端向服务器提交查询提供了多种方式。这些提交模式在评估查询的方式和事务行为方面有所不同。如果您在一种模式下开发并在另一种模式下部署,这些差异可能会导致意想不到的结果。

脚本模式(基于字符串的提交)

在脚本模式下,客户端将整个查询作为文本字符串发送到服务器。服务器评估完整的字符串,包括任何 终端步骤,并将结果传输回客户端。以下工具和方法使用脚本模式:

在脚本模式下,客户端将如下所示的查询作为完整字符串发送给服务器:

// Script mode – the entire string, including .next(), is sent to the server // V('non-existing-id') yields nothing because no vertex with that ID exists Cluster cluster = Cluster.build().addContactPoint("your-neptune-endpoint") .port(8182).enableSsl(true).create(); Client client = cluster.connect(); client.submit("g.V('existing-id').addV('person').V('non-existing-id').next()");

服务器评估完整的查询,包括 .next()。如果 .next() 没有找到任何结果,服务器抛出 NoSuchElementException 还有这笔交易 回滚。

字节码模式(GLV 遍历对象)

在字节码模式下,客户端使用 Gremlin 语言变体 (GLV) 在本地构建遍历对象。驱动程序将遍历步骤序列化为字节码并将其发送到服务器。终端步骤,例如 .toList() 要么 .next() 在 客户端 对服务器返回的结果进行迭代。你可以使用字节码模式 爪哇, 巨蟒蛇, 走, .NET, JavaScript,以及其他第三方 TinkerPop-compliant 适用于所用海王星引擎版本的驱动程序。

在字节码模式下,同样的查询如下所示:

// Bytecode mode – the driver sends the traversal steps as bytecode // .next() executes on the client to iterate results Cluster cluster = Cluster.build().addContactPoint("your-neptune-endpoint") .port(8182).enableSsl(true).create(); GraphTraversalSource g = traversal().withRemote( DriverRemoteConnection.using(cluster)); g.V("existing-id").addV("person").V("non-existing-id").next();

驱动程序仅发送遍历步骤 (g.V().addV().V()) 作为字节码。服务器成功评估遍历、提交事务并返回结果集。然后客户打电话 .next() 在本地读取结果集。如果结果集为空,则客户端会提出 NoSuchElementException,但是这笔交易有 已经承诺 在服务器上。

交易行为的差异

这些模式之间的关键区别在于终端步骤如何影响交易:

  • 脚本模式 — 服务器评估终端步骤。如果终端步骤像 .next() 由于结果集为空而失败,服务器将查询视为失败并且 回滚 交易。服务器不会在同一次遍历中保留任何突变(例如 addV())。

  • 字节码模式 — 客户评估终端步骤。服务器仅评估遍历步骤,成功提交事务并返回结果。如果客户随后打电话 .next() 在空结果集上,结果 NoSuchElementException 仅是客户端错误。交易已经提交,所以服务器 仍然存在 任何突变。

终端步骤

在 Gremlin 中, 终端步骤 是导致将遍历提交给 Neptune 进行评估的步骤。在字节码模式下,终端步骤触发驱动程序序列化并发送遍历。在脚本模式下,终端步骤是服务器上评估的查询字符串的一部分。终端步骤是:

  • hasNext() — 退货 true 如果有结果, false 否则。

  • next() — 返回下一个结果。投掷 NoSuchElementException 如果没有结果。

  • next(n) — 返回下一个 n 结果作为列表。

  • toList() — 以列表形式返回所有结果。如果没有结果,则返回一个空列表。

  • toSet() — 以集合形式返回所有结果。如果不存在结果,则返回一个空集。

  • iterate() — 迭代所有结果而不返回它们。将其用于不需要返回值的突变。

注意

个别语言 GLV 可能会提供特定于其实现的额外终端步骤。有关详细信息,请参阅特定语言的页面。

如果您在一个上下文中开发和测试代码,则可能会遇到问题。例如,Gremlin 控制台以脚本形式提交查询。如果您在不同的上下文中部署代码,例如通过 Java 驱动程序使用字节码,则代码在生产环境中的行为可能会有所不同。

重要

请务必使用与部署 Gremlin 代码相同的提交模式来测试 Gremlin 代码,以避免意外交易行为。