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

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

Amazon Neptune 的格雷姆林标准合规性

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

Neptune 在其引擎中本地实现了一些格雷姆林步骤，并使用 Apache TinkerPop 格雷姆林实现来处理其他步骤（请参阅Amazon Neptune 本地格雷姆林步骤支持)。以下部分概述了 Neptune 的实施与 TinkerPop 实施不同的情况。

Gremlin 的适用标准

Neptune Gremlin 实施的不同之处

Grislin 的亚马逊 Neptune 实施与 Apache TinkerPop 定义的实施之间存在几个重要的区别。

以下是实施差异列表：

Pre-Bound 变量

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

TinkerPop 枚举

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

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

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

Java 代码

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

日期和时间

Neptune 提供datetime方法，用于为 Gemlin 中发送的查询指定日期和时间Groovy变体。这包括 Gremlin 控制台、使用 HTTP REST API 的文本字符串以及使用 Groovy 的任何其他序列化。日期和时间值必须使用 datetime() 函数进行指定。

datetime( ) 函数采用符合 ISO-8601 日期时间的字符串值，最高精度为毫秒。例如：datetime('2018-01-01T00:00:00')。

ISO-8601 日期时间格式的一些示例如下所示：

脚本执行

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

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

Sessions

Neptune 中的会话持续时间限制为仅 10 分钟。有关详细信息，请参阅 Gremlin 会话 和 TinkerPop 会话参考 。

Transactions

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

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

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

顶点和边缘 ID

Neptune Gramlin 顶点和边缘 ID 必须属于类型String. 如果您在添加顶点或边缘时未提供 ID，则 UUID 会生成并转换为一个字符串；例如，"48af8178-50ce-971a-fc41-8c9a954cea62"。

用户提供的 ID

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

要使用自定义 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 不支持 Greglin 变量且不支持bindings属性。

转义字符

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

Groovy 限制

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

Serialization

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

Lambda 步骤

Neptune 不支持 Lambda 步骤。

不支持的 Gremlin 方法

Neptune 不支持以下 Gramlin 方法：

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

不支持的 Gremlin 步骤

Neptune 不支持以下 Gramlin 步骤：

其他功能

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

Gremlin 图形支持的功能

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