Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon Neptune 中的 Gremlin 标准合规性

以下各节概述了 Gremlin 的 Neptune 实现以及它与 Apache 实现有何不同。 TinkerPop

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

Gremlin 的适用标准

脚本中的变量和参数

就预绑定变量而言，遍历对象 g 在 Neptune 中是预先绑定的，并且不支持 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 Server。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();

TinkerPop 枚举

Neptune 对于枚举值不支持完全限定的类名。例如，您在 Groovy 请求中必须使用 single，不能使用 org.apache.tinkerpop.gremlin.structure.VertexProperty.Cardinality.single。

枚举类型由参数类型决定。

下表显示了允许的枚举值和相关的 TinkerPop 完全限定名称。

Java 代码

除了支持的 Gremlin 之外，Neptune 不支持调用由任意 Java 或 Java 库调用定义的方法。 APIs例如，不允许 java.lang.*、Date() 和 g.V().tryNext().orElseGet()。

元素的属性

Neptune 不支持 TinkerPop 3.7.0 中引入的用于返回元素属性的materializeProperties标志。因此，Neptune 仍然只会将顶点或边作为参照返回，只返回它们的和。id label

脚本执行

所有查询必须以遍历对象 g 开头。

在字符串查询提交中，可以使用分号 (;) 或换行符 (\n) 进行分隔来发布多个遍历。若要执行，除最后一个语句以外的每个语句都必须以 .iterate() 步骤结尾。仅返回最后遍历数据。请注意，这不适用于 GLV ByteCode 查询提交。

会话

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

事务

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

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

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

顶点和边缘 IDs

Neptune Gremlin Vertex 和 Edge IDs 必须是类型。String这些 ID 字符串支持 Unicode 字符，大小不能超过 55MB。

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

用户提供 IDs

在 Neptune Gremlin 中允许用户提供， IDs 但须遵守以下规定。

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

所有顶点 IDs 必须是唯一的，所有边都 IDs 必须是唯一的。但是，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

顶点属性 IDs

Vertex 属性 IDs 是自动生成的，查询时可以显示为正数或负数。

顶点属性的基数

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

不支持 List。有关属性基数的更多信息，请参阅 Gremlin 中的 Vertex 主题。 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 语言文档的转义特殊字符部分中所述。

Groovy 限制

Neptune 不支持不以 g 开头的 Groovy 命令。这包括数学（例如：1+1）、系统调用（例如：System.nanoTime()）和变量定义（例如：1+1）。

序列化

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

Neptune 公开了所有能 TinkerPop 做到的序列化器，并支持 GraphSon 和的各种版本和配置。 GraphBinary尽管存在许多选项，但使用指南却很简单：

Lambda 步骤

Neptune 不支持 Lambda 步骤。

不受支持的 Gremlin 方法

Neptune 不支持以下 Gremlin 方法：

例如，不允许以下遍历：g.V().addE('something').from(__.V().next()).to(__.V().next())。

不受支持的 Gremlin 步骤

Neptune 不支持以下 Gremlin 步骤：

Neptune 中的 Gremlin 图形特征

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

Neptune 对 graph 特征的支持

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

Neptune 对变量特征的支持

Neptune 对顶点特征的支持

Neptune 对顶点属性特征的支持

Neptune 对边缘特征的支持

Neptune 对边缘属性特征的支持