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

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

Amazon Neptune 中的 Gremlin 标准合规性

以下各部分概述了 Gremlin 的 Neptune 实施以及它与 Apache 的不同之处 TinkerPop 实现。

Neptune 在其引擎中原生实现了一些 Gremlin 步骤，并使用 Apache TinkerPop Gremlin 实现来处理其他人（参见Amazon Neptune 中的原生 Gremlin 阶梯支持)。以下章节概述了Neptune 的实现与 TinkerPop 实现。

Gremlin 的适用标准

Neptune Gremlin 实施的不同之处

Gremlin 的 Amazon Neptune 实施与 Apache 定义的实施之间存在几个重要的差异。 TinkerPop.

以下是实施差异列表：

Pre-Bound 变量

遍历对象 g 是 Pre-bound。不支持 graph 对象。

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()。

脚本执行

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

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

会话

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

事务

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

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

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

顶点和边缘 ID

Neptune Gremlin 顶点和边缘 ID 必须属于类型String. 如果您在添加顶点或边缘时未提供 ID，则 UUID 会生成并转换为一个字符串；例如，"48af8178-50ce-971a-fc41-8c9a954cea62"。这些 ID 字符串支持 Unicode 字符，大小不能超过 55 MB。

用户提供的 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.

更新顶点属性

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

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

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

Labels

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

Variables

Neptune 不支持 Gremlin 变量且不支持bindings财产。

转义字符

Neptune 解析所有转义字符，如转义特殊字符Apache Groovy 语言文档的章节。

Groovy 限制

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

序列化

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

Lambda 步骤

Neptune 不支持 Lambda 步骤。

不支持的 Gremlin 方法

Neptune 不支持以下 Gremlin 方法：

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

不支持的 Gremlin 步骤

Neptune 不支持以下 Gremlin 步骤：

其他功能

Gremlin 的Neptune 实现不公开的graph对象。以下部分介绍支持和不支持的 graph 功能。

Gremlin 图形支持的功能

以下是一组由 Neptune Gremlin 图形实现的功能。这些功能与由 graph.features() 命令返回的功能相同。