本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon Neptune 引擎版本 1.1.1.0.R3 (2022 年 6 月 7 日)
截至 2022 年 6 月 7 日,引擎版本 1.1.1.0.R3 已普遍部署。請注意,新版本需要數天才能在每個區域推出。
重要
從 1.1.0.0
以前的版本升級至此引擎版本,也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求,所以在開始升級之前,您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。
在升級開始時,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
注意
對於使用 OpenCypher 搭配 IAM 身分驗證的程式碼,此版本中有一項重大變更。到目前為止,IAM 簽章中的主機字串包含通訊協定,例如 bolt://
,如下所示:
"Host":"bolt://
(host URL)
:(port)
"
從引擎版本 1.1.1.0
開始,必須省略通訊協定:
"Host":"
(host URL)
:(port)
"
如需範例,請參閱 使用 Bolt 通訊協定。
這個引擎版本的改善項目
-
已新增對 Graviton2 提供的
x2g
執行個體類型的支援,並針對記憶體密集型工作負載進行最佳化。這些最初只能在四個 AWS 區域中使用:美國東部 (維吉尼亞北部) (
us-east-1
)美國東部 (俄亥俄) (
us-east-2
)美國西部 (奧勒岡) (
us-west-2
)歐洲 (愛爾蘭) (
eu-west-1
)
如需詳細資訊,請參閱 Neptune 定價頁面
。 已改善 Gemlin 步驟的效能,這些步驟涉及多個邊緣或頂點周遊、屬性查詢或標籤查詢。
此引擎版本中修正的缺陷
已修正在子周遊內處理
otherV()
步驟時發生的 Gremlin 錯誤。-
已修正
union
僅具有篩選步驟做為子項的查詢中的 Gremlin 錯誤。例如:g.V().union(has("name"), out("knows")).out()
已修正 SPARQL 錯誤,其中
FILTER
運算式內使用與UNION
子句構成巢狀的變數獲指派無效的範圍資訊。
此版本支援的查詢語言版本
將資料庫叢集升級至版本 1.1.1.0.R3 之前,請確定您的專案與下列查詢語言版本相容:
支援的 Gremlin 最早版本:
3.5.2
支援的 Gremlin 最新版本:
3.5.4
openCypher 版本:
Neptune-9.0.20190305-1.0
SPARQL 版本:
1.1
引擎版本 1.1.1.0.R3 的升級途徑
如果您執行的是引擎版本 1.1.1.0
,您的叢集將在下一個維護時段自動升級至此修補程式版本。
升級至此版本
重要
從 1.1.0.0
以前的任何版本升級至此引擎版本,也會在資料庫叢集中的所有執行個體上觸發作業系統升級。因為不會處理作業系統升級期間發生的作用中寫入請求,所以在開始升級之前,您必須暫停對要升級之叢集的所有寫入工作負載 (包括大量資料載入)。
在升級開始時,Neptune 會產生一個快照,其名稱由 preupgrade
組成,後面接著根據資料庫叢集資訊自動產生的識別符。您不需要為此快照付費,而且如果在升級過程中出現任何問題,您可以使用它來還原資料庫叢集。
當引擎升級本身完成時,新的引擎版本將可在舊版作業系統上短暫使用,但不到 5 分鐘的時間,叢集中的所有執行個體都會同時開始作業系統升級。您的資料庫叢集目前大約 6 分鐘將無法使用。升級完成後,您就可以繼續寫入工作負載。
此過程會產生下列事件:
-
每個叢集事件訊息:
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
如果資料庫叢集執行的引擎版本具有升級至此版本的途徑,則有資格立即升級。您可以使用主控台上的資料庫叢集操作或使用 SDK 來升級任何有資格的叢集。以下 CLI 命令將立即升級有資格的叢集:
對於 Linux、OS X 或 Unix:
aws neptune modify-db-cluster \ --db-cluster-identifier
(your-neptune-cluster)
\ --engine-version 1.1.1.0 \ --apply-immediately
針對 Windows:
aws neptune modify-db-cluster ^ --db-cluster-identifier
(your-neptune-cluster)
^ --engine-version 1.1.1.0 ^ --apply-immediately
更新會同時套用到資料庫叢集中的所有執行個體。更新時,所有這些執行個體都需要重新啟動資料庫,因此您會經歷 20 至 30 秒的停機時間,之後就可以繼續使用資料庫叢集。
一律在升級之前執行測試
發佈新的主要或次要 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