Amazon Neptune 引擎 1.1.0.0 版 (2021 年 11 月 19 日) - Amazon Neptune
修補程式版本新功能改善項目修正的缺陷支援的查詢語言版本升級途徑Upgrading (正在升級)

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

Amazon Neptune 引擎 1.1.0.0 版 (2021 年 11 月 19 日)

截至 2021 年 11 月 19 日，引擎 1.1.0.0 版已普遍部署。請注意，新版本需要數天才能在每個區域推出。

重要

從 1.1.0.0 以前的版本升級至此引擎版本，也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求，所以在開始升級之前，您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。

為了成功完成升級，每個可用區域 (AZ) 中的每個子網路都必須每個 Neptune 執行個體至少有一個可用的 IP 地址。例如，如果子網路 1 中有一個寫入器執行個體和兩個讀取器執行個體，而子網路 2 中有兩個讀取器執行個體，則子網路 1 必須至少有 3 個可用的 IP 地址，而子網路 2 必須至少有 2 個可用的 IP 地址，才能開始升級。

在升級開始時，Neptune 會產生一個快照，其名稱由 preupgrade 組成，後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費，而且如果在升級過程中出現任何問題，您可以使用它來還原資料庫叢集。

當引擎升級本身完成時，新的引擎版本將可在舊版作業系統上短暫使用，但不到 5 分鐘的時間，叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前將有數分鐘無法使用。升級完成後，您就可以繼續寫入工作負載。

此過程會產生下列事件：

  • 每個叢集事件訊息：

    • Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]

    • Database cluster major version has been upgraded

  • 每個執行個體事件訊息：

    • Applying off-line patches to DB instance

    • DB instance shutdown

    • Finished applying off-line patches to DB instance

    • DB instance restarted

注意

從此引擎版本開始，Neptune 不再支援 R4 執行個體類型。如果您要在資料庫叢集中使用 R4 執行個體，則在升級至此版本之前，必須手動將其取代為不同的執行個體類型。如果您的寫入器執行個體是 R4，請遵循這些指示移動它。

此版本的後續修補程式版本

這個引擎版本的新功能

  • 引進了由 AWS Graviton2 處理器提供的一般用途 T4g 和記憶體最佳化的 R6g 資料庫執行個體。與目前同級 x86 型執行個體相比，對於各種工作負載，Graviton2 型執行個體提供明顯更優異的價格/效能。應用程式可在這些新的執行個體類型上正常運作，而且升級至這些執行個體類型時不需要移植應用程式程式碼。

    如需定價和區域可用性的詳細資訊，請參閱 Amazon Neptune 定價頁面。

  • 在 Neptune ML 中引進了自訂模型。

  • 已在 Neptune ML 中新增對 SPARQL 推論查詢的支援。

  • 已為屬性圖資料新增了新的串流端點，即：

    https://Neptune-DNS:8182/propertygraph/stream

    此端點的輸出格式 (名為 PG_JSON) 與舊版 gremlin/stream 的 GREMLIN_JSON 格式輸出完全相同。

    新的 propertygraph/stream 端點會將 Neptune 串流支援延伸至 OpenCypher，並將 gremlin/stream 端點取代為其相關聯的 GREMLIN_JSON 輸出格式。

這個引擎版本的改善項目

  • 已對 Neptune 串流做了改善：

    • 已將 commitTimestamp 欄位新增至 records 物件的 Neptune 串流變更日誌回應格式，為變更日誌串流中的每筆記錄提供時間戳記。

    • 已將 LATEST 值新增至 iteratorType 參數，可讓您從串流擷取最後一個有效的 eventId。請參閱呼叫串流 API。

  • 已新增在 Gremlin 節點分類和迴歸查詢中取得推論可信度分數的支援。

  • 已在 openCypher 新增對 OPTIONAL MATCH 的支援。

  • 已在 openCypher 新增對 MERGE 的支援。

  • 已在 openCypher 新增在 WITH 子句中使用 ORDER BY 的支援。

  • 已在 OpenCypher 新增對模式理解的支援，以及對超出存在檢查的模式運算式新增延伸支援。

  • 已在 OpenCypher 延伸對 DELETE 和 DELETE DETACH 子句的支援，以便它們現在可與其他更新子句搭配使用。

  • 已在 openCypher 延伸 CREATE 和 UPDATE 子句與 RETURN 搭配使用的支援。

  • 已在 DFE 引擎中新增了對 Gremlin limit、range 和 skip 步驟的支援。

  • 已改善在既未請求 explain 也未請求 profile 時 DFE 引擎中的查詢執行。

  • 已改善 DFE 引擎中針對 value 運算式的查詢執行。

  • 已改善一些鏈結的 Gemlin 條件式插入模式，以避免並行修改例外狀況，並允許鏈結查詢模式，如下所示：

    • 依 ID 進行條件式頂點插入，例如：

      g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID))

    • 具有多個標籤的條件式頂點插入，例如：

      g.V(ID).fold().coalesce(unfold(), g.addV("L1::L2").property(id,ID))

    • 依 ID 進行條件式邊緣插入，例如：

      g.E(ID).fold().coalesce(unfold(), V(from).addE(label).to(V(to)).property(id, ID))

    • 具有多個標籤的條件式邊緣插入，例如：

      g.E(ID).fold().coalesce(unfold(), g.addE(label).from(V(from)).to(V(to)).property(id, ID))

    • 後面跟著查詢的條件式插入，例如：

      g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID)).project("myvalues").by(valueMap())

    • 具有所新增屬性的條件式插入，例如：

      g.V(ID).fold().coalesce(unfold(), g.addV("L1").property(id,ID).property("name","pumba"))

