本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon Neptune 中的 Gremlin 標準合規

以下各節提供 Gremlin 的 Neptune 實作概觀，以及其與 Apache TinkerPop 實作的差異。

Neptune 會在其引擎中以原生方式實作一些 Gremlin 步驟，並使用 Apache TinkerPop Gremlin 實作來處理其他步驟 (請參閱 Amazon Neptune 的原生 Gremlin 步驟支援)。

Gremlin 的適用標準

指令碼中的變數和參數

如果與預先繫結的變數有關，則周遊物件 g 在 Neptune 中是預先繫結的，而且不支援 graph 物件。

雖然 Neptune 不支援指令碼中的 Gremlin 變數或參數化，但是您可能經常會在網際網路上遇到 Gemlin 伺服器的範例指令碼，其中包含變數宣告，例如：

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，您可能會遇到很多這樣的範例，而且關於需要參數化，它們聽起來都非常有說服力。

不過，變數宣告功能和參數化功能 (以及警告) 只在使用 GremlinGroovyScriptEngine 時才適用於 TinkerPop 的 Grimlin 伺服器。當 Gremlin 伺服器使用 Gramlin 的 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();

指令碼執行

Neptune 的 Gremlin 引擎會使用 TinkerPop 的 gremlin-language ANTLR 文法剖析查詢。它不會執行 GremlinGroovyScriptEngine（如同某些 TinkerPop 型 Gremlin Server 部署），因此提交至 Neptune 的指令碼必須僅包含 Gremlin 語言，而非任意 Groovy 或 Java 程式碼。

指令碼可以透過各種方式傳送至 Neptune，例如透過 Gremlin REST 端點、Gremlin 主控台，或透過 TinkerPop 語言驅動程式 （例如 Java 驅動程式的指令碼用戶端)。本節所述的限制條件適用於任何這些文字字串提交路徑。

重要的是，不要將 Gremlin 語言本身與您可能已在其他地方看到包裝 Gremlin 範例的任何程式設計語言的語法糖或一般用途函數混淆。當這類程式碼出現在 TinkerPop 教學課程或線上範例時，取決於 Neptune 未提供的 Groovy 或 Java 執行時間。

指令碼可能包含的內容

參考 TinkerPop 列舉值

當 TinkerPop 列舉值預期為步驟引數時 （例如， 上的基數property()或 上的順序by())，請使用 ANTLR 文法辨識的短格式值。Neptune 不會在此位置解析完全合格的 Java 類別名稱，例如org.apache.tinkerpop.gremlin.structure.VertexProperty.Cardinality.single，不接受 ；請single改用 。

下表列出允許的短格式值，以及每個值所屬的基礎 TinkerPop 類別。

指令碼可能不包含的內容

Neptune 的文字字串 Gremlin 查詢不支援下列項目，因為它們依賴 Neptune 不提供的 Groovy 或 Java 執行期支援：

元素上的屬性

Neptune 不支援在 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 字元，且大小不能超過 55 MB。

使用者提供的 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

Vertex 屬性 ID 將自動產生，且查詢時可顯示為正數或負數。

頂點屬性的基數

Neptune 支援成組基數和單一基數。如未指定，則選取設定基數。這表示，如果您設定屬性值，它將新增新的值至屬性，但前提是其不能出現在值組內。此為 Set 的 Gremlin 列舉值。

不支援 List。如需屬性基數的詳細資訊，請參閱 Gremlin JavaDoc 中的 Vertex 主題。

更新頂點屬性

若要更新屬性值，而不新增額外的值給值組，請在 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 物件。下表列出 Grimlin 功能，並指出 Neptune 是否支持它們。

Neptune 對 graph 功能的支援

Neptune 圖形功能 (如果支援) 與 graph.features() 命令將傳回的功能相同。

Neptune 對變數功能的支援

Neptune 對頂點功能的支援

Neptune 對頂點屬性功能的支援

Neptune 對邊緣功能的支援

Neptune 對邊緣屬性功能的支援