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

Amazon Neptune 中的 Gremlin 标准合规性

以下各节概述了 Gremlin 的 Neptune 实现及其与 Apache 实现的区别。 TinkerPop

海王星在其引擎中原生实现了一些 Gremlin 步骤，并使用 Apache TinkerPop Gremlin 实现来处理其他步骤（参见）。Amazon Neptune 中的原生 Gremlin 步骤支持

Gremlin 的适用标准

脚本中的变量和参数

就预绑定变量而言，遍历对象g位于海王星 Pre-bound 中，不支持该graph对象。

尽管 Neptune 在脚本中不支持 Gremlin 变量或参数化，但您可能经常在互联网上遇到包含变量声明的 Gremlin Server 示例脚本，例如：

String query = "x = 1; g.V(x)";
List<Result> results = client.submit(query).all().get();

还有许多在提交查询时利用参数化（或绑定）的示例，例如：

Map<String,Object> params = new HashMap<>();
params.put("x",1);
String query = "g.V(x)";
List<Result> results = client.submit(query).all().get();

参数示例通常与在可能的情况下未进行参数化会导致性能损失的警告相关联。你可能会遇到很多这样的例子 TinkerPop ，而且它们听起来都很有说服力，说明需要进行参数化。

但是，变量声明功能和参数化功能（以及警告）仅适用于使用 TinkerPop的 Gremlin 服务器。GremlinGroovyScriptEngine当 Gremlin 服务器使用 Gremlin 的 gremlin-language ANTLR 语法来解析查询时，它们不适用。ANTLR 语法不支持变量声明或参数化，因此，在使用 ANTLR 时，您不必担心参数化失败。由于ANTLR语法是其中的新组成部分 TinkerPop，因此您在互联网上可能遇到的旧内容通常并不能反映出这种区别。

Neptune 在其查询处理引擎中使用 ANTLR 语法，而不是 GremlinGroovyScriptEngine，因此它不支持变量、参数化或 bindings 属性。因此，与参数化失败相关的问题在 Neptune 中不适用。使用 Neptune，只需按通常发生参数化的位置提交查询就完全安全了。因此，可以简化前面的示例，而不会造成任何性能损失，如下所示：

String query = "g.V(1)";
List<Result> results = client.submit(query).all().get();

脚本执行

海王星的 Gremlin 引擎使用的 ANTLR 语法解析查询。 TinkerPop gremlin-language它不运行GremlinGroovyScriptEngine（就像某些 TinkerPop-based Gremlin 服务器部署一样），因此提交给 Neptune 的脚本必须仅包含 Gremlin 语言，不能包含任意 Groovy 或 Java 代码。

可以通过多种方式将脚本发送到海王星，例如通过 Gremlin REST 端点、 Gremlin 控制台或通过 TinkerPop 语言驱动程序（例如 Java 驱动程序的脚本客户端）发送脚本。本节中描述的限制适用于这些文本字符串提交路径中的任何一个。

重要的是不要将 Gremlin 语言本身与你可能在其他地方看到的任何编程语言的句法糖或通用函数混淆。此类代码出现在 TinkerPop 教程或在线示例中的位置，这取决于 Neptune 不提供的 Groovy 或 Java 运行时。

脚本可能包含的内容

引用 TinkerPop 枚举值

如果 TinkerPop 枚举值应作为步进参数（例如，基数 on property() 或 order onby()），则使用 ANTLR 语法识别的短格式值。Neptune 在此位置无法解析完全限定的 Java 类名，例如，不org.apache.tinkerpop.gremlin.structure.VertexProperty.Cardinality.single被接受；改用single。

下表列出了允许的短格式值以及每个值所属的基础 TinkerPop 类。

脚本可能不包含的内容

对海王星的文本字符串 Gremlin 查询不支持以下内容，因为它们依赖于 Neptune 不提供的 Groovy 或 Java 运行时支持：

元素属性

海王星不支持 TinkerPop 3.7.0 中引入的用于返回元素属性的materializeProperties标志。因此，Neptune 仍然仅会将顶点或边缘作为引用返回，并且随附它们的 id 和 label。

会话

Neptune 中的会话持续时间限制为仅 10 分钟。有关更多信息，请参阅基于 Gremlin 脚本的会话和TinkerPop会话参考。

