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 服务器使用 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 代码

Neptune 不支持调用由支持的 Gremlin API 以外的任意 Java 或 Java 库调用定义的方法。例如，不允许 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() 的手动事务逻辑。

顶点和边缘 ID

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

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

用户提供的 ID

用户提供的 ID 在 Neptune Gremlin 中得到允许，且具有以下规定。

要使用自定义 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 中的顶点主题。

更新顶点属性

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

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 对边缘属性特征的支持