此引擎版本中修正的缺陷

  • 已在 T3.medium 執行個體類型上停用無法支援的統計資料功能。

  • 已在 explain 中修正 IN 函數採取非常數值的 SPARQL 錯誤。

此版本支援的查詢語言版本

將資料庫叢集升級至 1.1.0.0 版之前，請確定您的專案與下列查詢語言版本相容：

  • Gremlin 版本：3.4.11

  • SPARQL 版本：1.1

引擎 1.1.0.0 版的升級途徑

您可以將任何先前的 Neptune 引擎版本手動升級為此版本。

您不會自動升級至此版本。

升級至此版本

如果資料庫叢集執行的引擎版本具有升級至此版本的途徑，則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 SDK 來升級任何有資格的叢集。以下 CLI 命令將立即升級有資格的叢集：

對於 Linux、OS X 或 Unix：

aws neptune modify-db-cluster \
    --db-cluster-identifier (your-neptune-cluster) \
    --engine-version 1.1.0.0 \
    --allow-major-version-upgrade \
    --apply-immediately

針對 Windows：

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.1.0.0 ^
    --allow-major-version-upgrade ^
    --apply-immediately

您可以指定 --no-apply-immediately，而不是 --apply-immediately。若要執行主要版本升級，需要 allow-major-version-upgrade 參數。此外，請務必包含引擎版本，否則您的引擎可能會升級至不同版本。

如果您的叢集使用自訂叢集參數群組，請務必包含此參數來指定它：

    --db-cluster-parameter-group-name (name of the custom DB cluster parameter group)

同樣地，如果叢集中有任何執行個體使用自訂資料庫參數群組，請務必包含此參數來指定它：

    --db-instance-parameter-group-name (name of the custom instance parameter group)

一律在升級之前執行測試

發佈新的主要或次要 Neptune 引擎版本時，請一律先在其上測試 Neptune 應用程式，然後再升級至其中。即使是次要升級，也可能會引入將影響程式碼的新功能或行為。

首先，請將目前版本中的版本備註頁面與目標版本的版本備註頁面進行比較，以查看查詢語言版本中是否將有變更，或有其他重大變更。

在升級生產資料庫叢集之前測試新版本的最佳方式是複製您的生產叢集，以便複製執行新的引擎版本。然後，您可以在複製上執行查詢，而不會影響生產資料庫叢集。

升級前一律建立手動快照

在執行升級之前，強烈建議您一律建立資料庫叢集的手動快照。具有自動快照僅會提供短期保護，而手動快照仍然可用，直到您明確將其刪除為止。

在某些情況下，Neptune 會為您建立手動快照，作為升級程序的一部分，但您不應該依賴此快照，而且在任何情況下都應該建立自己的手動快照。

確定不需要將資料庫叢集還原為升級前狀態時，您可以明確刪除您自己建立的手動快照，以及 Neptune 可能已建立的手動快照。如果 Neptune 建立手動快照集，它會具有開頭為 preupgrade 的名稱，後面跟著資料庫叢集的名稱、來源引擎版本、目標引擎版本和日期。

注意

如果您嘗試在待定動作進行中時進行升級，可能會遇到如下錯誤：

   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.

如果遇到此錯誤，請等候待定動作完成，或立即觸發維護時段，讓先前的升級完成。

如需有關升級引擎版本的詳細資訊，請參閱 維護 Amazon Neptune 資料庫叢集。如果您有任何問題或疑慮，請透過社群論壇及 AWS Premium Support 聯繫 AWS Support 團隊。