事务

Neptune 在每个 Gremlin 遍历开始时打开新的事务，并在遍历成功完成后结束事务。事务会在出现错误时回滚。

用分号 (;) 或换行符 (\n) 分隔的多个语句包含在单个事务中。最后一个以外的每个语句都必须以要执行的 next() 步骤结尾。仅返回最后遍历数据。

不支持使用 tx.commit() 和 tx.rollback() 的手动事务逻辑。

顶点和边缘 ID

Neptune Gremlin 顶点和边缘 ID 必须属于 String 类型。这些 ID 字符串支持 Unicode 字符，大小不能超过 55MB。

User-supplied 支持 ID，但在正常使用中它们是可选的。如果您在添加顶点或边缘时不提供 ID，Neptune 会生成一个 UUID 并将其转换为字符串，格式如下："48af8178-50ce-971a-fc41-8c9a954cea62"。这些 UUID 不符合 RFC 标准，因此，如果您需要标准 UUID，则应在外部生成它们，并在添加顶点或边缘时提供它们。

User-supplied 身份证

User-supplied 海王星小精灵允许携带身份证，但有以下规定。

要使用自定义 ID 创建新顶点，请将 property 步骤与 id 关键字一起使用：g.addV().property(id, 'customid')。

所有顶点 ID 必须是唯一的，并且所有边缘 ID 也必须是唯一的。但是，Neptune 的确允许顶点和边缘具有相同的 ID。

如果您尝试使用 g.addV() 创建新顶点并且已存在具有该 ID 的顶点，则此操作将失败。此情况的例外是，如果为顶点指定新标签，该操作将成功，但会将新标签和指定的任何其他属性添加到现有顶点。不会覆盖任何内容。未创建新顶点。顶点 ID 不会更改并会保持唯一。

例如，以下 Gremlin 控制台命令将成功：

gremlin> g.addV('label1').property(id, 'customid')
gremlin> g.addV('label2').property(id, 'customid')
gremlin> g.V('customid').label()
==>label1::label2

顶点属性 ID

顶点属性 ID 会自动生成且可以在查询时显示为正数或负数。

顶点属性的基数

Neptune 支持集基数和单一基数。如果未指定，则集基数处于选中状态。这意味着，如果您设置一个属性值，它会向该属性添加新值，但是仅当它未显示在一组值中时。这是 Set 的 Gremlin 枚举值。

不支持 List。有关属性基数的更多信息，请参阅 Gremlin 中的顶点主题。 JavaDoc

更新顶点属性

要更新属性值而无需向一组值添加其他值，请在 property 步骤中指定 single 基数。

g.V('exampleid01').property(single, 'age', 25)

这将删除该属性的所有现有值。

标签

Neptune 对于一个顶点支持多个标签。创建标签时，您可以指定多个标签，同时使用 :: 分隔它们。例如，g.addV("Label1::Label2::Label3") 添加具有三个不同标签的顶点。hasLabel 步骤与具有以下任一三个标签的此顶点相匹配：hasLabel("Label1")、hasLabel("Label2") 和 hasLabel("Label3")。

转义字符

Neptune 解析所有转义字符，如 Apache Groovy 语言文档的转义特殊字符部分中所述。

序列化

Neptune 根据请求的 MIME 类型支持以下串行化。

借助 Neptune，您可以使用 TinkerPop 提供的许多序列化器，并支持 GraphSon 和... 的各种版本和配置。 GraphBinary有关当前支持的序列化器，请参见下表。虽然存在许多选项，但使用指南却很简单：

Lambda 步骤

Neptune 不支持 Lambda 步骤。

不受支持的 Gremlin 步骤

Neptune 不支持以下 Gremlin 步骤：

Neptune 中的 Gremlin 图形特征

Gremlin 的 Neptune 实现不公开 graph 对象。下表列出了 Gremlin 特征，并指明了 Neptune 是否支持这些特征。

Neptune 支持图形功能

Neptune 图形特征（如果支持）与 graph.features() 命令返回的特征相同。

Neptune 对变量特征的支持

Neptune 对顶点特征的支持

Neptune 对顶点属性特征的支持

Neptune 对边缘特征的支持

Neptune 对边缘属性特征的支持